Get a filing

Returns full filing details including amounts, status history, blocked reasons, and linked payroll runs.

GET /v1/statutory/filings/{filing_id}

Get a filing

cURL

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

200

{
  "id": "fil_01HQ3K4N7XYZABC",
  "businessId": "biz_01HQ3K4N7XYZABC",
  "countryCode": "MX",
  "filingTypeId": "ft_mx_isr_monthly",
  "filingTypeName": "ISR Withholding",
  "authorityId": "auth_mx_sat",
  "authorityName": "SAT",
  "status": "pending",
  "period": {
    "start": "2026-01-01",
    "end": "2026-01-31",
    "label": "January 2026"
  },
  "dueAt": "2026-02-10",
  "amounts": {
    "currency": "MXN",
    "totalTax": 45000,
    "employerContributions": 20000,
    "employeeDeductions": 25000,
    "lineItems": [
      {
        "description": "ISR - Withholding per Artículo 96 table",
        "amount": 12500
      }
    ]
  },
  "workerCount": 15,
  "personIds": [
    "per_01ABC",
    "per_02DEF",
    "per_03GHI"
  ],
  "payrollRunIds": [
    "<string>"
  ],
  "blockedReasons": [
    "Missing worker RFC for per_01ABC",
    "Business IMSS registration not found"
  ],
  "statusHistory": [
    {
      "from": "pending",
      "to": "in_review",
      "timestamp": 1709654400
    }
  ],
  "createdAt": 1709280000,
  "updatedAt": 1709280000
}

Authorizations

Authorization · string · header · required

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

Path Parameters

filing_id · string · required

Filing identifier

Response

200

application/json

Filing details

Full filing detail returned by GET /v1/statutory/filings/{id}. Includes amounts, status history, and linked payroll runs.

id · string

Example:

"fil_01HQ3K4N7XYZABC"

businessId · string

Example:

"biz_01HQ3K4N7XYZABC"

countryCode · string

Example:

"MX"

filingTypeId · string

Filing type identifier (from jurisdiction filing types)

Example:

"ft_mx_isr_monthly"

filingTypeName · string

Human-readable filing type name

Example:

"ISR Withholding"

authorityId · string

Government authority identifier

Example:

"auth_mx_sat"

authorityName · string

Government authority name

Example:

"SAT"

status · enum<string>

Filing lifecycle: pending → in_review → approved → submitted → accepted. Filings can become blocked at pending or in_review if data is missing, and return to pending once resolved. Rejected filings return to pending for correction. Any pre-submit state can be cancelled.

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

period · object

Show child attributes

dueAt · string

Deadline for submission to the authority

Example:

"2026-02-10"

amounts · object

Financial breakdown of the filing

Show child attributes

workerCount · integer

Number of workers included in this filing

Example:

15

personIds · string[]

Person IDs included in this filing

Example:

["per_01ABC", "per_02DEF", "per_03GHI"]

payrollRunIds · string[]

Linked Cadana payroll runs (when using Cadana payroll mode)

blockedReasons · string[]

Human-readable reasons why this filing is blocked. Present when status is blocked. Reasons auto-clear when the underlying data is submitted.

Example:

[
  "Missing worker RFC for per_01ABC",
  "Business IMSS registration not found"
]

statusHistory · object[]

Show child attributes

createdAt · number<epoch>

Unix epoch timestamp

Example:

1709280000

updatedAt · number<epoch>

Unix epoch timestamp

Example:

1709280000