Skip to main content
GET
/
api
/
v1
/
registrations
/
v2
/
{tax_registration_id}
curl --request GET \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
  --header 'Authorization: Bearer <your_token>'

{
  "data": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "corporation_id": "550e8400-e29b-41d4-a716-446655440000",
    "registration_tax_type_id": "REG_STATE_CEN_06_RST",
    "registration_content_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-15",
    "managed_filing_enabled": false,
    "registered_by": "COMMENDA",
    "registration_status": "PENDING",
    "validation_status": "PENDING",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-20T15:45:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.commenda.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve the full details of a V2 registration, including its current status, jurisdiction information, and configuration.

​
Path parameters

​
tax_registration_id
string
required
The unique identifier (UUID) of the registration to retrieve.

​
Response fields

FieldTypeDescription
idstringUnique identifier for the registration
corporation_idstringThe corporation this registration belongs to
registration_tax_type_idstringContent ID identifying the jurisdiction and tax type
registration_content_idstringBare registration content ID for the jurisdiction (e.g., REG_COUNTRY_DE_3001_VAT). Use this for exact-match comparisons against the recommended_registration_content_ids returned by exposure webhooks and nexus rules. May be empty for legacy registrations.
tax_typesarrayTax types registered for (e.g., ["RST", "DTT"])
frequenciesarrayFiling frequencies (e.g., ["QUARTERLY"])
jurisdiction_idstringUnique identifier for the jurisdiction
jurisdiction_namestringHuman-readable name of the jurisdiction
jurisdiction_typestringType: STATE_OR_PROVINCE, CITY, COUNTY, COUNTRY, TRADEBLOC, etc.
registration_namestringHuman-readable name of the registration
effective_start_datestringWhen the registration became effective (YYYY-MM-DD)
effective_end_datestringWhen the registration ended (YYYY-MM-DD), if closed
tax_registration_numberstringTax authority issued ID or permit number
registered_bystringWho created the registration: API, USER, COMMENDA
credential_idstringReference to stored portal credentials
managed_filing_enabledbooleanWhether Commenda-managed filing is enabled for this registration
registration_statusstringCurrent registration status
validation_statusstringPENDING, VALID, or INVALID
registered_through_registration_tax_type_idstringContent ID of the country registered through (for Non-Union OSS, IOSS)
member_state_registration_idstringUUID of the linked domestic registration (for Union OSS)
archived_atstringTimestamp if archived, otherwise null
created_atstringWhen the registration was created
updated_atstringWhen the registration was last updated
curl --request GET \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
  --header 'Authorization: Bearer <your_token>'

{
  "data": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "corporation_id": "550e8400-e29b-41d4-a716-446655440000",
    "registration_tax_type_id": "REG_STATE_CEN_06_RST",
    "registration_content_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-15",
    "managed_filing_enabled": false,
    "registered_by": "COMMENDA",
    "registration_status": "PENDING",
    "validation_status": "PENDING",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-20T15:45:00Z"
  }
}