Retrieve a tax filing

curl --request GET \
  --url https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "tax_filing",
  "id": "txf_0346sFPEvSkJvY8vt14NNw",
  "company": "<string>",
  "year": 2025,
  "type": "federal",
  "status": "draft",
  "livemode": true,
  "created_at": "2023-11-07T05:31:56Z",
  "progress": "draft",
  "form": {
    "corp_info": {
      "name": "<string>",
      "state": "<string>",
      "entity_type": "llc",
      "industry": "<string>",
      "parent_company": "<string>",
      "ein": "<string>",
      "formation_date": "<string>",
      "initial_return": true,
      "issued_shares": 1,
      "gross_assets": 1,
      "dba": "<string>",
      "principal_business_activity": "<string>"
    },
    "contact": {
      "address": {
        "country": "<string>",
        "line1": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postal_code": "<string>",
        "line2": "<string>"
      },
      "phone": "<string>",
      "phone_country": "<string>",
      "email": "[email protected]",
      "principal_place_of_business": {
        "country": "<string>",
        "line1": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postal_code": "<string>",
        "line2": "<string>"
      }
    },
    "additional_questions": {
      "has_employees": true,
      "made_1099_payments": true,
      "form_1099_files": [
        "<string>"
      ],
      "purchased_assets": true,
      "owns_non_us_corp": true,
      "has_us_physical_presence": true
    },
    "owners": [
      {
        "name": "<string>",
        "title": "<string>",
        "type": "<string>",
        "ftin": "<string>",
        "itin": "<string>",
        "ssn": "<string>",
        "ein": "<string>",
        "phone": "<string>",
        "address": {
          "country": "<string>",
          "line1": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postal_code": "<string>",
          "line2": "<string>"
        },
        "capital_contributions": 1,
        "percentage_owned": 50
      }
    ],
    "revenue_expenses": {
      "sales": {
        "gross_sales": 1,
        "returns_and_allowances": 1,
        "sales": 1
      },
      "cost_of_goods_sold": {
        "beginning_inventory": 1,
        "purchases": 1,
        "ending_inventory": 1
      },
      "expenses": {},
      "principal_business_activity": "<string>"
    },
    "balance_sheet": {
      "lines": {},
      "principal_business_activity": "<string>"
    },
    "fixed_assets": [
      {
        "title": "<string>",
        "placed_in_service": "2023-12-25",
        "cost": 1,
        "salvage_value": 1,
        "business_use": 50
      }
    ],
    "officers": [
      {
        "first_name": "<string>",
        "last_name": "<string>",
        "title": "<string>",
        "address": {
          "country": "<string>",
          "line1": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postal_code": "<string>",
          "line2": "<string>"
        }
      }
    ],
    "directors": [
      {
        "first_name": "<string>",
        "last_name": "<string>",
        "title": "<string>",
        "address": {
          "country": "<string>",
          "line1": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postal_code": "<string>",
          "line2": "<string>"
        }
      }
    ]
  },
  "form_1099_count": 123,
  "submittable": true,
  "missing": [
    {
      "field": "contact.email",
      "reason": "required"
    }
  ],
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "type": "https://docs.clemta.com/partner/errors#resource_already_exists",
  "title": "<string>",
  "status": 349,
  "code": "api_key_invalid",
  "detail": "<string>",
  "request_id": "<string>",
  "errors": [
    {
      "reason": "<string>",
      "location": "<string>",
      "validation_type": "<string>",
      "how_to_fix": "<string>"
    }
  ]
}

{
  "type": "https://docs.clemta.com/partner/errors#resource_already_exists",
  "title": "<string>",
  "status": 349,
  "code": "api_key_invalid",
  "detail": "<string>",
  "request_id": "<string>",
  "errors": [
    {
      "reason": "<string>",
      "location": "<string>",
      "validation_type": "<string>",
      "how_to_fix": "<string>"
    }
  ]
}

{
  "type": "https://docs.clemta.com/partner/errors#resource_already_exists",
  "title": "<string>",
  "status": 349,
  "code": "api_key_invalid",
  "detail": "<string>",
  "request_id": "<string>",
  "errors": [
    {
      "reason": "<string>",
      "location": "<string>",
      "validation_type": "<string>",
      "how_to_fix": "<string>"
    }
  ]
}

GET

companies

{companyID}

tax-filings

{filingID}

Retrieve a tax filing

