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"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"detail": "The registration does not exist or you don't have access.",
"status": 404,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
{
"error": {
"type": "INVALID_INPUT",
"title": "Invalid registration ID.",
"detail": "The provided ID is not a valid UUID.",
"status": 400,
"instance": "/api/v1/registrations/v2/not-a-uuid"
}
}
Registrations V2
Get Registration
Retrieve details of a specific V2 registration by ID
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"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"detail": "The registration does not exist or you don't have access.",
"status": 404,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
{
"error": {
"type": "INVALID_INPUT",
"title": "Invalid registration ID.",
"detail": "The provided ID is not a valid UUID.",
"status": 400,
"instance": "/api/v1/registrations/v2/not-a-uuid"
}
}
Retrieve the full details of a V2 registration, including its current status, jurisdiction information, and configuration.
Path parameters
string
required
The unique identifier (UUID) of the registration to retrieve.
Response fields
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the registration |
corporation_id | string | The corporation this registration belongs to |
registration_tax_type_id | string | Content ID identifying the jurisdiction and tax type |
registration_content_id | string | Bare 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_types | array | Tax types registered for (e.g., ["RST", "DTT"]) |
frequencies | array | Filing frequencies (e.g., ["QUARTERLY"]) |
jurisdiction_id | string | Unique identifier for the jurisdiction |
jurisdiction_name | string | Human-readable name of the jurisdiction |
jurisdiction_type | string | Type: STATE_OR_PROVINCE, CITY, COUNTY, COUNTRY, TRADEBLOC, etc. |
registration_name | string | Human-readable name of the registration |
effective_start_date | string | When the registration became effective (YYYY-MM-DD) |
effective_end_date | string | When the registration ended (YYYY-MM-DD), if closed |
tax_registration_number | string | Tax authority issued ID or permit number |
registered_by | string | Who created the registration: API, USER, COMMENDA |
credential_id | string | Reference to stored portal credentials |
managed_filing_enabled | boolean | Whether Commenda-managed filing is enabled for this registration |
registration_status | string | Current registration status |
validation_status | string | PENDING, VALID, or INVALID |
registered_through_registration_tax_type_id | string | Content ID of the country registered through (for Non-Union OSS, IOSS) |
member_state_registration_id | string | UUID of the linked domestic registration (for Union OSS) |
archived_at | string | Timestamp if archived, otherwise null |
created_at | string | When the registration was created |
updated_at | string | When 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"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"detail": "The registration does not exist or you don't have access.",
"status": 404,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
{
"error": {
"type": "INVALID_INPUT",
"title": "Invalid registration ID.",
"detail": "The provided ID is not a valid UUID.",
"status": 400,
"instance": "/api/v1/registrations/v2/not-a-uuid"
}
}
Related
- List Registrations — Get all registrations with filters
- Update Registration — Modify this registration
- Tax Registrations V2 Overview — Registration concepts and lifecycle
Was this page helpful?