Update Registration

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

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{"frequency": "MONTHLY"}'

{
  "tax_registration_id": "123-456789-00",
  "portal_id": "PORTAL_CA_CDTFA",
  "credential_id": "cred_abc123def456"
}

{
  "frequency": "MONTHLY"
}

{
  "tax_types": ["RST", "DTT"],
  "frequency": "QUARTERLY",
  "effective_start_date": "2024-02-01",
  "tax_registration_id": "123-456789-NEW"
}

{
  "message": "Successfully updated registration."
}

{
  "error": {
    "type": "REGISTRATION_INVALID_TAX_TYPE",
    "title": "Invalid tax type for this jurisdiction.",
    "detail": "Tax type 'XYZ' is not valid for California. Valid options: RST, RUT, DTT.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "REGISTRATION_INVALID_FREQUENCY",
    "title": "Invalid frequency for this jurisdiction.",
    "detail": "Frequency 'WEEKLY' is not valid for California. Valid options: MONTHLY, QUARTERLY, ANNUAL_CALENDAR_YEAR.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "REGISTRATION_INVALID_PORTAL_ID",
    "title": "Invalid portal for this registration.",
    "detail": "Portal 'INVALID_PORTAL' is not valid for this registration content.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "TAX_TYPE_MISMATCH_WITH_PARENT",
    "title": "Tax types must match parent state registration.",
    "detail": "Local registration tax types [RUT, DTT] do not match parent California state registration tax types [RST, DTT].",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "FREQUENCY_MISMATCH_WITH_PARENT",
    "title": "Frequency must match parent state.",
    "detail": "Frequency 'MONTHLY' does not match the parent state registration frequency 'QUARTERLY'.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "TAX_TYPE_MISMATCH_WITH_PARENT",
    "title": "Tax type not registered at state level.",
    "detail": "Tax type 'RUT' is not registered at the state level. State tax types: [RST, DTT].",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "TAX_TYPE_MISMATCH_WITH_PARENT",
    "title": "Missing required tax type from state.",
    "detail": "Tax type 'DTT' from the state registration must be included.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Invalid effective_start_date format.",
    "detail": "Date must be in ISO format (YYYY-MM-DD).",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "REGISTRATION_NOT_FOUND",
    "title": "Registration not found.",
    "status": 404,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

POST

api

registrations

{registration_id}

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

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{"frequency": "MONTHLY"}'

{
  "tax_registration_id": "123-456789-00",
  "portal_id": "PORTAL_CA_CDTFA",
  "credential_id": "cred_abc123def456"
}

{
  "frequency": "MONTHLY"
}

{
  "tax_types": ["RST", "DTT"],
  "frequency": "QUARTERLY",
  "effective_start_date": "2024-02-01",
  "tax_registration_id": "123-456789-NEW"
}

{
  "message": "Successfully updated registration."
}

{
  "error": {
    "type": "REGISTRATION_INVALID_TAX_TYPE",
    "title": "Invalid tax type for this jurisdiction.",
    "detail": "Tax type 'XYZ' is not valid for California. Valid options: RST, RUT, DTT.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "REGISTRATION_INVALID_FREQUENCY",
    "title": "Invalid frequency for this jurisdiction.",
    "detail": "Frequency 'WEEKLY' is not valid for California. Valid options: MONTHLY, QUARTERLY, ANNUAL_CALENDAR_YEAR.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "REGISTRATION_INVALID_PORTAL_ID",
    "title": "Invalid portal for this registration.",
    "detail": "Portal 'INVALID_PORTAL' is not valid for this registration content.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "TAX_TYPE_MISMATCH_WITH_PARENT",
    "title": "Tax types must match parent state registration.",
    "detail": "Local registration tax types [RUT, DTT] do not match parent California state registration tax types [RST, DTT].",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "FREQUENCY_MISMATCH_WITH_PARENT",
    "title": "Frequency must match parent state.",
    "detail": "Frequency 'MONTHLY' does not match the parent state registration frequency 'QUARTERLY'.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "TAX_TYPE_MISMATCH_WITH_PARENT",
    "title": "Tax type not registered at state level.",
    "detail": "Tax type 'RUT' is not registered at the state level. State tax types: [RST, DTT].",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "TAX_TYPE_MISMATCH_WITH_PARENT",
    "title": "Missing required tax type from state.",
    "detail": "Tax type 'DTT' from the state registration must be included.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Invalid effective_start_date format.",
    "detail": "Date must be in ISO format (YYYY-MM-DD).",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "REGISTRATION_NOT_FOUND",
    "title": "Registration not found.",
    "status": 404,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

Update a registration to add or modify tax types, frequency, credentials, and other configuration. Use this endpoint to complete a registration before requesting validation.

To find valid portal IDs for your registration, use the Portal Fields endpoint.

Cascade behavior: When updating tax_types or frequency on a state registration, the changes automatically cascade to all local registrations (cities, counties, districts) under that state.

Path Parameters

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; other fields remain unchanged.

array

Array of tax types to register for. Must be valid for the registration’s jurisdiction.Values: RST, RUT, DTT, SST, etc.

For local jurisdictions (cities, counties), tax types must match the parent state registration.

string

Filing frequency for this registration.Values: MONTHLY, QUARTERLY, SEMI_ANNUALLY, ANNUAL_CALENDAR_YEAR, FISCAL_YEAR, QUARTERLY_PREPAY_MONTHLY, MONTHLY_ACCELERATED_PREPAY_EARLY

string

ISO date (YYYY-MM-DD) when the registration became or becomes effective.

string

Your state-issued tax registration ID, permit number, or account number.

string

Reference to stored portal credentials for automated filing.

string

The portal ID for the state’s tax filing portal. Must be a valid portal for the registration’s content.

Common Workflows

Adding Credentials Before Validation

After creating a registration, add the credentials needed for automated filing:

{
  "tax_registration_id": "123-456789-00",
  "portal_id": "PORTAL_CA_CDTFA",
  "credential_id": "cred_abc123def456"
}

Changing Filing Frequency

Update the frequency before the next filing period:

{
  "frequency": "MONTHLY"
}

Updating Tax Types

Switch between valid tax type combinations:

{
  "tax_types": ["RUT", "DTT"]
}

Validation Rules

Tax types: Must be valid for the jurisdiction. You can switch between valid combinations (e.g., RST+DTT to RUT+DTT).
Frequency: Must be one of the frequencies allowed for the jurisdiction.
Portal ID: Must be a valid portal for the registration’s content.
Date format: effective_start_date must be in YYYY-MM-DD format.

State vs. Local Update Behavior

Registration Type	`tax_types` / `frequency` Update	Effect
State	Allowed	Cascades to all local registrations under this state
Local	Allowed only if matches parent state	Updates only the local registration

If you need to change tax types or frequency for local registrations, update the parent state registration instead—the change will automatically cascade to all locals.

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

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{"frequency": "MONTHLY"}'

{
  "tax_registration_id": "123-456789-00",
  "portal_id": "PORTAL_CA_CDTFA",
  "credential_id": "cred_abc123def456"
}

{
  "frequency": "MONTHLY"
}

{
  "tax_types": ["RST", "DTT"],
  "frequency": "QUARTERLY",
  "effective_start_date": "2024-02-01",
  "tax_registration_id": "123-456789-NEW"
}

{
  "message": "Successfully updated registration."
}

{
  "error": {
    "type": "REGISTRATION_INVALID_TAX_TYPE",
    "title": "Invalid tax type for this jurisdiction.",
    "detail": "Tax type 'XYZ' is not valid for California. Valid options: RST, RUT, DTT.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "REGISTRATION_INVALID_FREQUENCY",
    "title": "Invalid frequency for this jurisdiction.",
    "detail": "Frequency 'WEEKLY' is not valid for California. Valid options: MONTHLY, QUARTERLY, ANNUAL_CALENDAR_YEAR.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "REGISTRATION_INVALID_PORTAL_ID",
    "title": "Invalid portal for this registration.",
    "detail": "Portal 'INVALID_PORTAL' is not valid for this registration content.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "TAX_TYPE_MISMATCH_WITH_PARENT",
    "title": "Tax types must match parent state registration.",
    "detail": "Local registration tax types [RUT, DTT] do not match parent California state registration tax types [RST, DTT].",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "FREQUENCY_MISMATCH_WITH_PARENT",
    "title": "Frequency must match parent state.",
    "detail": "Frequency 'MONTHLY' does not match the parent state registration frequency 'QUARTERLY'.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "TAX_TYPE_MISMATCH_WITH_PARENT",
    "title": "Tax type not registered at state level.",
    "detail": "Tax type 'RUT' is not registered at the state level. State tax types: [RST, DTT].",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "TAX_TYPE_MISMATCH_WITH_PARENT",
    "title": "Missing required tax type from state.",
    "detail": "Tax type 'DTT' from the state registration must be included.",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Invalid effective_start_date format.",
    "detail": "Date must be in ISO format (YYYY-MM-DD).",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

{
  "error": {
    "type": "REGISTRATION_NOT_FOUND",
    "title": "Registration not found.",
    "status": 404,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }
}

Get Started

Registrations

Registrations V2

Corporations

Tax Calculations

Transactions

Address Requirements

Registration Thresholds

Products

Customers

Exemption Certificates

Exemptions

Files

Credentials

Locations

Filings

Webhooks

Path Parameters

Request Body

Common Workflows

Adding Credentials Before Validation

Changing Filing Frequency

Updating Tax Types

Validation Rules

State vs. Local Update Behavior

​Path Parameters

​Request Body

​Common Workflows

​Adding Credentials Before Validation

​Changing Filing Frequency

​Updating Tax Types

​Validation Rules

​State vs. Local Update Behavior

Path Parameters

Request Body

Common Workflows

Adding Credentials Before Validation

Changing Filing Frequency

Updating Tax Types

Validation Rules

State vs. Local Update Behavior