Skip to main content
GET
/
v1
/
statutory
/
filings
List filings
curl --request GET \
  --url https://api.cadanapay.com/v1/statutory/filings \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "fil_01HQ3K4N7XYZABC",
      "businessId": "biz_01HQ3K4N7XYZABC",
      "countryCode": "MX",
      "filingType": {
        "id": "ft_mx_isr_monthly",
        "name": "ISR Withholding",
        "description": "ISR income tax withholding return filed monthly with SAT",
        "governmentFormName": "Declaración Provisional ISR",
        "authority": {
          "id": "auth_mx_sat",
          "name": "Servicio de Administración Tributaria",
          "abbreviation": "SAT",
          "countryCode": "MX",
          "electronicSystem": "Portal del SAT"
        },
        "frequency": "MONTHLY",
        "dueDay": 10,
        "includesRemittance": true,
        "legislativeReference": "Ley del Impuesto Sobre la Renta (LISR), Artículo 96"
      },
      "status": "upcoming",
      "period": {
        "start": "2026-01-01",
        "end": "2026-01-31",
        "label": "January 2026"
      },
      "dueAt": "2026-02-10T23:59:59Z",
      "filedAt": "2023-11-07T05:31:56Z",
      "amounts": {
        "currency": "MXN",
        "totalTax": 45000,
        "employerContributions": 20000,
        "employeeDeductions": 25000,
        "penalties": 0,
        "lineItems": [
          {
            "description": "ISR - Withholding per Artículo 96 table",
            "amount": 12500,
            "legislativeReference": "LISR, Artículo 96, Tabla mensual"
          }
        ]
      },
      "blockedReasons": [
        {
          "code": "missing_tax_id",
          "message": "SAT RFC (Registro Federal de Contribuyentes) is required for the business",
          "requirementId": "req_01HQ3K4N7XYZABC",
          "resourceType": "business",
          "resourceId": "<string>",
          "affectedField": "taxId"
        }
      ],
      "personIds": [
        "per_01ABC",
        "per_02DEF",
        "per_03GHI"
      ],
      "remittanceId": "<string>",
      "amends": "<string>",
      "amendedBy": "<string>",
      "document": {
        "url": "<string>",
        "generatedAt": "2023-11-07T05:31:56Z"
      },
      "statusHistory": [
        {
          "status": "<string>",
          "changedAt": "2023-11-07T05:31:56Z",
          "actor": "<string>",
          "blockedReasons": [
            {
              "code": "missing_tax_id",
              "message": "SAT RFC (Registro Federal de Contribuyentes) is required for the business",
              "requirementId": "req_01HQ3K4N7XYZABC",
              "resourceType": "business",
              "resourceId": "<string>",
              "affectedField": "taxId"
            }
          ]
        }
      ],
      "workerCount": 15,
      "estimatedAmount": {
        "currency": "<string>",
        "amount": 123
      },
      "legislativeReferences": [
        "Ley del Impuesto Sobre la Renta (LISR), Artículo 96",
        "Resolución Miscelánea Fiscal, Regla 2.7.5.2"
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "summary": {
    "total": 123,
    "upcoming": 123,
    "dueSoon": 123,
    "overdue": 123,
    "onTrack": 123,
    "completed": 123,
    "blocked": 123
  },
  "pagination": {
    "nextCursor": "<string>",
    "hasMore": true
  }
}

Authorizations

Authorization
string
header
required

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

Query Parameters

business_id
string
required

The business to list filings for

country_code
string

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

status
enum<string>

Filter by filing status

Available options:
upcoming,
pending,
blocked,
in_review,
approved,
submitted,
accepted,
rejected,
amended,
cancelled
filing_type_id
string

Filter by filing type

period_start
string<date>

Filter filings with period starting on or after this date

period_end
string<date>

Filter filings with period ending on or before this date

due_before
string<date-time>

Filter filings due before this timestamp

due_after
string<date-time>

Filter filings due after this timestamp

cursor
string

Pagination cursor from previous response

limit
integer
default:25

Number of items per page

Required range: 1 <= x <= 100

Response

200 - application/json

List of filings with compliance summary

data
object[]
summary
object

Aggregate compliance health for the filtered set of filings. Provides at-a-glance status counts for powering dashboard health bars.

Status categories are derived from filing status and due date:

  • upcoming — Filing in upcoming status, due date > 7 days away
  • due_soon — Filing due within 7 days (any active status)
  • overdue — Filing past due date and not yet accepted
  • on_track — Filing in active processing (pending through submitted), not overdue
  • completed — Filing accepted with remittance completed
  • blocked — Filing in blocked status
pagination
object