KintsugiKintsugi

Summarize filings

GET/filings/summary

Count filings by lifecycle status and total the scope's tax across every organization your credential owns; send an Organization-Id, Connection-Id or Entity-Id selector to narrow to one. A status with no filings is omitted rather than reported as zero. Pass managedBy to count only the filings that one party files.

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

Narrow the request to a connection's organization.

Entity-Idstring

Narrow the request to a platform entity's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

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/summary?managedBy=<managedBy>
managedBystring

Comma-separated list of who files the return: KINTSUGI or PARTNER. Matches any listed value. This is the filing's executedBy.

Response

totalintegerRequired

Total filings in scope, across every status.

statusCountsFilingStatusCount[]Required

One entry per status present in scope. A status with no filings is omitted rather than reported as zero.

totalTaxCollectedstringRequired

Tax collected across open (UNFILED, FILING or SUBMITTED) filings in scope.

totalTaxRemittedstringRequired

Tax remitted across FILED filings in scope.

totalTaxCalculatedstringRequired

Calculated tax across open (UNFILED, FILING or SUBMITTED) filings in scope.

totalTaxLiabilitystringRequired

Total tax liability across open (UNFILED, FILING or SUBMITTED) filings in scope.

200

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.

cURL
GET /filings/summary?managedBy={managedBy}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/filings/summary?managedBy={managedBy}
Response
{
"total": 12,
"statusCounts": [
{
"status": "UNFILED",
"count": 3
}
],
"totalTaxCollected": "10.00",
"totalTaxRemitted": "10.00",
"totalTaxCalculated": "10.00",
"totalTaxLiability": "10.00"
}
Summarize filings (2026-07-21) | Kintsugi API Reference