Brazil Income Request
Description​
Initiates an income check for a Brazilian citizen by CPF.
The Monthly Income Estimation Service provides an inferred monthly income range derived from structured credit bureau data in Brazil. This service enhances identity verification (IDV), onboarding risk analysis, and underwriting workflows by supplying a data-driven estimate of an individual's earning capacity. Unlike payroll or government-declared income sources, this product relies on behavioral and financial indicators reported within the Brazilian credit ecosystem.
HTTP method GET​
Endpoint​
https://api.msla-id.com/experience-idv-jobinformation-api-v1/api/idv-govcheck/v1/br-identity/{cpfNumber}/check-income
For testing purposes, use the base domain: apidev.msla-id.com
Before proceeding, make sure you have your jwt token, if you don't have it, check the login documentation.
Request header parameter​
| NAME | REQUIRED | TYPE | DESCRIPTION |
|---|---|---|---|
| Authorization | ✅ | string | Bearer JWT token |
Path request parameter​
| NAME | REQUIRED | TYPE | DESCRIPTION |
|---|---|---|---|
| cpfNumber | ✅ | string | Brazilian CPF number |
Status code responses​
| Code | Description |
|---|---|
| 200 | OK |
| 400 | Bad request |
| 401 | Unauthorized |
| 500 | Internal server error |
The full documentation error codes can be found here.
Response 200 status code​
{
"traceId": "623ed99eb490c7f3",
"timestamp": "2026-03-09 17:38:54",
"data": {
"ref": "06479666542-8b5979f0",
"status": "IN_PROGRESS"
}
}
Response 400 status code​
{
"traceId": "542fc743fffda052",
"timestamp": "2023-05-05 11:20:46",
"code": "IDV-4005",
"message": "-",
"data": null
}
Response 401 status code​
{
"timestamp": "YYYY-MM-DDTHH:mm:ss.sssZ",
"status": 401,
"error": "Unauthorized",
"path": "/api/idv-govcheck/v1/br-identity/{cpfNumber}/check-income"
}
Response 500 status code​
{
"traceId": "43a20f33d4e8730d",
"timestamp": "yyyy-mm-dd HH:MM:SS",
"code": "IDV-1001",
"message": "A generic error has occurred.",
"data": null
}