curl --request GET \
  --url https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "tax_filing",
  "id": "txf_0346sFPEvSkJvY8vt14NNw",
  "company": "<string>",
  "year": 2025,
  "type": "federal",
  "status": "draft",
  "livemode": true,
  "created_at": "2023-11-07T05:31:56Z",
  "progress": "draft",
  "form": {
    "corp_info": {
      "name": "<string>",
      "state": "<string>",
      "entity_type": "llc",
      "industry": "<string>",
      "parent_company": "<string>",
      "ein": "<string>",
      "formation_date": "<string>",
      "initial_return": true,
      "issued_shares": 1,
      "gross_assets": 1,
      "dba": "<string>",
      "principal_business_activity": "<string>"
    },
    "contact": {
      "address": {
        "country": "<string>",
        "line1": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postal_code": "<string>",
        "line2": "<string>"
      },
      "phone": "<string>",
      "phone_country": "<string>",
      "email": "[email protected]",
      "principal_place_of_business": {
        "country": "<string>",
        "line1": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postal_code": "<string>",
        "line2": "<string>"
      }
    },
    "additional_questions": {
      "has_employees": true,
      "made_1099_payments": true,
      "form_1099_files": [
        "<string>"
      ],
      "purchased_assets": true,
      "owns_non_us_corp": true,
      "has_us_physical_presence": true
    },
    "owners": [
      {
        "name": "<string>",
        "title": "<string>",
        "type": "<string>",
        "ftin": "<string>",
        "itin": "<string>",
        "ssn": "<string>",
        "ein": "<string>",
        "phone": "<string>",
        "address": {
          "country": "<string>",
          "line1": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postal_code": "<string>",
          "line2": "<string>"
        },
        "capital_contributions": 1,
        "percentage_owned": 50
      }
    ],
    "revenue_expenses": {
      "sales": {
        "gross_sales": 1,
        "returns_and_allowances": 1,
        "sales": 1
      },
      "cost_of_goods_sold": {
        "beginning_inventory": 1,
        "purchases": 1,
        "ending_inventory": 1
      },
      "expenses": {},
      "principal_business_activity": "<string>"
    },
    "balance_sheet": {
      "lines": {},
      "principal_business_activity": "<string>"
    },
    "fixed_assets": [
      {
        "title": "<string>",
        "placed_in_service": "2023-12-25",
        "cost": 1,
        "salvage_value": 1,
        "business_use": 50
      }
    ],
    "officers": [
      {
        "first_name": "<string>",
        "last_name": "<string>",
        "title": "<string>",
        "address": {
          "country": "<string>",
          "line1": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postal_code": "<string>",
          "line2": "<string>"
        }
      }
    ],
    "directors": [
      {
        "first_name": "<string>",
        "last_name": "<string>",
        "title": "<string>",
        "address": {
          "country": "<string>",
          "line1": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postal_code": "<string>",
          "line2": "<string>"
        }
      }
    ]
  },
  "form_1099_count": 123,
  "submittable": true,
  "missing": [
    {
      "field": "contact.email",
      "reason": "required"
    }
  ],
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "type": "https://docs.clemta.com/partner/errors#resource_already_exists",
  "title": "<string>",
  "status": 349,
  "code": "api_key_invalid",
  "detail": "<string>",
  "request_id": "<string>",
  "errors": [
    {
      "reason": "<string>",
      "location": "<string>",
      "validation_type": "<string>",
      "how_to_fix": "<string>"
    }
  ]
}

{
  "type": "https://docs.clemta.com/partner/errors#resource_already_exists",
  "title": "<string>",
  "status": 349,
  "code": "api_key_invalid",
  "detail": "<string>",
  "request_id": "<string>",
  "errors": [
    {
      "reason": "<string>",
      "location": "<string>",
      "validation_type": "<string>",
      "how_to_fix": "<string>"
    }
  ]
}

{
  "type": "https://docs.clemta.com/partner/errors#resource_already_exists",
  "title": "<string>",
  "status": 349,
  "code": "api_key_invalid",
  "detail": "<string>",
  "request_id": "<string>",
  "errors": [
    {
      "reason": "<string>",
      "location": "<string>",
      "validation_type": "<string>",
      "how_to_fix": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Your API key, e.g. Authorization: Bearer clmt_test_. Live keys use the clmt_live_ prefix.

Headers

Clemta-Version

string

Date-based API version to run this request against.

Example:

"2026-08-13"

Path Parameters

companyID

string

required

ID of the company.

Pattern: ^cmp_[0-9A-Za-z]{22}$

filingID

string

required

ID of the tax filing.

Pattern: ^txf_[0-9A-Za-z]{22}$

Response

The filing.

One federal or state tax filing on a company. Open it over the API, fill the form, and submit it - or your client can open and fill it themselves. The filing entitlement is spent at submit. Follow progress with tax_filing.created / tax_filing.status.changed.

object

enum<string>

required

Entity name.

Available options:

tax_filing

string

required

Pattern: ^txf_[0-9A-Za-z]{22}$

Example:

"txf_0346sFPEvSkJvY8vt14NNw"

company

string

required

Pattern: ^cmp_[0-9A-Za-z]{22}$

year

integer<int64>

required

The filing year.

Example:

2025

type

enum<string>

required

Available options:

federal,

state

status

enum<string>

required

Review outcome: draft while the client fills it in, in_review once submitted to Clemta, then accepted or rejected.

Available options:

draft,

in_review,

accepted,

rejected

livemode

boolean

required

created_at

string<date-time>

required

progress

enum<string>

Where Clemta has the return. additional_info and signature_requested need the client. return_ready means the return is available in the company's documents. completed is filed.

Available options:

draft,

in_progress,

additional_info,

signature_requested,

return_ready,

completed

form

object

The questionnaire as currently stored. Present on the detail read and on write answers, absent on the list.

Show child attributes

form_1099_count

integer

How many IRS-1099 files are attached to the filing, however they were attached them. Present on the detail read and on write answers.

submittable

boolean

True when the filing is a draft with every required section in place. Present on the detail read and on write answers.

missing

object[]

What still keeps the filing from being submitted, field by field. Empty when submittable is true. Present on the detail read and on write answers.

Show child attributes

updated_at

string<date-time>

Identity

Accounts

Companies

Officers & directors

Products and pricing

Service orders

Tax filings

Fixed assets

Requirements

Verification and signing

Files

File links

Calendar

Status tracking

Events

Hosted links

Sandbox

Webhook events

Retrieve a tax filing

Authorizations

Headers

Path Parameters

Response