Employment Records

Our employment records resource lets you get a comprehensive view of your user’s current social security contributions and employment history.

With Belvo's employment records resource, you can access information about your user's current social security contributions and employment history. For each user, we return the:

personal data
work history
historical and current daily base salary
and more!

At the moment, the employment records resource is available for:

🇲🇽 Mexico (IMSS)

Endpoints	Method	Description
Retrieve	POST	Retrieve all employment historical data related to a specific link.
List	GET	List all the employment historical data for all the Links already associated with your Belvo account.
Detail	GET	Get the details of a specific individual's employment data.
Destroy	GET	Delete specific employment data from your Belvo account.

Creating a link with Mexico's IMSS

To be able to use the employment records resource, you'll first need to create a link using our Register a new link method, providing the following parameters:

username: The user's CURP number. (Required)
username2: The user's email address. (Optional)
password: An empty string "".

When the link is created successfully, you'll receive the link id in the response, which you'll need to use in order to retrieve the specific information for the individual when making a Retrieve employment records request.