KintsugiKintsugi

Upload a payment receipt

POST/filings/{filing_id}/paymentReceipts

Upload proof that you paid the tax authority for a filing, as multipart/form-data with the file in the file part. Kintsugi reviews the receipt before completing the filing. The filing's status does not change. A filing takes at most 20 receipts. Send an Organization-Id, Connection-Id or Entity-Id selector to say which organization the filing belongs to.

The file must be a PDF, PNG or JPEG of at most 10 MB. Returns 404 if the filing does not exist or belongs to an organization your credential cannot access, 409 if no payment instructions were sent for the filing, the filing is not waiting for payment or it already has 20 receipts, 413 if the file is too large, and 422 if it is not a PDF, PNG or JPEG.

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.

Response

idstringRequired

Attachment id of the receipt. Download it through the attachments API (GET /attachments/{id}/download).

fileNamestringRequired

Name the file was uploaded under.

uploadedAtstringRequired

When the receipt was uploaded, as an RFC-3339 UTC timestamp.

201

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.

413

The request body is larger than this endpoint accepts.

422

The request failed validation.

503

A service this request depends on was unavailable. Retry the request.

cURL
POST /filings/{filing_id}/paymentReceipts
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/filings/{filing_id}/paymentReceipts
Response
{
"id": "atch_2mNpQr7Ls8f3k",
"fileName": "receipt.pdf",
"uploadedAt": "2026-10-09T12:00:00Z"
}
Upload a payment receipt (2026-07-21) | Kintsugi API Reference