Skip to main content
GET
/
v1
/
statutory
/
remittances
/
{remittance_id}
Get a remittance
curl --request GET \
  --url https://api.cadanapay.com/v1/statutory/remittances/{remittance_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "rem_01HQ3K4N7XYZABC",
  "businessId": "<string>",
  "filingIds": [
    "<string>"
  ],
  "countryCode": "MX",
  "authorityId": "auth_mx_sat",
  "authorityName": "SAT",
  "amount": 45000,
  "fxRate": 18.001,
  "fundedCurrency": "USD",
  "fundedAmount": 2571.43,
  "paymentMethod": "local_rails",
  "paymentDetails": {
    "preferredMethod": "bank",
    "momo": {
      "accountName": "John Doe",
      "provider": "MTN",
      "providerCode": "MTN",
      "phoneNumber": {
        "countryCode": "52",
        "number": "5512345678"
      },
      "currency": "GHS"
    },
    "bank": {
      "accountName": "SAT — ISR Federal Treasury",
      "accountNumber": "012345678901234567",
      "accountType": "Checking",
      "ownerType": "business",
      "bankCode": "012",
      "bankName": "BBVA México",
      "branchName": "Sucursal Reforma",
      "sortCode": "401234",
      "iban": "GB00000000000000000000",
      "provider": "wise",
      "currency": "MXN",
      "beneficiaryId": {
        "type": "NIT",
        "value": "123456789"
      },
      "address": {
        "line1": "Av. Paseo de la Reforma 10",
        "city": "Ciudad de México",
        "postalCode": "06600",
        "state": "CDMX",
        "countryCode": "MX",
        "line2": "Piso 30"
      },
      "phoneNumber": {
        "countryCode": "52",
        "number": "5512345678"
      },
      "email": "jsmith@example.com"
    }
  },
  "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.

Headers

​
X-MultiTenantKey
string

Required when using a Platform API token. The tenant key identifying which business to operate on.

Path Parameters

​
remittance_id
string
required

Remittance identifier

Response

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"

​
paymentDetails
object

The routing Cadana used to deliver the payment. Echoes back the paymentDetails from the create request, or — when omitted — the internal default routing Cadana used for the authority.

​
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[]
​
createdAt
number<epoch>

Unix epoch timestamp

Example:

1709280000

​
updatedAt
number<epoch>

Unix epoch timestamp

Example:

1709280000