# List exemptions

> GET /exemptions

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

GET /exemptions

List exemptions

List exemptions, keyset-paginated. Covers every organization your credential owns; send an `Organization-Id`, `Connection-Id` or `Entity-Id` selector to narrow to one. Filter to one customer's exemptions with `customerId`, and to a country, jurisdiction, validity start or end date, connection, or a customer name / email substring with the matching parameter. Pass `sort` and `order` to order the list; omit `sort` to keep the default order. `sort=customerName` orders by the owning customer's name. Pass `expand=customer` to embed the owning customer's `companyName` and `customerName` under `customer` on each row. Pass `limit` and the opaque `cursor` from a prior response's `nextCursor` or `previousCursor` to page; `hasMore` and `hasPrevious` report whether a page exists that way. Archived exemptions are excluded. A cursor is only valid for the sort, the filters AND the organization scope it was issued under, including any selector header: change any of them and start again from the first page. `expand` does not affect which exemptions are returned, so a cursor stays valid whether or not you pass it.

Category: Exemptions

Query parameters:
sort (PublicExemptionSortEnum) - Field to sort by. Omit to keep the default ordering. `customerName` orders by the owning customer's name, resolved server-side.
  allowed values: country, jurisdiction, customerName, startDate, endDate, status
order (PublicExemptionSortOrder) - Sort direction. Applies only when `sort` is set. Defaults to `asc`.
  allowed values: asc, desc
customerId (string) - Comma-separated customer ids; matches any of them. This is how you read one customer's exemptions.
transactionId (string) - Comma-separated transaction ids; matches any of them.
status (string) - Comma-separated lifecycle statuses; matches any of them. ARCHIVED is never returned and is rejected here.
exemptionType (string) - Comma-separated exemption types; matches any of them.
country (string) - Comma-separated ISO 3166-1 alpha-2 country codes; matches any of them.
jurisdiction (string) - State or province code the exemption is scoped to.
startDate (string) - Match exemptions whose validity start date is this date.
endDate (string) - Match exemptions whose validity end date is this date.
search (string) - Match an exact exemption id, or a customer name or email substring.
[truncated, see the reference page]

---

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