# List credits

> GET /credits

Source: https://docs.trykintsugi.com/reference/2026-07-21/list-credits

GET /credits

List credits

List credits, keyset-paginated. Covers every organization your credential owns, send an `Organization-Id`, `Connection-Id` or `Entity-Id` header to narrow to one. Filter to one registration's credits with `registrationId`. A cursor is only valid for the filters AND the organization scope it was issued under, including any selector header.

Category: Credits

Query parameters:
registrationId (string) - Return only credits held against this registration.
limit (integer) - Maximum number of items to return.
cursor (string) - Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.

Response fields:
items (Credit[], required) - The credits on this page.
  id (string, required) - Kintsugi's unique identifier for the credit.
  type (PublicCreditTypeEnum, required) - The kind of credit balance: REFUND, OVERPAYMENT, ITC, or IVT.
    allowed values: REFUND, OVERPAYMENT, ITC, IVT
  taxType (PublicTaxTypeEnum, required) - Which tax pool this credit applies to on a combined return.
    allowed values: SALES_TAX, USE_TAX, SALES_AND_USE_TAX, RETAIL_DELIVERY_FEE
  amount (string, required) - The credit's face value, as a decimal string.
  amountConsumed (string, required) - How much of the credit has been applied to filings.
  amountRemaining (string, required) - How much of the credit is still available.
  currency (string) - 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.
  startDate (string, required) - Date the credit becomes available, as YYYY-MM-DD.
  endDate (string) - Date the credit expires, as YYYY-MM-DD. `null` when it does not expire.
  registrationId (string, required) - The registration this credit is held against.
  organizationId (string, required) - The organization that owns the credit. Always present: a portfolio-wide list spans organizations, so a row is ambiguous without it.
  ossRegistrationCountryId (string) - The EU OSS member-state enrollment this credit applies to, for an EU OSS registration. `null` otherwise.
  createdAt (string, required) - When the credit was created, as an RFC-3339 UTC timestamp.
nextCursor (string) - Opaque cursor for the next page. `null` when this is the last page. Send it back as `cursor`; do not parse it.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt
