# Employments Brazil

> Gain valuable insights into your users' employment history and income in Brazil with Belvo's Employments resource. Access comprehensive data on past and present employment, including salary information, to improve your credit risk assessment, streamline loan applications, and more.


## Introduction

Our employments resource for Brazil provides a comprehensive view of your user's current employment history and salary information.

For each user, we return the:

- work history (including occupations and employer data)
- historical and current salary information (per employer)


Description of image
## Available Institutions

| Name | Available resources | MFA | Products supported |
|  --- | --- | --- | --- |
| INSS`inss_br_employment` | - 🟢 Employments Brazil
- 🟢 Owners

 | 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.

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 Brazil, 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 creating a webview in your application and understanding how to handle deeplink redirects.


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

    App->>Belvo: POST /token/
    Note over App,Belvo: fetch_resources = [EMPLOYMENTS, OWNERS]
    Belvo-->>App: 200 - Token Generated
    
    App->>Belvo: Direct your user to the Hosted Widget
    Belvo->>Institution: User logs in to their institution
    Belvo-->>App: User redirected back to your application + link generated

    Belvo->>Institution: Belvo retrieves historical<br/>EMPLOYMENT and OWNER<br/>information for the Link ID

    Note over Belvo,App: EMPLOYMENTS

    Belvo->>App: WEBHOOK: historical_update
    App->>Belvo: GET /br/employments/{link-id}
    Belvo-->>App: 200 + Employment Details

    Note over Belvo,App: OWNERS

    Belvo->>App: WEBHOOK: historical_update
    App->>Belvo: GET /owners/{link-id}
    Belvo-->>App: 200 + Owner Details

    Note over App, Institution: If using recurrent Links, at the scheduled refresh frequency<br/>you will receive a new_{resource}_available webhook.

    Belvo->>App: WEBHOOK: new_employments_available
    App->>Belvo: GET /br/employments/{link-id}
    Belvo-->>App: 200 + Employment Details
```