---
title: "Get Invoices"
method: GET
path: "/invoices/{identifier}"
tags: ["Individuals"]
---

# Get Invoices

`GET /invoices/{identifier}`

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.

## Path parameters

- `identifier` string, required

## Query parameters

- `type` 'nomina' | 'ingreso' | 'egreso' | 'pago'
- `page` integer
- `items_per_page` integer
- `start_date` string, date
- `end_date` string, date
- `updated_at_from` string, date
- `updated_at_to` string, date
- `include_payment_info` boolean

## Response `200`

Invoices for the individual (CURP).

- InvoicesResponse
  - `identifier` string — The identifier (CURP or RFC) associated with the invoices.
  - `updated_at` string, date-time — Timestamp of the last data update for the invoices.
  - `invoices` Invoice[]
    - `type` 'nomina' | 'ingreso' | 'egreso' | 'pago'
    - `amount` number
    - `currency` string
    - `issue_date` string, date
    - `rfc_issuer` string
    - `issuer_name` string
    - `rfc_receiver` string
    - `receiver_name` string
    - `payment_method` string — SAT payment method code, e.g. `PPD` (Pago en Parcialidades o Diferido — installment or deferred payment) or `PUE` (Pago en una sola Exhibición — single payment). Populated for invoices of type 'ingreso' and 'egreso'.
    - `payment_type` string — SAT payment form code, e.g. `99` (to be defined) or `04` (credit card). Populated for invoices of type 'ingreso' and 'egreso'.
    - `payroll_type` string, nullable — Payroll type, SAT TipoNomina. Populated for invoices of type 'nomina'.
    - `payment_periodicity` string, nullable — Payment periodicity, SAT PeriodicidadPago. Populated for invoices of type 'nomina'.
    - `job_risk` string, nullable — Job risk class, SAT RiesgoPuesto. Populated for invoices of type 'nomina'.
    - `job_role` string, nullable — Job role (puesto) reported in the payroll receipt. Populated for invoices of type 'nomina'.
    - `job_department` string, nullable — Job department (departamento) reported in the payroll receipt. Populated for invoices of type 'nomina'.
    - `incomes` InvoiceDetail[] — Line items for income concepts. Always present in the response but only populated for invoices of type 'nomina'. Empty array for all other types.
      - `amount` number
      - `currency` string
      - `detail` string
      - `key` string — SAT key identifying the specific income or deduction concept (e.g. `052` for IMSS, `045` for ISR). Populated for invoices of type 'nomina'.
      - `type` string — SAT income/deduction type code that groups the concept (e.g. `001`, `002`). Populated for invoices of type 'nomina'.
    - `deductions` InvoiceDetail[] — Line items for deduction concepts. Always present in the response but only populated for invoices of type 'nomina'. Empty array for all other types.
      - `amount` number
      - `currency` string
      - `detail` string
      - `key` string — SAT key identifying the specific income or deduction concept (e.g. `052` for IMSS, `045` for ISR). Populated for invoices of type 'nomina'.
      - `type` string — SAT income/deduction type code that groups the concept (e.g. `001`, `002`). Populated for invoices of type 'nomina'.
    - `line_items` LineItem[] — List of the products or services included in the invoice. Populated for invoices of type 'ingreso' and 'egreso'.
      - `detail` string — Product or service description.
      - `quantity` number — Number of units included.
      - `unit` string — Unit of measure.
      - `unit_price` number — Per-unit cost.
      - `amount` number — Total amount for the line item.
      - `product_service_key` string — SAT product/service identifier (ClaveProdServ).
    - `invoice_relations` InvoiceRelation[] — References to related invoices (e.g. CFDI relations for payment complements). Populated for invoices of type 'ingreso' and 'egreso'.
      - `relation_type` string — SAT relationship code (TipoRelacion) describing how the documents are related.
      - `related_fiscal_code` string — The folio fiscal (UUID) of the linked fiscal document.
    - `folio_fiscal` string
    - `invoice_status` string
    - `zip_code_receiver` string
    - `payment_info` PaymentInfo[], nullable — Payment details associated with this invoice. Only present in the response when `include_payment_info=true` is passed. When the param is omitted, this field is absent entirely. When the param is true, this is `null` for invoices with no associated payment records, or an array of payment objects for `pago` invoices.
      - `total_amount_paid` number — Total amount paid in this payment record.
      - `currency` string — Currency of the payment. Defaults to MXN.
      - `exchange_rate` number — Exchange rate applied at time of payment. Defaults to 1.0 for MXN payments.
      - `payment_form` string — SAT payment form code. Common values: 01 = cash, 02 = check, 03 = electronic transfer.
      - `payment_date` string, date — Date of the payment (YYYY-MM-DD).
      - `payment_relations` PaymentRelation[] — List of invoices this payment was applied to, including the partial or full amount paid against each.
        - `related_fiscal_code` string — The folio fiscal (UUID) of the related invoice that received the payment.
        - `paid_amount` number — The partial or full amount applied to this related invoice.
    - `updated_at` string, date-time — Timestamp (ISO-8601 instant) of the last update for this individual invoice record. Reflects per-row freshness and is the field filtered by the `updated_at_from`/`updated_at_to` query parameters.
  - `pagination` Pagination
    - `page` integer — The current page number.
    - `items_per_page` integer — The number of items returned per page.
    - `total_items` integer — The total number of items available.
    - `total_pages` integer — The total number of pages available.

## Other responses

- `401` — Unauthorized - Invalid or missing API key.

---

[API](https://skmtc.net/burodeingresos/apis/bur-de-ingresos-api.md) · [All operations](https://skmtc.net/burodeingresos/apis/bur-de-ingresos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/burodeingresos/bur-de-ingresos-api/versions/59e48cdbdd84/schema)