Receita federal people

Description

Receita Federal is responsible for issuing and managing the Natural Persons Register. This query obtains public data from the Natural Persons Register (CPF).

HTTP method GET

Endpoint

https://api.msla-id.com/experience-idv-docverifcheck-api-v1/api/idv-govcheck/v1/br-cpf/validate

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

info

Before proceeding, make sure you have your jwt token, if you don't, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

URI request parameter

NAME	REQUIRED	TYPE	DESCRIPTION
documentNumber	✅	string	11 numeric digits, without dots or hyphens.
birthDate	✅	string	Date of birth in DDMMAAAA format.

Status code responses

Code	Description
200	OK
400	Bad request — IDV-3001
401	Unauthorized
404	Not found — IDV-1002
500	Internal server error.

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "34372f63ac42d547",
    "timestamp": "2024-10-17 12:04:00",
    "data": {
        "documentNumber": "99999999999",
        "names": "PESSOA FISICA DA SILVA",
        "situation": {
            "code": "0",
            "description": "Regular"
        },
        "birthDate": "01051976",
        "registrationDate": "10051976",
        "socialName": "PESSOA FISICA DA SILVA SOCIAL"
    }
}

Response 404 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-1002",
    "message": "Data not found.",
    "data": null
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-3001",
    "message": "Bad request - Invalid or incomplete input data",
    "data": null
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administration."
}