List filings

Returns filings across all jurisdictions for a business. Use this as both a compliance calendar (“what’s due?”) and a filing history (“what’s done?”).

The response includes a summary object with counts by status — use this to power compliance health dashboards without additional API calls.

GET /v1/statutory/filings

List filings

cURL

curl --request GET \
  --url https://api.cadanapay.com/v1/statutory/filings \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "fil_01HQ3K4N7XYZABC",
      "businessId": "biz_01HQ3K4N7XYZABC",
      "countryCode": "MX",
      "filingTypeId": "ft_mx_isr_monthly",
      "filingTypeName": "ISR Withholding",
      "authorityName": "SAT",
      "status": "pending",
      "period": {
        "start": "2023-12-25",
        "end": "2023-12-25",
        "label": "<string>"
      },
      "dueAt": "2026-02-10",
      "workerCount": 15,
      "createdAt": 1709280000,
      "updatedAt": 1709280000
    }
  ],
  "summary": {
    "total": 123,
    "pending": 123,
    "inReview": 123,
    "approved": 123,
    "submitted": 123,
    "accepted": 123,
    "blocked": 123,
    "cancelled": 123,
    "rejected": 123
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

businessId · string

Filter by business

countryCode · string

Filter by jurisdiction (ISO 3166-1 alpha-2)

status · enum<string>

Filter by filing status

Available options: pending, blocked, in_review, approved, submitted, accepted, rejected, cancelled

Response

200 - application/json

List of filings with compliance summary

data · object[]

Show child attributes

summary · object

Status counts for the filtered set of filings. Use this to power compliance health dashboards.

Show child attributes