Update a tax filing
curl --request POST \
--url https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"form": {
"corp_info": {
"name": "<string>",
"state": "<string>",
"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": {
"phone": "<string>",
"phone_country": "<string>",
"email": "[email protected]"
},
"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>",
"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>"
},
"officers": [
{
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>"
}
],
"directors": [
{
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>"
}
]
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
form: {
corp_info: {
name: '<string>',
state: '<string>',
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: {phone: '<string>', phone_country: '<string>', email: '[email protected]'},
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>',
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>'},
officers: [{first_name: '<string>', last_name: '<string>', title: '<string>'}],
directors: [{first_name: '<string>', last_name: '<string>', title: '<string>'}]
}
})
};
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));import requests
url = "https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}"
payload = { "form": {
"corp_info": {
"name": "<string>",
"state": "<string>",
"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": {
"phone": "<string>",
"phone_country": "<string>",
"email": "[email protected]"
},
"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>",
"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>"
},
"officers": [
{
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>"
}
],
"directors": [
{
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>"
}
]
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}"
payload := strings.NewReader("{\n \"form\": {\n \"corp_info\": {\n \"name\": \"<string>\",\n \"state\": \"<string>\",\n \"industry\": \"<string>\",\n \"parent_company\": \"<string>\",\n \"ein\": \"<string>\",\n \"formation_date\": \"<string>\",\n \"initial_return\": true,\n \"issued_shares\": 1,\n \"gross_assets\": 1,\n \"dba\": \"<string>\",\n \"principal_business_activity\": \"<string>\"\n },\n \"contact\": {\n \"phone\": \"<string>\",\n \"phone_country\": \"<string>\",\n \"email\": \"[email protected]\"\n },\n \"additional_questions\": {\n \"has_employees\": true,\n \"made_1099_payments\": true,\n \"form_1099_files\": [\n \"<string>\"\n ],\n \"purchased_assets\": true,\n \"owns_non_us_corp\": true,\n \"has_us_physical_presence\": true\n },\n \"owners\": [\n {\n \"name\": \"<string>\",\n \"title\": \"<string>\",\n \"type\": \"<string>\",\n \"ftin\": \"<string>\",\n \"itin\": \"<string>\",\n \"ssn\": \"<string>\",\n \"ein\": \"<string>\",\n \"phone\": \"<string>\",\n \"capital_contributions\": 1,\n \"percentage_owned\": 50\n }\n ],\n \"revenue_expenses\": {\n \"sales\": {\n \"gross_sales\": 1,\n \"returns_and_allowances\": 1,\n \"sales\": 1\n },\n \"cost_of_goods_sold\": {\n \"beginning_inventory\": 1,\n \"purchases\": 1,\n \"ending_inventory\": 1\n },\n \"expenses\": {},\n \"principal_business_activity\": \"<string>\"\n },\n \"balance_sheet\": {\n \"lines\": {},\n \"principal_business_activity\": \"<string>\"\n },\n \"officers\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"title\": \"<string>\"\n }\n ],\n \"directors\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"title\": \"<string>\"\n }\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(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>"
}
]
}{
"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>"
}
]
}Update a tax filing
Replaces the provided form sections on a draft. A section you send replaces the stored one whole, a section you omit stays as it is. Only a draft is editable - after submit, changes go through Clemta.
POST
/
companies
/
{companyID}
/
tax-filings
/
{filingID}
Update a tax filing
curl --request POST \
--url https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"form": {
"corp_info": {
"name": "<string>",
"state": "<string>",
"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": {
"phone": "<string>",
"phone_country": "<string>",
"email": "[email protected]"
},
"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>",
"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>"
},
"officers": [
{
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>"
}
],
"directors": [
{
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>"
}
]
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
form: {
corp_info: {
name: '<string>',
state: '<string>',
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: {phone: '<string>', phone_country: '<string>', email: '[email protected]'},
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>',
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>'},
officers: [{first_name: '<string>', last_name: '<string>', title: '<string>'}],
directors: [{first_name: '<string>', last_name: '<string>', title: '<string>'}]
}
})
};
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));import requests
url = "https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}"
payload = { "form": {
"corp_info": {
"name": "<string>",
"state": "<string>",
"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": {
"phone": "<string>",
"phone_country": "<string>",
"email": "[email protected]"
},
"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>",
"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>"
},
"officers": [
{
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>"
}
],
"directors": [
{
"first_name": "<string>",
"last_name": "<string>",
"title": "<string>"
}
]
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.clemta.com/v1/companies/{companyID}/tax-filings/{filingID}"
payload := strings.NewReader("{\n \"form\": {\n \"corp_info\": {\n \"name\": \"<string>\",\n \"state\": \"<string>\",\n \"industry\": \"<string>\",\n \"parent_company\": \"<string>\",\n \"ein\": \"<string>\",\n \"formation_date\": \"<string>\",\n \"initial_return\": true,\n \"issued_shares\": 1,\n \"gross_assets\": 1,\n \"dba\": \"<string>\",\n \"principal_business_activity\": \"<string>\"\n },\n \"contact\": {\n \"phone\": \"<string>\",\n \"phone_country\": \"<string>\",\n \"email\": \"[email protected]\"\n },\n \"additional_questions\": {\n \"has_employees\": true,\n \"made_1099_payments\": true,\n \"form_1099_files\": [\n \"<string>\"\n ],\n \"purchased_assets\": true,\n \"owns_non_us_corp\": true,\n \"has_us_physical_presence\": true\n },\n \"owners\": [\n {\n \"name\": \"<string>\",\n \"title\": \"<string>\",\n \"type\": \"<string>\",\n \"ftin\": \"<string>\",\n \"itin\": \"<string>\",\n \"ssn\": \"<string>\",\n \"ein\": \"<string>\",\n \"phone\": \"<string>\",\n \"capital_contributions\": 1,\n \"percentage_owned\": 50\n }\n ],\n \"revenue_expenses\": {\n \"sales\": {\n \"gross_sales\": 1,\n \"returns_and_allowances\": 1,\n \"sales\": 1\n },\n \"cost_of_goods_sold\": {\n \"beginning_inventory\": 1,\n \"purchases\": 1,\n \"ending_inventory\": 1\n },\n \"expenses\": {},\n \"principal_business_activity\": \"<string>\"\n },\n \"balance_sheet\": {\n \"lines\": {},\n \"principal_business_activity\": \"<string>\"\n },\n \"officers\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"title\": \"<string>\"\n }\n ],\n \"directors\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"title\": \"<string>\"\n }\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(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>"
}
]
}{
"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
Your API key, e.g. Authorization: Bearer clmt_test_. Live keys use the clmt_live_ prefix.
Headers
Date-based API version to run this request against.
Example:
"2026-08-13"
Path Parameters
ID of the company.
Pattern:
^cmp_[0-9A-Za-z]{22}$ID of the tax filing.
Pattern:
^txf_[0-9A-Za-z]{22}$Body
application/json
Replaces the provided form sections on an editable filing. A filing is editable while it is a draft, and again if it was rejected - a rejected filing can be corrected and resubmitted. Once it is in review or accepted it is closed, and changes go through Clemta.
The filing questionnaire. Every section is optional on a write - a section you send replaces the stored one whole, a section you omit stays as it is. Federal filings use revenue_expenses, state filings use balance_sheet.
Show child attributes
Show child attributes
Response
The filing after the update, with readiness recomputed.
One federal or state tax filing on a company. Open it over the API, fill the form, and submit it - or your customer can open and fill it themselves. The filing entitlement is spent at submit. Follow progress with tax_filing.created / tax_filing.status.changed.
Entity name.
Available options:
tax_filing Pattern:
^txf_[0-9A-Za-z]{22}$Example:
"txf_0346sFPEvSkJvY8vt14NNw"
Pattern:
^cmp_[0-9A-Za-z]{22}$The filing year.
Example:
2025
Available options:
federal, state Review outcome: draft while the customer fills it in, in_review once submitted to Clemta, then accepted or rejected. A rejected filing is re-openable - it can be corrected and resubmitted, moving it back to in_review.
Available options:
draft, in_review, accepted, rejected Where Clemta has the return. additional_info and signature_requested need the customer. 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 The questionnaire as currently stored. Present on the detail read and on write answers, absent on the list.
Show child attributes
Show child attributes
How many IRS-1099 files are attached to the filing, however they were attached them. Present on the detail read and on write answers.
True when the filing is editable (a draft, or a rejected filing sent back for correction) with every required section in place. Present on the detail read and on write answers.
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
Show child attributes
⌘I