KintsugiKintsugi

Get a filing's enhanced data

GET/filings/{filing_id}/enhanced-data

Get a US filing's actual tax liability broken down by local jurisdiction. Returns 200 with the data when a current build is stored, and 200 with FAILED when the last build failed. Otherwise starts a build and returns 202 with IN_PROGRESS; poll until it is DONE. A filing with no transactions returns DONE with null data. Returns 404 if the filing does not exist or belongs to an organization your credential cannot access, and 400 when jurisdiction does not match the filing or the state has no enhanced data.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Narrow the request to one organization (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Path parameters

filing_idstringRequired

The unique identifier of the filing.

Query

Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.

/filings/{filing_id}/enhanced-data?jurisdiction=<jurisdiction>
jurisdictionstringRequired

Two-letter code of the filing's US state, such as NY. Must match the filing.

Response

statusPublicEnhancedFilingDataStatusEnumRequired

DONE, IN_PROGRESS, or FAILED.

Available options:IN_PROGRESSDONEFAILED
reportIdstring

Id of the stored build, to correlate polls and rebuilds. Null for a filing with no transactions, which has nothing to build.

dataEnhancedFilingData

The enhanced data. Null unless status is DONE, and null for a DONE filing with no transactions.

200

Successful Response

202

A build is in progress. Poll again.

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
GET /filings/{filing_id}/enhanced-data?jurisdiction={jurisdiction}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/filings/{filing_id}/enhanced-data?jurisdiction={jurisdiction}
Response
{
"status": "IN_PROGRESS",
"reportId": "rpt_2mNpQr7Ls8f3k",
"data": {
"filingId": "file_2mNpQr7Ls8f3k",
"stateCode": "CA",
"stateName": "Acme Corp",
"filingPeriod": {
"startDate": "2026-07-21",
"endDate": "2026-07-21"
},
"summary": {},
"jurisdictionBreakdown": [
{}
],
"jurisdictionBreakdownGroupedByCounty": [
{}
],
"deductionsExemptions": [
{}
],
"transactionRefunds": [
{}
],
"additionalSummaryFields": {},
"additionalBreakdown": {},
"useTax": {}
}
}
Get a filing's enhanced data (2026-07-21) | Kintsugi API Reference