List registrations
List tax registrations, keyset-paginated. Covers every organization your credential owns; send an Organization-Id, Connection-Id or Entity-Id selector to narrow to one. Every filter takes a comma-separated list and matches any of the values you send. 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. Pass sort and order to order the list; omit sort to keep the default order. None of the sort keys is index-backed, so sorting a large organization's registrations sorts the whole matching set. 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.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Narrow the request to one organization (Organization-Id selector).
Narrow the request to a connection's organization.
Narrow the request to a platform entity's organization.
Optional source to disambiguate an Entity-Id.
Query
Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.
/registrations?sort=<sort>&order=<order>&status=<status>Field to sort by. Omit to keep the default ordering. organizationName orders by the owning organization's display name, which is useful only on a portfolio-wide list. None of the keys is index-backed, so sorting sorts the whole matching set on a large organization.
organizationNamecountryCodestateCoderegistrationDatestatusSort direction. Applies only when sort is set. Defaults to asc.
ascdescComma-separated lifecycle statuses; matches any of them.
Comma-separated ISO 3166-1 alpha-2 country codes; matches any of them.
Comma-separated state or province codes; matches any of them. Combine it with countryCode when a code is not unique across countries.
Comma-separated filing frequencies; matches any of them.
Comma-separated tax types; matches any of them.
Maximum number of items to return.
Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.
Response
The registrations on this page.
Opaque cursor for the next page. null when this is the last page. Send it back as cursor; do not parse it.
Opaque cursor for the previous page. null when this is the first page. Send it back as cursor; do not parse it.
Whether a page exists after this one.
Whether a page exists before this one.
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.