curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000"
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"countries": ["US"],
"states_or_provinces": ["CA", "NY", "TX"]
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"jurisdiction_types": ["CITY", "COUNTY", "DISTRICT"]
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"include_archived": true
}'
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000"
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"countries": ["US"],
"states_or_provinces": ["CA", "NY", "TX"]
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"validation_status": "PENDING"
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"jurisdiction_types": ["CITY", "COUNTY", "DISTRICT"]
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"jurisdiction_name": "Los Angeles"
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"include_archived": true
}
{
"message": "Successfully listed registrations.",
"data": {
"registrations": [
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"registration_content_id": "CCT_US_STATE_CEN_06_RST",
"jurisdiction_id": "JUR_US_STATE_CA",
"jurisdiction_type": "STATE_OR_PROVINCE",
"jurisdiction_name": "California",
"country": "US",
"state_or_province": "CA",
"tax_types": ["RST", "DTT"],
"frequency": "QUARTERLY",
"effective_start_date": "2024-01-15",
"tax_registration_id": "123-456789",
"portal_id": "PORTAL_CA_CDTFA",
"credential_id": "cred_abc123",
"registration_status": "REGISTERED",
"validation_status": "VALID",
"registration_type": "EXISTING",
"registered_by": "API",
"email_alias": "tax-ca@acme.commenda.io",
"created_at": "2024-01-15T10:30:00Z"
},
{
"id": "8d9f7780-8536-51ef-a55c-c2851cbface8",
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"registration_content_id": "CCT_US_STATE_CEN_48_RST",
"jurisdiction_id": "JUR_US_STATE_TX",
"jurisdiction_type": "STATE_OR_PROVINCE",
"jurisdiction_name": "Texas",
"country": "US",
"state_or_province": "TX",
"tax_types": ["RST"],
"frequency": "MONTHLY",
"effective_start_date": "2024-02-01",
"registration_status": "REGISTERED",
"validation_status": "PENDING",
"registration_type": "EXISTING",
"registered_by": "API",
"created_at": "2024-02-01T14:20:00Z"
}
]
}
}
{
"message": "Failed to parse request body.",
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Failed to validate the request body",
"detail": "corporation_id is required",
"status": 400,
"instance": "/api/v1/registrations/list"
}
}
{
"error": {
"type": "CORPORATION_NOT_FOUND",
"title": "Corporation not found.",
"detail": "The corporation_id '550e8400-e29b-41d4-a716-446655440000' does not exist or you don't have access.",
"status": 404,
"instance": "/api/v1/registrations/list"
}
}
Registrations
List Registrations
Retrieve all registrations for a corporation with optional filters
POST
/
api
/
v1
/
registrations
/
list
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000"
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"countries": ["US"],
"states_or_provinces": ["CA", "NY", "TX"]
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"jurisdiction_types": ["CITY", "COUNTY", "DISTRICT"]
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"include_archived": true
}'
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000"
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"countries": ["US"],
"states_or_provinces": ["CA", "NY", "TX"]
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"validation_status": "PENDING"
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"jurisdiction_types": ["CITY", "COUNTY", "DISTRICT"]
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"jurisdiction_name": "Los Angeles"
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"include_archived": true
}
{
"message": "Successfully listed registrations.",
"data": {
"registrations": [
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"registration_content_id": "CCT_US_STATE_CEN_06_RST",
"jurisdiction_id": "JUR_US_STATE_CA",
"jurisdiction_type": "STATE_OR_PROVINCE",
"jurisdiction_name": "California",
"country": "US",
"state_or_province": "CA",
"tax_types": ["RST", "DTT"],
"frequency": "QUARTERLY",
"effective_start_date": "2024-01-15",
"tax_registration_id": "123-456789",
"portal_id": "PORTAL_CA_CDTFA",
"credential_id": "cred_abc123",
"registration_status": "REGISTERED",
"validation_status": "VALID",
"registration_type": "EXISTING",
"registered_by": "API",
"email_alias": "tax-ca@acme.commenda.io",
"created_at": "2024-01-15T10:30:00Z"
},
{
"id": "8d9f7780-8536-51ef-a55c-c2851cbface8",
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"registration_content_id": "CCT_US_STATE_CEN_48_RST",
"jurisdiction_id": "JUR_US_STATE_TX",
"jurisdiction_type": "STATE_OR_PROVINCE",
"jurisdiction_name": "Texas",
"country": "US",
"state_or_province": "TX",
"tax_types": ["RST"],
"frequency": "MONTHLY",
"effective_start_date": "2024-02-01",
"registration_status": "REGISTERED",
"validation_status": "PENDING",
"registration_type": "EXISTING",
"registered_by": "API",
"created_at": "2024-02-01T14:20:00Z"
}
]
}
}
{
"message": "Failed to parse request body.",
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Failed to validate the request body",
"detail": "corporation_id is required",
"status": 400,
"instance": "/api/v1/registrations/list"
}
}
{
"error": {
"type": "CORPORATION_NOT_FOUND",
"title": "Corporation not found.",
"detail": "The corporation_id '550e8400-e29b-41d4-a716-446655440000' does not exist or you don't have access.",
"status": 404,
"instance": "/api/v1/registrations/list"
}
}
List all registrations for a corporation. Supports filtering by country, state, jurisdiction type, registration type, and validation status.
This endpoint uses POST (not GET) to support complex filtering via the request body.
Request Body
string
required
The unique identifier for the corporation whose registrations you want to retrieve.
array
Filter by ISO 3166-1 alpha-2 country codes.Example:
["US", "CA"]array
Filter by state or province codes.Example:
["CA", "NY", "TX"]array
Filter by jurisdiction type.Values:
STATE_OR_PROVINCE, CITY, COUNTY, DISTRICT, LOCAL, COUNTRY, TERRITORY, TRADEBLOCstring
Search by jurisdiction name (partial match).Example:
"California" or "Los Angeles"string
Filter by how the registration was created.Values:
EXISTING— Registration created by the user for an existing tax accountNEW— Registration created by Commenda for a new tax account
string
Filter by validation status.Values:
PENDING, VALIDATION_IN_PROGRESS, VALID, INVALIDboolean
default:"false"
Whether to include archived registrations in the results.
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000"
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"countries": ["US"],
"states_or_provinces": ["CA", "NY", "TX"]
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"jurisdiction_types": ["CITY", "COUNTY", "DISTRICT"]
}'
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/list' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"include_archived": true
}'
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000"
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"countries": ["US"],
"states_or_provinces": ["CA", "NY", "TX"]
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"validation_status": "PENDING"
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"jurisdiction_types": ["CITY", "COUNTY", "DISTRICT"]
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"jurisdiction_name": "Los Angeles"
}
{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"include_archived": true
}
{
"message": "Successfully listed registrations.",
"data": {
"registrations": [
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"registration_content_id": "CCT_US_STATE_CEN_06_RST",
"jurisdiction_id": "JUR_US_STATE_CA",
"jurisdiction_type": "STATE_OR_PROVINCE",
"jurisdiction_name": "California",
"country": "US",
"state_or_province": "CA",
"tax_types": ["RST", "DTT"],
"frequency": "QUARTERLY",
"effective_start_date": "2024-01-15",
"tax_registration_id": "123-456789",
"portal_id": "PORTAL_CA_CDTFA",
"credential_id": "cred_abc123",
"registration_status": "REGISTERED",
"validation_status": "VALID",
"registration_type": "EXISTING",
"registered_by": "API",
"email_alias": "tax-ca@acme.commenda.io",
"created_at": "2024-01-15T10:30:00Z"
},
{
"id": "8d9f7780-8536-51ef-a55c-c2851cbface8",
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"registration_content_id": "CCT_US_STATE_CEN_48_RST",
"jurisdiction_id": "JUR_US_STATE_TX",
"jurisdiction_type": "STATE_OR_PROVINCE",
"jurisdiction_name": "Texas",
"country": "US",
"state_or_province": "TX",
"tax_types": ["RST"],
"frequency": "MONTHLY",
"effective_start_date": "2024-02-01",
"registration_status": "REGISTERED",
"validation_status": "PENDING",
"registration_type": "EXISTING",
"registered_by": "API",
"created_at": "2024-02-01T14:20:00Z"
}
]
}
}
{
"message": "Failed to parse request body.",
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Failed to validate the request body",
"detail": "corporation_id is required",
"status": 400,
"instance": "/api/v1/registrations/list"
}
}
{
"error": {
"type": "CORPORATION_NOT_FOUND",
"title": "Corporation not found.",
"detail": "The corporation_id '550e8400-e29b-41d4-a716-446655440000' does not exist or you don't have access.",
"status": 404,
"instance": "/api/v1/registrations/list"
}
}
Related
- Get Registration — Get details for a specific registration
- Create Registration — Create a new registration
- Tax Registrations Overview — Registration concepts and lifecycle
Was this page helpful?
⌘I