Skip to main content
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"
    ]
  }'

{
  "deleted_ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f12345678901"
  ],
  "total_deleted": 2
}

Documentation Index

Fetch the complete documentation index at: https://docs.commenda.io/llms.txt

Use this file to discover all available pages before exploring further.

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_id with statuses and optional due_after to delete matching filings (requires ?v2=true)
  • V1 filter — pass corporation_id and state for legacy filings
Filings with status FILED cannot be deleted. Include only non-filed statuses in the statuses filter.

​
Query parameters

​
v2
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

​
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

​
registration_tax_type_id
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.
​
statuses
array
Required when using registration_tax_type_id. Only filings in these statuses are deleted. FILED is not allowed.Example: ["SCHEDULED", "UPCOMING"]
​
due_after
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

​
corporation_id
string
The corporation UUID. Required for V1 filter mode.
​
state
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"
    ]
  }'

{
  "deleted_ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f12345678901"
  ],
  "total_deleted": 2
}