Skip to main content
POST
/
api
/
v1
/
registrations
/
v2
/
list
curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/list' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "corporation_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

{
  "data": {
    "registrations": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "corporation_id": "550e8400-e29b-41d4-a716-446655440000",
        "registration_tax_type_id": "REG_STATE_CEN_06_RST",
        "tax_types": ["RST", "DTT"],
        "frequencies": ["QUARTERLY"],
        "jurisdiction_id": "JUR_US_STATE_CA",
        "jurisdiction_name": "California",
        "jurisdiction_type": "STATE_OR_PROVINCE",
        "registration_name": "Sales and Use Tax",
        "effective_start_date": "2024-01-01",
        "registered_by": "COMMENDA",
        "registration_status": "PENDING",
        "validation_status": "PENDING",
        "created_at": "2024-01-15T10:30:00Z"
      },
      {
        "id": "8d9f7780-8536-51ef-a55c-c2851cbface8",
        "corporation_id": "550e8400-e29b-41d4-a716-446655440000",
        "registration_tax_type_id": "REG_STATE_CEN_48_RST",
        "tax_types": ["RST"],
        "frequencies": ["MONTHLY"],
        "jurisdiction_id": "JUR_US_STATE_TX",
        "jurisdiction_name": "Texas",
        "jurisdiction_type": "STATE_OR_PROVINCE",
        "registration_name": "Sales and Use Tax",
        "effective_start_date": "2024-02-01",
        "registered_by": "API",
        "registration_status": "PENDING",
        "validation_status": "PENDING",
        "created_at": "2024-02-01T14:20:00Z"
      }
    ],
    "total": 12,
    "cursor": "encoded_next_page_cursor"
  }
}
List all V2 registrations for a corporation. Supports filtering by country, state, jurisdiction type, registration status, validation status, and jurisdiction name search. Results are cursor-paginated.
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. Maximum 100 items.Example: ["US", "DE"]
​
states
array
Filter by state or province codes. Maximum 100 items.Example: ["CA", "NY", "TX"]
​
jurisdiction_types
array
Filter by jurisdiction type. Maximum 100 items.Values: STATE_OR_PROVINCE, CITY, COUNTY, DISTRICT, LOCAL, COUNTRY, TERRITORY, TRADEBLOC
​
jurisdiction_name
string
Search by jurisdiction name (partial match).Example: "California" or "Germany"
​
registration_status
string
Filter by registration status.
​
validation_status
string
Filter by validation status.Values: PENDING, VALID, INVALID
​
include_archived
boolean
default:"false"
Whether to include archived registrations in the results.
​
cursor
string
Pagination cursor from a previous response. Leave empty for the first page.
​
limit
integer
default:"10"
Maximum number of results to return (1–100).
curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/list' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "corporation_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

{
  "data": {
    "registrations": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "corporation_id": "550e8400-e29b-41d4-a716-446655440000",
        "registration_tax_type_id": "REG_STATE_CEN_06_RST",
        "tax_types": ["RST", "DTT"],
        "frequencies": ["QUARTERLY"],
        "jurisdiction_id": "JUR_US_STATE_CA",
        "jurisdiction_name": "California",
        "jurisdiction_type": "STATE_OR_PROVINCE",
        "registration_name": "Sales and Use Tax",
        "effective_start_date": "2024-01-01",
        "registered_by": "COMMENDA",
        "registration_status": "PENDING",
        "validation_status": "PENDING",
        "created_at": "2024-01-15T10:30:00Z"
      },
      {
        "id": "8d9f7780-8536-51ef-a55c-c2851cbface8",
        "corporation_id": "550e8400-e29b-41d4-a716-446655440000",
        "registration_tax_type_id": "REG_STATE_CEN_48_RST",
        "tax_types": ["RST"],
        "frequencies": ["MONTHLY"],
        "jurisdiction_id": "JUR_US_STATE_TX",
        "jurisdiction_name": "Texas",
        "jurisdiction_type": "STATE_OR_PROVINCE",
        "registration_name": "Sales and Use Tax",
        "effective_start_date": "2024-02-01",
        "registered_by": "API",
        "registration_status": "PENDING",
        "validation_status": "PENDING",
        "created_at": "2024-02-01T14:20:00Z"
      }
    ],
    "total": 12,
    "cursor": "encoded_next_page_cursor"
  }
}