Registration Content V2

Overview

The V2 Registration Content API provides a data-driven approach to creating tax registrations. Use these endpoints to discover what’s available and what’s required before creating a registration. The V2 content system adds several capabilities over V1:

Supported regions — Discover which regions (US, EU, Canada, UK) are available and get pre-built jurisdiction filters
Registration conditions — Query prerequisite, mutual exclusivity, and member country requirements
Tax type details — Get descriptions and recommendations for each tax type
Portal field hints — Credential fields now include optional helper_text for UI display guidance

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

Workflow

Search available jurisdictions

Use Available Jurisdictions to find jurisdictions where you can register. Filter by country, state, or jurisdiction type.

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/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 Available Registrations to get registration_tax_type_id, tax type options, and frequency options for your selected jurisdictions.

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

Check conditions (if applicable)

For trade bloc registrations (EU OSS, IOSS), use Registration Conditions to understand prerequisites and conflicts.

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/content/registration-conditions' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{"registration_tax_type_id": "REG_TRADEBLOC_EU_3000_UOSS_VAT"}'

Get portal requirements

Use Portal Fields to get the credential fields needed for automated filing.

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

Create registration

Use Create Registration V2 with the registration_tax_type_id from step 2.

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

API endpoints

Endpoint	Description
`GET /registrations/v2/content/supported-regions`	Get supported regions and their jurisdiction filters
`POST /registrations/v2/content/available-jurisdictions`	Search for jurisdictions where you can register
`POST /registrations/v2/content/available-registrations`	Get registration options for jurisdictions
`POST /registrations/v2/content/registration-conditions`	Get conditions for a registration type
`POST /registrations/v2/content/portal-fields`	Get portal credential requirements
`POST /registrations/v2/content/tax-type-details`	Get tax type descriptions

Tax Registrations V2 Overview — Full V2 registration workflow and concepts
Create Registration V2 — Create a registration using V2 content IDs

Registration form data Get Supported Regions

Get Started

Registrations

Registrations V2

Corporations

Tax Calculations

Transactions

Address Requirements

Registration Thresholds

Products

Customers

Exemption Certificates

Exemptions

Files

Credentials

Locations

Filings

Webhooks

Overview

Workflow

API endpoints

​Overview

​Workflow

​API endpoints

​Related

Overview

Workflow

API endpoints

Related