curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/available-jurisdictions' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"filters": {
"countries": ["US"],
"types": ["STATE_OR_PROVINCE"]
},
"limit": 50
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/available-jurisdictions' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"search": "Los Angeles",
"filters": {"countries": ["US"]},
"limit": 20
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/available-jurisdictions' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"filters": {
"countries": ["US"],
"states": ["CA"],
"types": ["CITY"]
},
"limit": 50
}'
{
"filters": {
"countries": ["US"],
"types": ["STATE_OR_PROVINCE"]
},
"limit": 50
}
{
"filters": {
"countries": ["US"],
"states": ["CA", "TX", "NY", "FL"]
},
"limit": 10
}
{
"search": "Los Angeles",
"filters": {
"countries": ["US"]
},
"limit": 20
}
{
"filters": {
"countries": ["US"],
"states": ["CA"],
"types": ["CITY"]
},
"limit": 50
}
{
"filters": {
"countries": ["US"],
"types": ["STATE_OR_PROVINCE"]
},
"cursor": "SlVSX1VTX1NUQVRFX1dZ",
"limit": 10
}
{
"data": {
"jurisdictions": [
{
"jurisdiction_id": "JUR_US_STATE_CA",
"jurisdiction_name": "California",
"jurisdiction_type": "STATE_OR_PROVINCE",
"state_or_province": "CA",
"country": "US"
},
{
"jurisdiction_id": "JUR_US_STATE_TX",
"jurisdiction_name": "Texas",
"jurisdiction_type": "STATE_OR_PROVINCE",
"state_or_province": "TX",
"country": "US"
},
{
"jurisdiction_id": "JUR_US_STATE_NY",
"jurisdiction_name": "New York",
"jurisdiction_type": "STATE_OR_PROVINCE",
"state_or_province": "NY",
"country": "US"
}
],
"total": 45,
"cursor": "SlVSX1VTX1NUQVRFX05Z"
}
}
{
"message": "Failed to parse request body.",
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Failed to validate the request body",
"detail": "limit must be between 1 and 100",
"status": 400,
"instance": "/api/v1/registrations/content/available-jurisdictions"
}
}
Registration Content
List Available Jurisdictions
Search for jurisdictions where you can create tax registrations
POST
/
api
/
v1
/
registrations
/
content
/
available-jurisdictions
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/available-jurisdictions' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"filters": {
"countries": ["US"],
"types": ["STATE_OR_PROVINCE"]
},
"limit": 50
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/available-jurisdictions' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"search": "Los Angeles",
"filters": {"countries": ["US"]},
"limit": 20
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/available-jurisdictions' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"filters": {
"countries": ["US"],
"states": ["CA"],
"types": ["CITY"]
},
"limit": 50
}'
{
"filters": {
"countries": ["US"],
"types": ["STATE_OR_PROVINCE"]
},
"limit": 50
}
{
"filters": {
"countries": ["US"],
"states": ["CA", "TX", "NY", "FL"]
},
"limit": 10
}
{
"search": "Los Angeles",
"filters": {
"countries": ["US"]
},
"limit": 20
}
{
"filters": {
"countries": ["US"],
"states": ["CA"],
"types": ["CITY"]
},
"limit": 50
}
{
"filters": {
"countries": ["US"],
"types": ["STATE_OR_PROVINCE"]
},
"cursor": "SlVSX1VTX1NUQVRFX1dZ",
"limit": 10
}
{
"data": {
"jurisdictions": [
{
"jurisdiction_id": "JUR_US_STATE_CA",
"jurisdiction_name": "California",
"jurisdiction_type": "STATE_OR_PROVINCE",
"state_or_province": "CA",
"country": "US"
},
{
"jurisdiction_id": "JUR_US_STATE_TX",
"jurisdiction_name": "Texas",
"jurisdiction_type": "STATE_OR_PROVINCE",
"state_or_province": "TX",
"country": "US"
},
{
"jurisdiction_id": "JUR_US_STATE_NY",
"jurisdiction_name": "New York",
"jurisdiction_type": "STATE_OR_PROVINCE",
"state_or_province": "NY",
"country": "US"
}
],
"total": 45,
"cursor": "SlVSX1VTX1NUQVRFX05Z"
}
}
{
"message": "Failed to parse request body.",
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Failed to validate the request body",
"detail": "limit must be between 1 and 100",
"status": 400,
"instance": "/api/v1/registrations/content/available-jurisdictions"
}
}
Search for tax jurisdictions where registrations are available. Returns jurisdictions that match your filters, with pagination support for large result sets.
Request Body
object
Filter criteria for jurisdictions.
Show Filter options
Show Filter options
array
Filter by ISO 3166-1 alpha-2 country codes.Example:
["US"]array
Filter by state or province codes.Example:
["CA", "NY", "TX"]array
Filter by jurisdiction type.Values:
TRADEBLOC, COUNTRY, STATE_OR_PROVINCE, CITY, COUNTY, DISTRICT, LOCAL, TERRITORYarray
Filter by available tax types.Values:
RST, RUT, DTT, SSTboolean
If
true, only return jurisdictions that can be registered independently (not covered by another registration).string
Filter by jurisdictions covered by a specific registration. Useful for finding local jurisdictions under a state registration.
string
Free-text search across jurisdiction names.Example:
"Los Angeles" or "California"string
Pagination cursor from a previous response. Leave empty for the first page.
integer
default:"10"
Maximum number of results to return (1-100).
Response Fields
| Field | Type | Description |
|---|---|---|
jurisdictions | array | List of matching jurisdictions |
jurisdictions[].jurisdiction_id | string | Unique identifier for the jurisdiction |
jurisdictions[].jurisdiction_name | string | Human-readable name |
jurisdictions[].jurisdiction_type | string | Type of jurisdiction (STATE_OR_PROVINCE, CITY, COUNTY, DISTRICT, LOCAL, COUNTRY, TERRITORY, TRADEBLOC) |
jurisdictions[].state_or_province | string | State/province code if applicable |
jurisdictions[].country | string | ISO country code |
total | integer | Total number of matching jurisdictions |
cursor | string | Cursor for the next page (empty if no more results) |
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/available-jurisdictions' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"filters": {
"countries": ["US"],
"types": ["STATE_OR_PROVINCE"]
},
"limit": 50
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/available-jurisdictions' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"search": "Los Angeles",
"filters": {"countries": ["US"]},
"limit": 20
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/available-jurisdictions' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"filters": {
"countries": ["US"],
"states": ["CA"],
"types": ["CITY"]
},
"limit": 50
}'
{
"filters": {
"countries": ["US"],
"types": ["STATE_OR_PROVINCE"]
},
"limit": 50
}
{
"filters": {
"countries": ["US"],
"states": ["CA", "TX", "NY", "FL"]
},
"limit": 10
}
{
"search": "Los Angeles",
"filters": {
"countries": ["US"]
},
"limit": 20
}
{
"filters": {
"countries": ["US"],
"states": ["CA"],
"types": ["CITY"]
},
"limit": 50
}
{
"filters": {
"countries": ["US"],
"types": ["STATE_OR_PROVINCE"]
},
"cursor": "SlVSX1VTX1NUQVRFX1dZ",
"limit": 10
}
{
"data": {
"jurisdictions": [
{
"jurisdiction_id": "JUR_US_STATE_CA",
"jurisdiction_name": "California",
"jurisdiction_type": "STATE_OR_PROVINCE",
"state_or_province": "CA",
"country": "US"
},
{
"jurisdiction_id": "JUR_US_STATE_TX",
"jurisdiction_name": "Texas",
"jurisdiction_type": "STATE_OR_PROVINCE",
"state_or_province": "TX",
"country": "US"
},
{
"jurisdiction_id": "JUR_US_STATE_NY",
"jurisdiction_name": "New York",
"jurisdiction_type": "STATE_OR_PROVINCE",
"state_or_province": "NY",
"country": "US"
}
],
"total": 45,
"cursor": "SlVSX1VTX1NUQVRFX05Z"
}
}
{
"message": "Failed to parse request body.",
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Failed to validate the request body",
"detail": "limit must be between 1 and 100",
"status": 400,
"instance": "/api/v1/registrations/content/available-jurisdictions"
}
}
Next Steps
After finding jurisdictions, use the Registration Input Options endpoint to get theregistration_content_id and available tax types for each jurisdiction.
Related
- Registration Content Overview — Full content API workflow
- Tax Registrations — Registration concepts and lifecycle
Was this page helpful?
⌘I