Criminal Record of the Federal Police - Request

Description

Initiates a criminal background check against Brazil's National Bank of Arrest Warrants (BNMP) via CPF Enrichment and Criminal Background Check (BGC) flow. This service consults records of collective crimes in the Federal Police database, the entity responsible for investigating criminal offenses against the political and social order, investigating political crimes and money laundering, in addition to combating acts of terrorism, pedophilia, drug trafficking, interstate crimes and cybernetics.

Asynchronous Flow

This API uses an asynchronous two-step process:

1. Initiate the check — returns a ref ticket with status IN_PROGRESS (HTTP 202). The process may take up to 2 minutes to complete.
2. Poll for results — use the ref ticket to poll until the result is available (HTTP 200).

info

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

---

Step 1 — Initiate the check

HTTP method GET

Endpoint

https://api.msla-id.com/experience-background-criminalrecord-api-v1/api/idv-govcheck/v1/br-identity/{cpfNumber}/check-criminal-records

[SANDBOX Environment]

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

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	Bearer JWT token

URI request parameter

NAME	REQUIRED	TYPE	DESCRIPTION
cpfNumber	✅	string	CPF number of the person (digits only).

Status code responses

Code	Description
202	Request accepted — background check initiated.
400	Bad request
401	Unauthorized
403	Forbidden
500	Internal server error

The full documentation error codes can be found here.

Response 202 status code

{
    "traceId": "d638df58b52151ec",
    "timestamp": "2026-03-11 11:21:41",
    "data": {
        "ref": "06479633377-a3f1bc2e-2",
        "status": "IN_PROGRESS"
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-4005",
    "message": "-"
}

Response 401 status code

{
    "timestamp": "YYYY-MM-DDTHH:mm:ss.sssZ",
    "status": 401,
    "error": "Unauthorized",
    "path": "/api/idv-govcheck/v1/br-identity/{cpfNumber}/check-criminal-records"
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1001",
    "message": "A generic error has occurred."
}