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

{
  "message": "Successfully fetched registration.",
  "data": {
    "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",
    "updated_at": "2024-01-20T15:45:00Z"
  }
}
Retrieve the full details of a registration, including its current status, jurisdiction information, and configuration.

​
Path Parameters

​
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_content_idstringContent ID identifying the jurisdiction and tax type
jurisdiction_idstringUnique identifier for the jurisdiction
jurisdiction_typestringType: STATE_OR_PROVINCE, CITY, COUNTY, DISTRICT, etc.
jurisdiction_namestringHuman-readable name of the jurisdiction
countrystringISO 3166-1 alpha-2 country code
state_or_provincestringState or province code (e.g., “CA”, “TX”)
tax_typesarrayTax types registered for (e.g., ["RST", "DTT"])
frequencystringFiling frequency
effective_start_datestringWhen the registration became effective (YYYY-MM-DD)
effective_end_datestringWhen the registration ended (YYYY-MM-DD), if closed
tax_registration_idstringState-issued tax ID or permit number
portal_idstringTax portal identifier
credential_idstringReference to stored portal credentials
registration_statusstringREGISTRATION_IN_PROGRESS or REGISTERED
validation_statusstringPENDING, VALIDATION_IN_PROGRESS, VALID, or INVALID
registration_typestringEXISTING or NEW
registered_bystringWho created the registration: API, USER, COMMENDA
email_aliasstringEmail alias for tax correspondence
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/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
  --header 'Authorization: Bearer <your_token>'

{
  "message": "Successfully fetched registration.",
  "data": {
    "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",
    "updated_at": "2024-01-20T15:45:00Z"
  }
}