Skip to main content
POST
/
api
/
v1
/
registrations
/
v2
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": "550e8400-e29b-41d4-a716-446655440000",
    "registration_tax_type_id": "REG_STATE_CEN_06_RST",
    "tax_types": ["RST", "DTT"],
    "frequencies": ["QUARTERLY"],
    "effective_start_date": "2024-01-01"
  }'

{
  "message": "Registration created successfully.",
  "data": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "corporation_id": "550e8400-e29b-41d4-a716-446655440000",
    "registration_tax_type_id": "REG_STATE_CEN_06_RST",
    "tax_types": ["RST", "DTT"],
    "frequencies": ["QUARTERLY"],
    "jurisdiction_id": "JUR_US_STATE_CA",
    "jurisdiction_name": "California",
    "jurisdiction_type": "STATE_OR_PROVINCE",
    "registration_name": "Sales and Use Tax",
    "effective_start_date": "2024-01-01",
    "registered_by": "COMMENDA",
    "managed_filing_enabled": false,
    "registration_status": "PENDING",
    "validation_status": "PENDING",
    "created_at": "2024-01-15T10:30:00Z"
  }
}
Create a registration to enable tax calculations and automated filing for a jurisdiction. Before calling this endpoint, use the V2 content endpoints to discover available jurisdictions and get the required registration_tax_type_id.

​
Request body

​
corporation_id
string
required
The unique identifier (UUID) for the corporation.
​
registration_tax_type_id
string
required
The content ID identifying the jurisdiction and tax type combination. Obtain this from the Available Registrations endpoint.Example: "REG_STATE_CEN_06_RST" (California Retail Sales Tax)
​
tax_types
array
required
Array of tax types to register for. Must be valid for the selected registration_tax_type_id.Include the primary tax type and all required related types (where optional: false in the content response). Minimum 1, maximum 100 items.Example: ["RST", "DTT"]
​
frequencies
array
Array of filing frequencies. Must exactly match one of the allowed frequency combinations from the content response.Maximum 100 items. This field is optional — if omitted, the registration is created without a filing frequency set.Example: ["QUARTERLY"] or ["QUARTERLY", "ANNUAL_RECONCILIATION"]
​
effective_start_date
string
ISO date (YYYY-MM-DD) when the registration became or becomes effective.
​
registered_by
string
Who is creating this registration. Defaults to COMMENDA if not provided.Values: COMMENDA, API, USER
​
tax_registration_number
string
Your tax registration ID, permit number, or account number issued by the tax authority.
​
credential_id
string
Reference to stored portal credentials (UUID). Can be added later via update.
​
managed_filing_enabled
boolean
Set to true to enable Commenda-managed filing for this registration. When enabled, Commenda handles the filing process on your behalf. Defaults to false.
​
member_state_registration_id
string
UUID of an existing active domestic registration. Required for Union OSS registrations that have a PREREQUISITE_REGISTRATION condition.The referenced registration must belong to the same corporation and be in an EU country where your business has a qualifying establishment.
​
registered_through_registration_tax_type_id
string
Content ID of the member country to register through. Required for registrations with a MEMBER_COUNTRY_TO_REGISTER_THROUGH condition (Non-Union OSS, IOSS).Example: "REG_COUNTRY_DE_3001_VAT"

​
Validation rules

RuleDescription
Tax typesMust include all mandatory types and only allowed types for the content ID
FrequenciesIf provided, must exactly match one allowed frequency combination
Duplicate preventionOnly one active (non-archived) registration per registration_tax_type_id per corporation
ConditionsPrerequisites must be met, mutually exclusive registrations must not be active

​
EU establishment rules

For EU trade bloc registrations, additional establishment checks are enforced automatically:
SchemeRequirement
Union OSSYour business must have a qualifying EU establishment in the same country as the member state registration
Non-Union OSSYour business must not have any qualifying EU establishment
Qualifying establishment types: headquarters, branch office, warehouse, factory, retail location, dependent agent. 
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": "550e8400-e29b-41d4-a716-446655440000",
    "registration_tax_type_id": "REG_STATE_CEN_06_RST",
    "tax_types": ["RST", "DTT"],
    "frequencies": ["QUARTERLY"],
    "effective_start_date": "2024-01-01"
  }'

{
  "message": "Registration created successfully.",
  "data": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "corporation_id": "550e8400-e29b-41d4-a716-446655440000",
    "registration_tax_type_id": "REG_STATE_CEN_06_RST",
    "tax_types": ["RST", "DTT"],
    "frequencies": ["QUARTERLY"],
    "jurisdiction_id": "JUR_US_STATE_CA",
    "jurisdiction_name": "California",
    "jurisdiction_type": "STATE_OR_PROVINCE",
    "registration_name": "Sales and Use Tax",
    "effective_start_date": "2024-01-01",
    "registered_by": "COMMENDA",
    "managed_filing_enabled": false,
    "registration_status": "PENDING",
    "validation_status": "PENDING",
    "created_at": "2024-01-15T10:30:00Z"
  }
}