# 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

| Resource | Best for | Key benefits |
|  --- | --- | --- |
| Employment Records | Credit scoring, comprehensive background checks, historical analysis | Complete employment history, employment scoring, detailed salary progression |
| Current Employments | Real-time verification, instant onboarding, current status checks | Fast verification, current employment status, real-time salary data |


## Available Institutions

| Name | Available resources | MFA | Products supported |
|  --- | --- | --- | --- |
| IMSS`imss_mx_employment` | 🟢 Employment Records Mexico🟢 Current Employments Mexico | No | Employment Information |
| ISSSTE`issste_mx_employment` | 🟢 Employment Records Mexico | No | Employment Information |
| Sandbox`planet_mx_employment` | 🟢 Employment Records Mexico | No | Employment Information |


## Connecting Users (Links)

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.

```mermaid
sequenceDiagram
    participant App as Application
    participant Inst as Institution

    App->>Inst: User connects to the financial institution using Belvo
    Inst-->>App: "Link" established
```

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

| Link Type  | Description |
|  --- | --- |
| Recurrent | Data 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. |
| Single | Data 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 and web-based 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.

```mermaid
sequenceDiagram
  autonumber

  participant App as Application
  participant Belvo as Belvo
  participant EI as Employment Institution

  App->>Belvo: POST /token/<br/>fetch_resources =<br/>["EMPLOYMENT_RECORDS", "CURRENT_EMPLOYMENTS"]
  Belvo-->>App: 200 - Token Generated
  App->>App: Direct your user to the Hosted Widget
  App->>EI: User logs in to their institution
  EI-->>Belvo: Belvo retrieves historical employment information for the link ID
  Belvo-->>App: User redirected back to your application. You receive a link ID for the user.

  Note over App,EI: For each resource listed in fetch_resources, you will receive a historical_update webhook.

  Belvo->>App: WEBHOOK historical_update (EMPLOYMENT_RECORDS)
  App->>Belvo: GET /employment-records/?link={id}
  Belvo-->>App: 200 + Employment Record Details

  Belvo->>App: WEBHOOK historical_update (CURRENT_EMPLOYMENTS)
  App->>Belvo: GET /current-employments/?link={id}
  Belvo-->>App: 200 + Current Employment Details

  Note over App,EI: If using recurrent links, at the scheduled refresh frequency you will receive a webhook.

  Belvo->>App: WEBHOOK new_employment_records_available
  App->>Belvo: GET /employment-records/?link={id}
  Belvo-->>App: 200 + Employment Record Details
```

Employment status change notifications
If you use recurrent links or perform a historical refresh on a single link, you can also receive notifications about employment status changes (such as salary increases, job changes, or transitions between employed and unemployed). For more information, see Employment status changes.

### Direct API

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

```mermaid
sequenceDiagram
    participant App as Application
    participant Belvo as Belvo
    participant EI as Employment Institution

    App->>Belvo: POST /links/<br/>fetch_resources = ["EMPLOYMENT_RECORDS", "CURRENT_EMPLOYMENTS"]
    Belvo->>EI: Connect and confirm link creation
    Belvo-->>App: 201 - Created
    EI-->>Belvo: Belvo retrieves historical employment information for the link ID

    Note over App,EI: For each resource listed in fetch_resources, you will receive a historical_update webhook.

    Belvo->>App: WEBHOOK historical_update (EMPLOYMENT_RECORDS)
    App->>Belvo: GET /employment-records/?link={id}
    Belvo-->>App: 200 + Employment Record Details

    Belvo->>App: WEBHOOK historical_update (CURRENT_EMPLOYMENTS)
    App->>Belvo: GET /current-employments/?link={id}
    Belvo-->>App: 200 + Current Employment Details

    Note over App,EI: If using recurrent links, at the scheduled refresh frequency you will receive a webhook.

    Belvo->>App: WEBHOOK new_employment_records_available
    App->>Belvo: GET /employment-records/?link={id}
    Belvo-->>App: 200 + Employment Record Details
```