Submit a tax filing
Submits the filing to Clemta for review. This is the one transactional moment - readiness is checked, one filing entitlement is spent, and the filing moves to in_review, all together or not at all. A filing already submitted answers its current state, so a retry is a no-op. With no entitlement remaining the draft stays intact - order the matching entitlement product and retry.
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.
"2026-08-13"
Path Parameters
ID of the company.
^cmp_[0-9A-Za-z]{22}$ID of the tax filing.
^txf_[0-9A-Za-z]{22}$Response
The submitted 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.
Entity name.
tax_filing ^txf_[0-9A-Za-z]{22}$"txf_0346sFPEvSkJvY8vt14NNw"
^cmp_[0-9A-Za-z]{22}$The filing year.
2025
federal, state Review outcome: draft while the client fills it in, in_review once submitted to Clemta, then accepted or rejected.
draft, in_review, accepted, rejected 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.
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.
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 a draft 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.