curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/internal/filings/bulk/delete' \
--header 'Authorization: Bearer <admin_token>' \
--header 'Content-Type: application/json' \
--data '{
"filing_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
]
}'
curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/internal/filings/bulk/delete?v2=true' \
--header 'Authorization: Bearer <admin_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
"registration_tax_type_id": "REG_STATE_CEN_06_RST",
"statuses": ["SCHEDULED", "UPCOMING"],
"due_after": "2025-06-01"
}'
{
"filing_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
]
}
{
"corporation_id": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
"registration_tax_type_id": "REG_STATE_CEN_06_RST",
"statuses": ["SCHEDULED", "UPCOMING"],
"due_after": "2025-06-01"
}
{
"deleted_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
],
"total_deleted": 2
}
Filings
Bulk delete filings
Delete filings by registration, status filters, or explicit filing IDs
DELETE
/
api
/
v1
/
internal
/
filings
/
bulk
/
delete
curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/internal/filings/bulk/delete' \
--header 'Authorization: Bearer <admin_token>' \
--header 'Content-Type: application/json' \
--data '{
"filing_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
]
}'
curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/internal/filings/bulk/delete?v2=true' \
--header 'Authorization: Bearer <admin_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
"registration_tax_type_id": "REG_STATE_CEN_06_RST",
"statuses": ["SCHEDULED", "UPCOMING"],
"due_after": "2025-06-01"
}'
{
"filing_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
]
}
{
"corporation_id": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
"registration_tax_type_id": "REG_STATE_CEN_06_RST",
"statuses": ["SCHEDULED", "UPCOMING"],
"due_after": "2025-06-01"
}
{
"deleted_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
],
"total_deleted": 2
}
Delete filings that are no longer needed. This endpoint supports three input modes:
- By filing IDs — pass an array of specific filing UUIDs to delete (works on both the legacy and V2 paths)
- V2 filter — pass
registration_tax_type_idwithstatusesand optionaldue_afterto delete matching filings (requires?v2=true) - V1 filter — pass
corporation_idandstatefor legacy filings
Filings with status
FILED cannot be deleted. Include only non-filed statuses in the statuses filter.Query parameters
boolean
Set to
true to use the V2 deletion path. Required when filtering with registration_tax_type_id. Optional when deleting by filing_ids.Request body
Option 1: delete by filing IDs
array
Array of filing UUIDs to delete. Each value must be a valid UUID. Minimum 1 entry, maximum 100 entries.Example:
["a1b2c3d4-...", "e5f6a7b8-..."]Option 2: V2 filter by registration
string
The V2 registration content ID. Deletes all filings matching the filters for this registration. Requires
?v2=true. When supplied, corporation_id is also required.array
Required when using
registration_tax_type_id. Only filings in these statuses are deleted. FILED is not allowed.Example: ["SCHEDULED", "UPCOMING"]string
Optional date filter. Only filings with a due date after this date are deleted. Format:
YYYY-MM-DD.Example: "2025-06-01"Option 3: V1 filter by state
string
The corporation UUID. Required for V1 filter mode.
string
State code. Required for V1 filter mode.
curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/internal/filings/bulk/delete' \
--header 'Authorization: Bearer <admin_token>' \
--header 'Content-Type: application/json' \
--data '{
"filing_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
]
}'
curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/internal/filings/bulk/delete?v2=true' \
--header 'Authorization: Bearer <admin_token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
"registration_tax_type_id": "REG_STATE_CEN_06_RST",
"statuses": ["SCHEDULED", "UPCOMING"],
"due_after": "2025-06-01"
}'
{
"filing_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
]
}
{
"corporation_id": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
"registration_tax_type_id": "REG_STATE_CEN_06_RST",
"statuses": ["SCHEDULED", "UPCOMING"],
"due_after": "2025-06-01"
}
{
"deleted_ids": [
"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
],
"total_deleted": 2
}
Related
- Bulk create filings — Generate filings
- Preview filings — Preview before generating
- Filings overview — Filing concepts and lifecycle
Was this page helpful?