Get Employments

get

https://api.burodeingresos.com/employments/{identifier}

Retrieves the employment history for an individual identified by an 18-char CURP. Requires a prior successful verification that yielded employment data. Results can be paginated and filtered by employment period (start_date/end_date) and by last-update window (updated_at_from/updated_at_to). Each row exposes its own updated_at so consumers can tell how fresh each record is.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

identifier

string

required

^[A-Z]{4}[0-9]{6}[HM][A-Z]{5}[A-Z0-9][0-9]$

The CURP of the individual.

Query Params

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 employment records to include those where the employment period overlaps with or starts on/after this date (YYYY-MM-DD).

end_date

date

Optional. Filters employment records to include those where the employment period overlaps with or ends on/before this date (YYYY-MM-DD).

updated_at_from

date-time

Optional. Filters employment records to include those last updated on/after this date, by their updated_at (YYYY-MM-DD).

updated_at_to

date-time

Optional. Filters employment records to include those last updated on/before this date, by their updated_at (YYYY-MM-DD). If updated_at_from is after updated_at_to, the request fails with HTTP 400.

institution

string

enum

Optional. Filters employment records by institution. If not provided, records from all institutions are returned.

Allowed:

data_source

array of strings

Optional. Filters employment records by one or more specific data sources. Can be repeated to include multiple sources (e.g. ?data_source=imss_rpci&data_source=imss_get_weeks). If not provided, the highest-priority source per institution is returned.

data_source

Responses

200Employment history for the CURP (identifier).

400Bad Request - Invalid query parameters. Returned when updated_at_from is after updated_at_to.

401Unauthorized - Invalid or missing API key.

404No employment history found for the CURP (identifier), or no prior successful verification exists that yielded this data. Also returned when active filters (including updated_at_from/updated_at_to) exclude every record.