KintsugiKintsugi

Approve filings in bulk

POST/filings/bulk/approve

Approve several filings in one organization. Requires an ADMIN or OWNER credential; send an Organization-Id, Connection-Id or Entity-Id selector to say which organization they belong to. Returns 200 with a per-filing successful/failed breakdown even when some filings cannot be approved (unknown id, not an approvable status, or a disabled jurisdiction). Approving BACK_FILING rows with published terms requires backFilingTermsId. Returns 403 PLAN_UPGRADE_REQUIRED when the organization is on a free plan, and 403 FORBIDDEN when the organization's plan does not include managed filings.

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.

Body

filingIdsstring[]Required

Ids of the filings to approve. Duplicates are ignored.

backFilingTermsIdstring

Id of the back-filing terms version accepted for any BACK_FILING.

backFilingTermsAcceptedAtstring

When the customer accepted the back-filing terms (advisory).

requestIdstring

Client-minted id for this confirm attempt, stored on the audit row.

Response

successfulstring[]Required

Filing ids acted on, or accepted for a worker when queued.

failedBulkFilingFailure[]Required

Requested filings that were not acted on, each with a reason.

queuedboolean

Whether the batch was enqueued for a worker rather than applied inline.

jobIdstring

Reserved for a pollable job handle; null until a job surface exists.

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
POST /filings/bulk/approve
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"filingIds": [
"flng_1",
"flng_2"
],
"backFilingTermsId": "bfts_2mNpQr7Ls8f3k",
"backFilingTermsAcceptedAt": "2026-07-21T15:30:00Z",
"requestId": "req_2mNpQr7Ls8f3k"
}
Response
{
"successful": [
"successful"
],
"failed": [
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"reason": "Customer request"
}
],
"queued": false,
"jobId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10"
}
Approve filings in bulk (2026-07-21) | Kintsugi API Reference