Sign in

v1

latestOpenAPI 3.0.32026-07-242644125.9 KB
Business

Get Business Invoices

Retrieves the invoices for a business identified by a 12-char RFC. 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/{rfc}

Path parameters

rfcstring required
Example:MNT850612KR4

The 12-char RFC of the business.

Query parameters

type'nomina' | 'ingreso' | 'egreso' | 'pago'
Example:ingreso

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'.

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 business (RFC).

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"
        }
      ]
    }
  ]
}