Use bulk endpoints to manage multiple V2 registrations at once. Each operation processes items independently — individual failures do not block the rest of the batch.
Bulk create registrations
Create multiple registrations for a corporation in one request. Each item follows the same validation rules as the single create endpoint.
POST /registrations/v2/bulk
Request body
The corporation UUID that owns the registrations.
Array of registration objects (minimum 1). Each object accepts:| Field | Type | Required | Description |
|---|
registration_tax_type_id | string | Yes | Content ID for the jurisdiction and tax type |
tax_types | string[] | Yes | Tax types to register for (minimum 1) |
frequencies | string[] | Yes | Filing frequencies (minimum 1) |
effective_start_date | string | No | ISO date (YYYY-MM-DD) |
registered_by | string | No | COMMENDA, API, or USER |
tax_registration_number | string | No | Permit or account number from the tax authority |
credential_id | string | No | UUID of stored portal credentials |
member_state_registration_id | string | No | UUID of prerequisite domestic registration (Union OSS) |
registered_through_registration_tax_type_id | string | No | Content ID for the member country (Non-Union OSS, IOSS) |
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/bulk' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"registrations": [
{
"registration_tax_type_id": "REG_STATE_CEN_06_RST",
"tax_types": ["RST", "DTT"],
"frequencies": ["QUARTERLY"],
"effective_start_date": "2024-01-01"
},
{
"registration_tax_type_id": "REG_STATE_CEN_48_RST",
"tax_types": ["RST"],
"frequencies": ["MONTHLY"]
}
]
}'
{
"message": "Bulk registration completed.",
"registrations": [
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"registration_tax_type_id": "REG_STATE_CEN_06_RST",
"status": "CREATED"
},
{
"id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"registration_tax_type_id": "REG_STATE_CEN_48_RST",
"status": "CREATED"
}
]
}
Bulk request validation
Request Commenda validation for multiple registrations at once. This triggers the same verification process as the individual validation request.
POST /registrations/v2/bulk/request-validation
Request body
Array of registration UUIDs to validate (minimum 1).
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/bulk/request-validation' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"registration_ids": [
"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"a1b2c3d4-5678-90ab-cdef-1234567890ab"
]
}'
{
"message": "Bulk validation request completed.",
"results": [
{
"registration_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"success": true
},
{
"registration_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"success": true
}
]
}
Bulk update registration status
Update the registration status for multiple registrations simultaneously.
POST /registrations/v2/bulk/registration-status
Request body
Array of registration UUIDs to update (minimum 1).
The new status to apply to all specified registrations.Values: REGISTERED, REGISTRATION_IN_PROGRESS, PENDING
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/bulk/registration-status' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"registration_ids": [
"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"a1b2c3d4-5678-90ab-cdef-1234567890ab"
],
"registration_status": "REGISTERED"
}'
{
"message": "Bulk status update completed.",
"results": [
{
"registration_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"success": true
},
{
"registration_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"success": true
}
]
}
When to use bulk operations
- Onboarding — Register a corporation across multiple jurisdictions in a single call instead of making separate requests
- Validation sweeps — Request validation for all pending registrations at once
- Status updates — Mark multiple registrations as active after receiving confirmation from tax authorities
Each item in a bulk request is processed independently. If one item fails validation (e.g., duplicate registration), the remaining items still succeed. Always check the status or success field on each result item.
