API reference / List registration jurisdictions
List registration jurisdictions
GET/v1/registrations/jurisdictions
Distinct registration jurisdictions (country + state) for filter dropdowns. Non-SST only. Default status__in matches GET /registrations (all statuses).
Authorization
x-api-keystringRequired
Your secret API key. Include it with every request.
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.
/v1/registrations/jurisdictions?status__in=<status__in>status__instring
Filter by registration status (comma-separated); same as GET /registrations.
Available options:
REGISTEREDPROCESSINGUNREGISTEREDDEREGISTERINGDEREGISTEREDCANCELLEDVALIDATINGAWAITING_CLARIFICATIONSELF_MANAGEDResponse
country_codestringRequired
ISO 3166-1 alpha-2 country code (e.g. US, DE).
state_codestringRequired
State or province code (may be empty for country-level rows).
state_namestringRequired
Display name for the state or province.
200
Successful Response
Validation Error
cURL
GET /v1/registrations/jurisdictions?status__in=REGISTERED,PROCESSING,UNREGISTERED,DEREGISTERING,DEREGISTERED,CANCELLED,VALIDATING,AWAITING_CLARIFICATION,SELF_MANAGED
-H "x-api-key: ***"
Example request
https://api.trykintsugi.com/v1/registrations/jurisdictions?status__in=REGISTERED,PROCESSING,UNREGISTERED,DEREGISTERING,DEREGISTERED,CANCELLED,VALIDATING,AWAITING_CLARIFICATION,SELF_MANAGED
Response
[
{
"country_code": "string",
"state_code": "string",
"state_name": "string"
}
]