Skip to main content
POST
/
api
/
v1
/
registrations
/
v2
/
{tax_registration_id}
curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_registration_number": "123-456789-00",
    "credential_id": "cred_abc123def456"
  }'

{
  "message": "Registration updated successfully.",
  "data": {
    "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-02-01",
    "tax_registration_number": "123-456789-00",
    "credential_id": "cred_abc123def456",
    "registered_by": "COMMENDA",
    "registration_status": "PENDING",
    "validation_status": "PENDING",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-02-15T09:00:00Z"
  }
}
Update a V2 registration to modify tax types, frequencies, credentials, and other fields. Uses merge semantics — only fields present in the request body are updated; omitted fields keep their current values.

​
Path parameters

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

​
Request body

All fields are optional. Only the fields you provide will be updated.
​
tax_types
array
Array of tax types. Must be valid for the registration’s content ID.Minimum 1, maximum 100 items.
​
frequencies
array
Array of filing frequencies. Must exactly match one allowed frequency combination from the content.Minimum 1, maximum 100 items.
​
effective_start_date
string
ISO date (YYYY-MM-DD) when the registration became or becomes effective. Pass an empty string to clear the value.
​
tax_registration_number
string
Your tax registration ID or permit number. Pass an empty string to clear the value.
​
credential_id
string
Reference to stored portal credentials (UUID). Pass an empty string to clear the value.
​
registered_by
string
Who created the registration.Values: COMMENDA, API, USER

​
Validation rules

When updating tax_types or frequencies, the new values are re-validated against the registration’s content:
  • Tax types must include all mandatory types and only allowed types
  • Frequencies must exactly match one allowed frequency combination
curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "tax_registration_number": "123-456789-00",
    "credential_id": "cred_abc123def456"
  }'

{
  "message": "Registration updated successfully.",
  "data": {
    "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-02-01",
    "tax_registration_number": "123-456789-00",
    "credential_id": "cred_abc123def456",
    "registered_by": "COMMENDA",
    "registration_status": "PENDING",
    "validation_status": "PENDING",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-02-15T09:00:00Z"
  }
}