Create a credit
Create a credit against a registration in the given organization. registrationId is required and must belong to that organization. The credit type and currency are derived from the registration, an EU OSS registration produces an IVT credit in EUR (and requires ossRegistrationCountryId), any other supported jurisdiction produces an ITC credit in the registration country's currency. A credit for an unsupported jurisdiction is rejected.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Body
The registration to hold the credit against.
The credit's face value, as a decimal string.
The EU OSS member-state enrollment the credit applies to. Required for an EU OSS registration; leave null otherwise.
Date the credit expires, as YYYY-MM-DD. null for a credit that does not expire.
An optional free-text note stored with the credit.
Response
Kintsugi's unique identifier for the credit.
The kind of credit balance: REFUND, OVERPAYMENT, ITC, or IVT.
REFUNDOVERPAYMENTITCIVTWhich tax pool this credit applies to on a combined return.
SALES_TAXUSE_TAXSALES_AND_USE_TAXRETAIL_DELIVERY_FEEThe credit's face value, as a decimal string.
How much of the credit has been applied to filings.
How much of the credit is still available.
ISO-4217 currency code of the amounts. Every credit created through this API records one (derived from the registration); null appears only on legacy credits created before a currency was stored.
Date the credit becomes available, as YYYY-MM-DD.
Date the credit expires, as YYYY-MM-DD. null when it does not expire.
The registration this credit is held against.
The organization that owns the credit. Always present: a portfolio-wide list spans organizations, so a row is ambiguous without it.
The EU OSS member-state enrollment this credit applies to, for an EU OSS registration. null otherwise.
When the credit was created, as an RFC-3339 UTC timestamp.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.