Skip to main content

​
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

1

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"]}}'
2

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"]}'
3

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"}'
4

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"]}'
5

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

EndpointDescription
GET /registrations/v2/content/supported-regionsGet supported regions and their jurisdiction filters
POST /registrations/v2/content/available-jurisdictionsSearch for jurisdictions where you can register
POST /registrations/v2/content/available-registrationsGet registration options for jurisdictions
POST /registrations/v2/content/registration-conditionsGet conditions for a registration type
POST /registrations/v2/content/portal-fieldsGet portal credential requirements
POST /registrations/v2/content/tax-type-detailsGet tax type descriptions