Skip to main content
POST
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, TRADEBLOC
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.