Skip to main content
POST
/
api
/
v1
/
registrations
/
v2
/
content
/
tax-type-details
curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/content/tax-type-details' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "jurisdiction_ids": ["JUR_US_STATE_CA"]
  }'
{
  "data": {
    "tax_type_details": [
      {
        "jurisdiction_id": "JUR_US_STATE_CA",
        "tax_type": "RST",
        "official_name": "Retail Sales Tax",
        "display_name": "Sales Tax",
        "short_description": "Tax on retail sales of tangible personal property",
        "full_description": "California imposes a sales tax on retailers for the privilege of selling tangible personal property at retail.",
        "recommended_for": ["B2C", "SaaS"]
      }
    ]
  }
}
Retrieve detailed descriptions and recommendations for tax types available in specific jurisdictions. Use this to help users understand which tax type to select when creating a registration.

Request body

jurisdiction_ids
array
required
Array of jurisdiction IDs to get tax type details for.Minimum 1, maximum 100 items.Example: ["JUR_US_STATE_CA"]
curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/content/tax-type-details' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "jurisdiction_ids": ["JUR_US_STATE_CA"]
  }'
{
  "data": {
    "tax_type_details": [
      {
        "jurisdiction_id": "JUR_US_STATE_CA",
        "tax_type": "RST",
        "official_name": "Retail Sales Tax",
        "display_name": "Sales Tax",
        "short_description": "Tax on retail sales of tangible personal property",
        "full_description": "California imposes a sales tax on retailers for the privilege of selling tangible personal property at retail.",
        "recommended_for": ["B2C", "SaaS"]
      }
    ]
  }
}

Response fields

FieldTypeDescription
jurisdiction_idstringThe jurisdiction these details apply to
tax_typestringTax type code (e.g., RST, VAT)
official_namestringOfficial name of the tax type
display_namestringShorter display name
short_descriptionstringBrief description (may be null)
full_descriptionstringDetailed description of the tax type
recommended_forarrayBusiness types this tax type is recommended for (may be empty)