Get Available Registrations

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

{
  "jurisdiction_ids": ["JUR_US_STATE_CA"]
}

{
  "jurisdiction_ids": ["JUR_US_STATE_CA", "JUR_US_STATE_TX", "TRADEBLOC_EU_3000"]
}

{
  "data": {
    "registrations": [
      {
        "registration_id": "REG_STATE_CEN_06",
        "jurisdiction_id": "JUR_US_STATE_CA",
        "jurisdiction_name": "California",
        "jurisdiction_type": "STATE_OR_PROVINCE",
        "registration_name": "Sales and Use Tax",
        "tax_type_options": [
          {
            "registration_tax_type_id": "REG_STATE_CEN_06_RST",
            "tax_types": {
              "primary": "RST",
              "related": [
                { "value": "DTT", "optional": false }
              ]
            },
            "is_default": true,
            "effective_start_date": "2024-01-01",
            "portal_ids": ["PORTAL_CA_CDTFA"],
            "frequencies": [
              {
                "primary": "MONTHLY",
                "related": []
              },
              {
                "primary": "QUARTERLY",
                "related": []
              },
              {
                "primary": "ANNUAL_CALENDAR_YEAR",
                "related": []
              }
            ]
          }
        ]
      }
    ]
  }
}

{
  "message": "Failed to parse request body.",
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Failed to validate the request body",
    "detail": "jurisdiction_ids is required",
    "status": 400,
    "instance": "/api/v1/registrations/v2/content/available-registrations"
  }
}

{
  "message": "Failed to parse request body.",
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Failed to validate the request body",
    "detail": "jurisdiction_ids must contain at most 100 items",
    "status": 400,
    "instance": "/api/v1/registrations/v2/content/available-registrations"
  }
}

POST

api

registrations

content

available-registrations

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

{
  "jurisdiction_ids": ["JUR_US_STATE_CA"]
}

{
  "jurisdiction_ids": ["JUR_US_STATE_CA", "JUR_US_STATE_TX", "TRADEBLOC_EU_3000"]
}

{
  "data": {
    "registrations": [
      {
        "registration_id": "REG_STATE_CEN_06",
        "jurisdiction_id": "JUR_US_STATE_CA",
        "jurisdiction_name": "California",
        "jurisdiction_type": "STATE_OR_PROVINCE",
        "registration_name": "Sales and Use Tax",
        "tax_type_options": [
          {
            "registration_tax_type_id": "REG_STATE_CEN_06_RST",
            "tax_types": {
              "primary": "RST",
              "related": [
                { "value": "DTT", "optional": false }
              ]
            },
            "is_default": true,
            "effective_start_date": "2024-01-01",
            "portal_ids": ["PORTAL_CA_CDTFA"],
            "frequencies": [
              {
                "primary": "MONTHLY",
                "related": []
              },
              {
                "primary": "QUARTERLY",
                "related": []
              },
              {
                "primary": "ANNUAL_CALENDAR_YEAR",
                "related": []
              }
            ]
          }
        ]
      }
    ]
  }
}

{
  "message": "Failed to parse request body.",
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Failed to validate the request body",
    "detail": "jurisdiction_ids is required",
    "status": 400,
    "instance": "/api/v1/registrations/v2/content/available-registrations"
  }
}

{
  "message": "Failed to parse request body.",
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Failed to validate the request body",
    "detail": "jurisdiction_ids must contain at most 100 items",
    "status": 400,
    "instance": "/api/v1/registrations/v2/content/available-registrations"
  }
}

Retrieve the available registration options for one or more jurisdictions. Returns structured registration data including registration_tax_type_id, parsed composite tax types, parsed composite frequencies, and associated portal IDs.

Request body

jurisdiction_ids

array

required

Array of jurisdiction IDs to get registration options for. Get these from the Available Jurisdictions endpoint.Minimum 1, maximum 100 items.Example: ["JUR_US_STATE_CA", "JUR_US_STATE_TX"]

