Skip to main content
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"
  }'

{
  "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"
      }
    ]
  }
}
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

​
corporation_id
string
required
The unique identifier for the corporation whose registrations you want to retrieve.
​
countries
array
Filter by ISO 3166-1 alpha-2 country codes.Example: ["US", "CA"]
​
states_or_provinces
array
Filter by state or province codes.Example: ["CA", "NY", "TX"]
​
jurisdiction_types
array
Filter by jurisdiction type.Values: STATE_OR_PROVINCE, CITY, COUNTY, DISTRICT, LOCAL, COUNTRY, TERRITORY
​
jurisdiction_name
string
Search by jurisdiction name (partial match).Example: "California" or "Los Angeles"
​
registration_type
string
Filter by how the registration was created.Values:
  • EXISTING — Registration created by the user for an existing tax account
  • NEW — Registration created by Commenda for a new tax account
​
validation_status
string
Filter by validation status.Values: PENDING, VALIDATION_IN_PROGRESS, VALID, INVALID
​
include_archived
boolean
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"
  }'

{
  "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"
      }
    ]
  }
}