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

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

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

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.