Get Registration Options

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

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

{
  "filters": {
    "jurisdiction_ids": ["JUR_US_STATE_CA"]
  }
}

{
  "filters": {
    "jurisdiction_ids": ["JUR_US_STATE_CA", "JUR_US_STATE_TX", "JUR_US_STATE_NY"]
  }
}

{
  "data": {
    "options": [
      {
        "jurisdiction_id": "JUR_US_STATE_CA",
        "jurisdiction_name": "California",
        "registrations": [
          {
            "registration_content_id": "CCT_US_STATE_CEN_06_RST",
            "tax_type": "RST",
            "frequencies": ["MONTHLY", "QUARTERLY", "ANNUAL_CALENDAR_YEAR"],
            "related_tax_types": [
              {
                "tax_type": "DTT",
                "optional": false
              }
            ]
          },
          {
            "registration_content_id": "CCT_US_STATE_CEN_06_RUT",
            "tax_type": "RUT",
            "frequencies": ["MONTHLY", "QUARTERLY", "ANNUAL_CALENDAR_YEAR"],
            "related_tax_types": [
              {
                "tax_type": "DTT",
                "optional": false
              }
            ]
          }
        ]
      },
      {
        "jurisdiction_id": "JUR_US_STATE_TX",
        "jurisdiction_name": "Texas",
        "registrations": [
          {
            "registration_content_id": "CCT_US_STATE_CEN_48_RST",
            "tax_type": "RST",
            "frequencies": ["MONTHLY", "QUARTERLY", "ANNUAL_CALENDAR_YEAR"]
          }
        ]
      }
    ]
  }
}

{
  "message": "Invalid request.",
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Missing required field",
    "detail": "filters.jurisdiction_ids is required",
    "status": 400,
    "instance": "/api/v1/registrations/content/registration-input-options"
  }
}

POST

api

registrations

content

registration-input-options

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

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

{
  "filters": {
    "jurisdiction_ids": ["JUR_US_STATE_CA"]
  }
}

{
  "filters": {
    "jurisdiction_ids": ["JUR_US_STATE_CA", "JUR_US_STATE_TX", "JUR_US_STATE_NY"]
  }
}

{
  "data": {
    "options": [
      {
        "jurisdiction_id": "JUR_US_STATE_CA",
        "jurisdiction_name": "California",
        "registrations": [
          {
            "registration_content_id": "CCT_US_STATE_CEN_06_RST",
            "tax_type": "RST",
            "frequencies": ["MONTHLY", "QUARTERLY", "ANNUAL_CALENDAR_YEAR"],
            "related_tax_types": [
              {
                "tax_type": "DTT",
                "optional": false
              }
            ]
          },
          {
            "registration_content_id": "CCT_US_STATE_CEN_06_RUT",
            "tax_type": "RUT",
            "frequencies": ["MONTHLY", "QUARTERLY", "ANNUAL_CALENDAR_YEAR"],
            "related_tax_types": [
              {
                "tax_type": "DTT",
                "optional": false
              }
            ]
          }
        ]
      },
      {
        "jurisdiction_id": "JUR_US_STATE_TX",
        "jurisdiction_name": "Texas",
        "registrations": [
          {
            "registration_content_id": "CCT_US_STATE_CEN_48_RST",
            "tax_type": "RST",
            "frequencies": ["MONTHLY", "QUARTERLY", "ANNUAL_CALENDAR_YEAR"]
          }
        ]
      }
    ]
  }
}

{
  "message": "Invalid request.",
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Missing required field",
    "detail": "filters.jurisdiction_ids is required",
    "status": 400,
    "instance": "/api/v1/registrations/content/registration-input-options"
  }
}

Retrieve the registration options for one or more jurisdictions. This endpoint returns the registration_content_id you’ll need to create a registration, along with available tax types and filing frequencies.

Request Body

object

required

array

required

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

Response Fields

Field	Type	Description
`options`	array	Registration options for each jurisdiction
`options[].jurisdiction_id`	string	The jurisdiction ID
`options[].jurisdiction_name`	string	Human-readable name
`options[].registrations`	array	Available registration types
`options[].registrations[].registration_content_id`	string	Content ID to use when creating a registration
`options[].registrations[].tax_type`	string	Primary tax type for this registration
`options[].registrations[].frequencies`	array	Valid filing frequencies
`options[].registrations[].related_tax_types`	array	Additional tax types that can/must be included

Some jurisdictions require or allow multiple tax types to be registered together:

optional: false — This tax type must be included with the primary type
optional: true — This tax type may be included (your choice)

For example, California requires RST + DTT together, while some states allow RST alone.

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

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

{
  "filters": {
    "jurisdiction_ids": ["JUR_US_STATE_CA"]
  }
}

{
  "filters": {
    "jurisdiction_ids": ["JUR_US_STATE_CA", "JUR_US_STATE_TX", "JUR_US_STATE_NY"]
  }
}

{
  "data": {
    "options": [
      {
        "jurisdiction_id": "JUR_US_STATE_CA",
        "jurisdiction_name": "California",
        "registrations": [
          {
            "registration_content_id": "CCT_US_STATE_CEN_06_RST",
            "tax_type": "RST",
            "frequencies": ["MONTHLY", "QUARTERLY", "ANNUAL_CALENDAR_YEAR"],
            "related_tax_types": [
              {
                "tax_type": "DTT",
                "optional": false
              }
            ]
          },
          {
            "registration_content_id": "CCT_US_STATE_CEN_06_RUT",
            "tax_type": "RUT",
            "frequencies": ["MONTHLY", "QUARTERLY", "ANNUAL_CALENDAR_YEAR"],
            "related_tax_types": [
              {
                "tax_type": "DTT",
                "optional": false
              }
            ]
          }
        ]
      },
      {
        "jurisdiction_id": "JUR_US_STATE_TX",
        "jurisdiction_name": "Texas",
        "registrations": [
          {
            "registration_content_id": "CCT_US_STATE_CEN_48_RST",
            "tax_type": "RST",
            "frequencies": ["MONTHLY", "QUARTERLY", "ANNUAL_CALENDAR_YEAR"]
          }
        ]
      }
    ]
  }
}

{
  "message": "Invalid request.",
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Missing required field",
    "detail": "filters.jurisdiction_ids is required",
    "status": 400,
    "instance": "/api/v1/registrations/content/registration-input-options"
  }
}

Using the Response

From the response, extract:

registration_content_id — Use this when calling POST /registrations
tax_type + related_tax_types — Combine to form the tax_types array
frequencies — Pick one for the frequency field

Example: Creating a California Registration

From the response above, California requires RST + DTT:

{
  "corporation_id": "your-corporation-id",
  "registration_content_id": "CCT_US_STATE_CEN_06_RST",
  "tax_types": ["RST", "DTT"],
  "frequency": "QUARTERLY"
}

Next Steps

After getting registration options, use the Portal Fields endpoint to understand what credentials are needed for automated filing. Then Create a Registration using the registration_content_id from this response.

List Available Jurisdictions — Find jurisdictions first
Registration Content Overview — Full content API workflow

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 Fields

Using the Response

Example: Creating a California Registration

Next Steps

​Request Body

​Response Fields

​Related Tax Types

​Using the Response

​Example: Creating a California Registration

​Next Steps

​Related

Request Body

Response Fields

Related Tax Types

Using the Response

Example: Creating a California Registration

Next Steps

Related