Get a remittance

Returns full remittance details including payment status, FX conversion information, and proof of payment (when available).

GET /v1/statutory/remittances/{remittance_id}

Get a remittance

cURL

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

200

{
  "id": "rem_01HQ3K4N7XYZABC",
  "businessId": "<string>",
  "filingIds": [
    "<string>"
  ],
  "countryCode": "MX",
  "authorityId": "auth_mx_sat",
  "authorityName": "SAT",
  "status": "pending",
  "amount": 45000,
  "fxRate": 18.001,
  "fundedCurrency": "USD",
  "fundedAmount": 2571.43,
  "paymentMethod": "local_rails",
  "paymentReference": "SAT-2026-01-RFC-XAXX010101000-ISR",
  "receiptUrl": "<string>",
  "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

remittance_id · string · required

Remittance identifier

Response

200

application/json

Remittance details

Full remittance detail returned by GET /v1/statutory/remittances/{id}. Includes FX conversion details, payment tracking, and status history.

id · string

Example:

"rem_01HQ3K4N7XYZABC"

businessId · string

filingIds · string[]

Filings this remittance covers

countryCode · string

Example:

"MX"

authorityId · string

Government authority identifier

Example:

"auth_mx_sat"

authorityName · string

Government authority name

Example:

"SAT"

status · enum<string>

pending ──→ processing ──→ completed
                │
                ▼
              failed

Available options: pending, processing, completed, failed

amount · number<decimal>

Amount in local currency to be paid to the authority

Example:

45000

fxRate · number<decimal>

FX rate applied (if funded in a different currency)

Example:

18.001

fundedCurrency · string

Currency the business funded from

Example:

"USD"

fundedAmount · number<decimal>

Amount debited from the business balance

Example:

2571.43

paymentMethod · string

How payment was made to the authority

Example:

"local_rails"

paymentReference · string | null

Government-issued payment reference number

Example:

"SAT-2026-01-RFC-XAXX010101000-ISR"

receiptUrl · string | null

Proof of payment document URL

statusHistory · object[]

Show child attributes

createdAt · number<epoch>

Unix epoch timestamp

Example:

1709280000

updatedAt · number<epoch>

Unix epoch timestamp

Example:

1709280000