Response structure

Each jurisdiction returns one or more registration objects. Each registration includes:

registration_tax_type_id — The content ID to use when creating a registration
tax_type_options — Available tax type combinations with parsed composite structure
frequencies — Available filing frequency combinations with parsed composite structure
portal_ids — Portal IDs for credential lookup

Composite tax types

Tax types are returned as structured objects instead of raw strings:

{
  "primary": "RST",
  "related": [
    { "value": "DTT", "optional": false }
  ]
}

optional: false — This related type must be included when creating the registration
optional: true — This related type may be included at your discretion

Composite frequencies

Frequencies follow the same structure:

{
  "primary": "QUARTERLY",
  "related": [
    { "value": "ANNUAL_RECONCILIATION", "optional": false }
  ]
}

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

{
  "jurisdiction_ids": ["JUR_US_STATE_CA"]
}

{
  "jurisdiction_ids": ["JUR_US_STATE_CA", "JUR_US_STATE_TX", "TRADEBLOC_EU_3000"]
}

{
  "data": {
    "registrations": [
      {
        "registration_id": "REG_STATE_CEN_06",
        "jurisdiction_id": "JUR_US_STATE_CA",
        "jurisdiction_name": "California",
        "jurisdiction_type": "STATE_OR_PROVINCE",
        "registration_name": "Sales and Use Tax",
        "tax_type_options": [
          {
            "registration_tax_type_id": "REG_STATE_CEN_06_RST",
            "tax_types": {
              "primary": "RST",
              "related": [
                { "value": "DTT", "optional": false }
              ]
            },
            "is_default": true,
            "effective_start_date": "2024-01-01",
            "portal_ids": ["PORTAL_CA_CDTFA"],
            "frequencies": [
              {
                "primary": "MONTHLY",
                "related": []
              },
              {
                "primary": "QUARTERLY",
                "related": []
              },
              {
                "primary": "ANNUAL_CALENDAR_YEAR",
                "related": []
              }
            ]
          }
        ]
      }
    ]
  }
}

{
  "message": "Failed to parse request body.",
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Failed to validate the request body",
    "detail": "jurisdiction_ids is required",
    "status": 400,
    "instance": "/api/v1/registrations/v2/content/available-registrations"
  }
}

{
  "message": "Failed to parse request body.",
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Failed to validate the request body",
    "detail": "jurisdiction_ids must contain at most 100 items",
    "status": 400,
    "instance": "/api/v1/registrations/v2/content/available-registrations"
  }
}

Using the response

From the response, extract:

registration_tax_type_id — Use this when calling POST /registrations/v2
tax_types — Combine primary and required related types into the tax_types array
frequencies — Pick one frequency option and pass all its components in the frequencies array
portal_ids — Use with the Portal Fields endpoint to get credential requirements

Example: creating a California registration

From the response above, California requires RST + DTT (DTT is not optional):

{
  "corporation_id": "your-corporation-id",
  "registration_tax_type_id": "REG_STATE_CEN_06_RST",
  "tax_types": ["RST", "DTT"],
  "frequencies": ["QUARTERLY"]
}

Available Jurisdictions — Find jurisdictions first
Registration Conditions — Check conditions for trade bloc registrations
Portal Fields — Get credential requirements

List Available Jurisdictions Get Registration Conditions

Get Started

Registrations

Registrations V2

Corporations

Tax Calculations

Transactions

Address Requirements

Registration Thresholds

Products

Customers

Exemption Certificates

Exemptions

Files

Credentials

Locations

Filings

Webhooks

Request body

Response structure

Composite tax types

Composite frequencies

Using the response

Example: creating a California registration

​Request body

​Response structure

​Composite tax types

​Composite frequencies

​Using the response

​Example: creating a California registration

​Related

Request body

Response structure

Composite tax types

Composite frequencies

Using the response

Example: creating a California registration

Related