Registration Content

Overview

The Registration Content API provides a data-driven approach to creating tax registrations. Instead of manually specifying jurisdiction details, you use these endpoints to:

Discover jurisdictions where you can register
Get registration options (tax types, frequencies) for each jurisdiction
Get portal requirements (credentials needed for automated filing)

This ensures that registrations are created with valid, up-to-date information that matches each jurisdiction’s actual requirements.

After gathering content information, use the Create Registration endpoint to create your registration.

Workflow

Search Available Jurisdictions

Use List Available Jurisdictions to find jurisdictions where you can register. Returns jurisdiction_id for each matching jurisdiction.

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/available-jurisdictions' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{"filters": {"countries": ["US"], "types": ["STATE_OR_PROVINCE"]}}'

Get Registration Options

Use Get Registration Options to get the registration_content_id, available tax_types, and frequencies for your selected jurisdictions.

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/registration-input-options' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{"filters": {"jurisdiction_ids": ["JUR_US_STATE_CA"]}}'

Get Portal Requirements

Use Get Portal Fields to get the portal credentials needed for automated filing (username, password, PIN, etc.).

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/content/portal-fields' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{"filters": {"registration_content_ids": ["CCT_US_STATE_CEN_06_RST"]}}'

Create Registration

Use Create Registration with the registration_content_id from step 2.

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "corporation_id": "your-corporation-id",
    "registration_content_id": "CCT_US_STATE_CEN_06_RST",
    "tax_types": ["RST", "DTT"],
    "frequency": "QUARTERLY"
  }'

Key Concepts

Jurisdiction IDs

Each tax jurisdiction has a unique jurisdiction_id like:

JUR_US_STATE_CA — California (state)
JUR_US_COUNTY_CA_LOS_ANGELES — Los Angeles County
JUR_US_CITY_CO_DENVER — Denver (city)