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
The unique identifier for the corporation whose registrations you want to retrieve.
Filter by ISO 3166-1 alpha-2 country codes.Example:
["US", "CA"]Filter by state or province codes.Example:
["CA", "NY", "TX"]Filter by jurisdiction type.Values:
STATE_OR_PROVINCE, CITY, COUNTY, DISTRICT, LOCAL, COUNTRY, TERRITORY, TRADEBLOCSearch by jurisdiction name (partial match).Example:
"California" or "Los Angeles"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
Filter by validation status.Values:
PENDING, VALIDATION_IN_PROGRESS, VALID, INVALIDWhether 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