v1

latestOpenAPI 3.0.32026-07-242644125.9 KB

Individuals

Get Invoices

Retrieves the invoices for an individual identified by an 18-char CURP. Requires a prior successful verification that yielded invoice data. Results can be paginated and filtered by invoice type and issue date range. Pass include_payment_info=true to enrich each invoice with its associated payment details from pago (type P) records.

get/invoices/{identifier}

Path parameters

identifierstring required

Example:CUAI911021MOCRQS09

The CURP of the individual.

Query parameters

type'nomina' | 'ingreso' | 'egreso' | 'pago'

Example:nomina

Optional. Filter invoices by type (nomina, ingreso, egreso, pago). If not provided, all invoice types are returned.

pageinteger

Page number for pagination.

items_per_pageinteger

Number of items per page.

start_datestring date

Example:2025-01-01

Optional. Filters invoices to include those issued on or after this date (YYYY-MM-DD). Applies to invoice 'issue_date'.

end_datestring date

Example:2025-12-31

Optional. Filters invoices to include those issued on or before this date (YYYY-MM-DD). Applies to invoice 'issue_date'.

updated_at_fromstring date

Example:2026-01-01

Optional. Filters invoice records to include only those last updated on or after this timestamp (ISO 8601 / RFC 3339). Use together with updated_at_to to define a window, or alone to retrieve records updated since a given point. Returns HTTP 400 (invalid_input_data) if updated_at_from is after updated_at_to.

updated_at_tostring date

Example:2026-06-30

Optional. Filters invoice records to include only those last updated on or before this timestamp (ISO 8601 / RFC 3339). Use together with updated_at_from to define a window, or alone to retrieve records updated up to a given point. Returns HTTP 400 (invalid_input_data) if updated_at_from is after updated_at_to.

include_payment_infoboolean

Optional. When true, each invoice in the response includes a payment_info array with associated payment details sourced from pago records. If an invoice has no associated payments, payment_info is null. Defaults to false.

Response

Invoices for the individual (CURP).

identifierstring

The identifier (CURP or RFC) associated with the invoices.

updated_atstring date-time

Timestamp of the last data update for the invoices.

Example response

{
  "invoices": [
    {
      "payment_method": "PPD",
      "payment_type": "99",
      "payroll_type": "Ordinaria",
      "payment_periodicity": "Quincenal",
      "job_risk": "Clase II (Riesgo bajo)",
      "job_role": "AYUDANTE GENERAL",
      "job_department": "OPERACIONES",
      "incomes": [
        {
          "key": "052",
          "type": "001"
        }
      ],
      "deductions": [
        {
          "key": "052",
          "type": "001"
        }
      ],
      "payment_info": [
        {
          "currency": "MXN",
          "exchange_rate": 1,
          "payment_form": "03",
          "payment_date": "2025-08-15"
        }
      ]
    }
  ]
}