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
}
}Returns filings across all jurisdictions for a business. This is both the compliance calendar (“what’s due?”) and the filing history (“what’s done?”).
Filings in upcoming status represent future obligations — they exist because
the business has workers in a jurisdiction, but payroll hasn’t run yet for that
period. Once payroll runs or amounts are provided, they transition to pending.
The response includes a summary object with counts by status category
(upcoming, due_soon, overdue, fulfilled) — use this to power compliance
health dashboards without additional API calls.
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
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
The business to list filings for
Filter by jurisdiction (ISO 3166-1 alpha-2)
Filter by filing status
upcoming, pending, blocked, in_review, approved, submitted, accepted, rejected, amended, cancelled Filter by filing type
Filter filings with period starting on or after this date
Filter filings with period ending on or before this date
Filter filings due before this timestamp
Filter filings due after this timestamp
Pagination cursor from previous response
Number of items per page
1 <= x <= 100List of filings with compliance summary
Show child attributes
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 awaydue_soon — Filing due within 7 days (any active status)overdue — Filing past due date and not yet acceptedon_track — Filing in active processing (pending through submitted), not overduecompleted — Filing accepted with remittance completedblocked — Filing in blocked statusShow child attributes
Show child attributes