KintsugiKintsugi

Rebuild a filing's enhanced data

POST/filings/{filing_id}/enhanced-data/rebuild

Start a new enhanced-data build for a US filing, even when a current one is stored, and return 202 with IN_PROGRESS; poll GET /filings/{filingId}/enhanced-data until it is DONE. A build already in progress is reported instead of starting another. A filing with no transactions returns 200 with DONE and null data. Only the organization's own filer can rebuild, as for PUT /filings/{filingId}/submission: self-managed filings must be enabled, and a partner member must be assigned to the organization or the organization assigned to no member. Returns 403 otherwise. Allows 10 requests per minute for each portfolio, or for each organization when there is no portfolio; past that it returns 429.

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

Target organization id (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/rebuild?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.

202

Successful Response

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.

429

The caller is over a rate or usage limit.

cURL
POST /filings/{filing_id}/enhanced-data/rebuild?jurisdiction={jurisdiction}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/filings/{filing_id}/enhanced-data/rebuild?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": {}
}
}
Rebuild a filing's enhanced data (2026-07-21) | Kintsugi API Reference