KintsugiKintsugi
API reference / Request back-filings

Request back-filings

POST/filings/backFilingRequest

Create unapproved BACK_FILING rows for the requested registrations and periods. Send an Organization-Id, Connection-Id or Entity-Id selector to say which organization to create them in; the periods must be within the eligible options from GET /filings/backFilingRequest/options. Returns 404 when back-filing is not available for the organization or a registration is not visible, 400 when a requested period is invalid or out of bounds, 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

requestsBackFilingRequestRegistrationInput[]Required

The registrations and periods to request back-filings for.

notesstring

Optional note recorded on each created filing.

Response

createdFiling[]Required

The BACK_FILING filings created by this request, unapproved.

totalCreatedintegerRequired

How many filings were created.

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/backFilingRequest
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"requests": [
{
"registrationId": "regs_2mNpQr7Ls8f3k",
"periods": [
{
"startDate": "2026-07-21",
"endDate": "2026-07-21"
}
]
}
],
"notes": "Reviewed and approved."
}
Response
{
"created": [
{
"id": "file_2mNpQr7Ls8f3k",
"organizationId": "orgn_2mNpQr7Ls8f3k",
"organizationName": "Acme Corp",
"registrationId": "regs_2mNpQr7Ls8f3k",
"status": "UNFILED",
"filingCategory": "REGULAR",
"taxType": "SALES_TAX",
"countryCode": "US",
"stateCode": "CA",
"stateName": "Acme Corp",
"startDate": "2026-07-21",
"endDate": "2026-07-21",
"dueDate": "2026-07-21",
"dateFiled": "2026-07-21",
"returnConfirmationId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"paymentConfirmationId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"pausedUntilDate": "2026-07-21",
"isPausable": false,
"canApprove": true,
"skipReason": "Customer request",
"isPrepayment": false,
"isFinal": false,
"isRdf": false,
"transactionCount": 1,
"filingWebsiteUrl": "https://www.example.com",
"approvedAt": "2026-07-28T12:00:00Z",
"createdAt": "2026-07-28T12:00:00Z",
"currency": "USD",
"amount": "10.00",
"amountCalculated": "10.00",
"amountAdjusted": "10.00",
"amountDiscounts": "10.00",
"amountFees": "10.00",
"feeType": "PENALTY",
"amountPenalties": "10.00",
"amountTaxCollected": "10.00",
"amountUseTax": "10.00",
"amountSales": "10.00",
"totalTaxLiability": "10.00",
"taxRemitted": "10.00",
"amountInputVatRecoverable": "10.00",
"amountInputVatTrueUp": "10.00",
"filingFrequency": "UNKNOWN",
"ossType": "UNION",
"quarterlyPrepayBalance": {
"grossTaxLiability": "10.00",
"balanceDue": "10.00",
"prepaymentDeductions": [
{
"label": "April prepayment",
"amount": "10.00",
"filingId": "file_2mNpQr7Ls8f3k"
}
]
},
"caMayPrepayment": {
"baseTaxLiability": "10.00",
"prepaymentAmount": "10.00",
"note": "Reviewed and approved."
},
"estimatedPenaltyInterest": "10.00",
"penaltyInterestRemittanceTag": "penalty interest remittance tag",
"salesBreakdown": {
"totalTaxableSales": "10.00",
"exemptSales": "10.00",
"marketplaceTransactionCount": 1,
"creditsUtilized": "10.00",
"deferredTransactionCount": 1
},
"vatRecovery": {
"inputVatRecoveryRate": "10.00",
"inputVatRecoveryRateIsDefinitive": false
},
"filingArtifacts": {
"returnArtifact": {
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"fileName": "certificate.pdf"
},
"paymentArtifact": {
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"fileName": "certificate.pdf"
},
"additionalArtifacts": [
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"fileName": "certificate.pdf"
}
]
}
}
],
"totalCreated": 2
}
Request back-filings (2026-07-21) | Kintsugi API Reference