Skip to content
Last updated

Employment Records Mexico

Unlock valuable insights into your users' employment history and financial stability with Belvo's Employment Records resource for Mexico. Access comprehensive data on social security contributions and employment history to enhance your risk assessment, streamline onboarding, and more.

Introduction

With Belvo's employment resources for Mexico, you can access comprehensive information about your user's employment status and history. We offer two key resources:

Employment Records: Access historical social security contributions and employment history. For each user, we return:

  • personal data
  • work history
  • historical and current daily base salary
  • employment score (only available for IMSS) An employment score provides insight into the likelihood of a user meeting their future financial obligations in a given period. For each employment record we provide a score for the upcoming 3, 6, and 12 months.

Current Employments: Get the current employment status information. For each user, we return:

  • current employment status (employed/unemployed)
  • current salary information (base and monthly salary)
  • current employer details

Use Cases

ResourceBest forKey benefits
Employment RecordsCredit scoring, comprehensive background checks, historical analysisComplete employment history, employment scoring, detailed salary progression
Current EmploymentsReal-time verification, instant onboarding, current status checksFast verification, current employment status, real-time salary data

Available Institutions

NameAvailable resourcesMFAProducts supported
IMSS
imss_mx_employment
🟢 Employment Records Mexico
🟢 Current Employments Mexico
NoEmployment Information
ISSSTE
issste_mx_employment
🟢 Employment Records MexicoNoEmployment Information
Sandbox
planet_mx_employment
🟢 Employment Records MexicoNoEmployment Information

In order to extract data about your users, they will need to connect their account using the Belvo API (see the integration options below). When they connect their account, we create a link between the user and the institution.

Depending on your use case, we offer two different link types:

Link Type Description
RecurrentData is automatically retrieved at a given interval (daily, weekly, monthly) and you are notified via webhook. Ideal for ongoing monitoring and up-to-date insights.
SingleData is retrieved "on demand". Useful for one-time evaluations or user-initiated requests.

For more information about link types, the refresh intervals, and what data is extracted automatically, please see our dedicated Links article.

Integration Options

To extract employment data in Mexico, you can use the following integration options:

Belvo Hosted Widget

For mobile-native applications, we've created a hosted version of our widget that significantly simplifies your development and integration process. All it requires is for you to create a webview in your application and some knowledge of handling deeplink redirects.

ApplicationBelvoEmployment InstitutionFor each resource listed in fetch_resources, you will receive a historical_update webhook.If using recurrent links, at the scheduled refresh frequency you will receive a webhook.POST /token/fetch_resources =["EMPLOYMENT_RECORDS", "CURRENT_EMPLOYMENTS"]1200 - Token Generated2Direct your user to the Hosted Widget3User logs in to their institution4Belvo retrieves historical employment information for the link ID5User redirected back to your application. You receive a link ID for the user.6WEBHOOK historical_update (EMPLOYMENT_RECORDS)7GET /employment-records/?link={id}8200 + Employment Record Details9WEBHOOK historical_update (CURRENT_EMPLOYMENTS)10GET /current-employments/?link={id}11200 + Current Employment Details12WEBHOOK new_employment_records_available13GET /employment-records/?link={id}14200 + Employment Record Details15ApplicationBelvoEmployment Institution

Direct API

You can also integrate directly with our API, giving you complete control of the onboarding and credential-gathering process.

ApplicationBelvoEmployment InstitutionFor each resource listed in fetch_resources, you will receive a historical_update webhook.If using recurrent links, at the scheduled refresh frequency you will receive a webhook.POST /links/fetch_resources = ["EMPLOYMENT_RECORDS", "CURRENT_EMPLOYMENTS"]Connect and confirm link creation201 - CreatedBelvo retrieves historical employment information for the link IDWEBHOOK historical_update (EMPLOYMENT_RECORDS)GET /employment-records/?link={id}200 + Employment Record DetailsWEBHOOK historical_update (CURRENT_EMPLOYMENTS)GET /current-employments/?link={id}200 + Current Employment DetailsWEBHOOK new_employment_records_availableGET /employment-records/?link={id}200 + Employment Record DetailsApplicationBelvoEmployment Institution