KintsugiKintsugi

Get a filing's payment instructions

GET/filings/{filing_id}/paymentInstructions

Fetch the latest payment instructions sent for a filing whose tax you pay to the tax authority yourself, with every payment receipt uploaded for the filing. Searched across every organization your credential owns, so no selector is needed for a known id. Download a receipt through GET /attachments/{id}/download. Returns 404 if the filing does not exist, belongs to an organization your credential cannot access, or has no payment instructions.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-10-06.

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.

Path parameters

filing_idstringRequired

The unique identifier of the filing.

Response

amountstringRequired

Amount to pay, as a decimal string.

currencyPublicCurrencyEnumRequired

ISO-4217 currency of amount.

Available options:AEDAFNALLAMDANGAOAARSAUDAWGAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBRLBSDBTNBWPBYNBZDCADCDFCHFCLPCNYCOPCRCCUCCUPCVECZKDJFDKKDOPDZDEGPERNETBEURFJDFKPGBPGELGGPGHSGIPGMDGNFGTQGYDHKDHNLHRKHTGHUFIDRILSIMPINRIQDIRRISKJEPJMDJODJPYKESKGSKHRKMFKPWKRWKWDKYDKZTLAKLBPLKRLRDLSLLYDMADMDLMGAMKDMMKMNTMOPMRUMURMVRMWKMXNMYRMZNNADNGNNIONOKNPRNZDOMRPABPENPGKPHPPKRPLNPYGQARRONRSDRUBRWFSARSBDSCRSDGSEKSGDSHPSLLSOSSPLSRDSTNSVCSYPSZLTHBTJSTMTTNDTOPTRYTTDTVDTWDTZSUAHUGXUSDUYUUZSVEFVNDVUVWSTXAFXCDXDRXOFXPFYERZARZMWZWD
referencestringRequired

Reference to enter with the payment so the authority can match it.

deadlinestringRequired

Pay by this date, as YYYY-MM-DD.

legalDeadlinestringRequired

The tax authority's payment deadline, as YYYY-MM-DD. Null on instructions sent before it was included.

paymentDetailsFilingPaymentDetail[]Required

Where and how to pay, as label and value pairs.

sentAtstringRequired

When the instructions were sent, as an RFC-3339 UTC timestamp.

receiptsFilingPaymentReceipt[]Required

Payment receipts uploaded for the filing, most recent first. Empty when none was uploaded.

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/{filing_id}/paymentInstructions
-H "Api-Key: ***"
-H "Api-Version: 2026-10-06"
Example request
https://api.trykintsugi.com/filings/{filing_id}/paymentInstructions
Response
{
"amount": "1234.56",
"currency": "AED",
"reference": "123456789",
"deadline": "2026-11-02",
"legalDeadline": "2026-11-07",
"paymentDetails": [
{
"label": "IBAN",
"value": "GB36BARC20051773152391"
}
],
"sentAt": "2026-10-09T12:00:00Z",
"receipts": [
{
"id": "atch_2mNpQr7Ls8f3k",
"fileName": "receipt.pdf",
"uploadedAt": "2026-10-09T12:00:00Z"
}
]
}
Get a filing's payment instructions (2026-10-06) | Kintsugi API Reference