Get Invoices

get

https://api.burodeingresos.com/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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

identifier

string

required

The CURP of the individual.

Query Params

type

string

enum

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

Allowed:

page

integer

Defaults to 1

Page number for pagination.

items_per_page

integer

Defaults to 100

Number of items per page.

start_date

date

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

end_date

date

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

updated_at_from

date

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_to

date

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_info

boolean

Defaults to false

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.

Responses

200Invoices for the individual (CURP).

401Unauthorized - Invalid or missing API key.