National Bank of Arrest Warrants - Status

Description

Polls the status of a previously initiated arrest warrant check. The check runs asynchronously — use the GET status endpoint to poll until the result is ready (usually within 2 minutes).

info

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

---

Step 2 — Poll the result

HTTP method GET

Endpoint

https://api.msla-id.com/experience-background-arrestwarrants-api-v1/api/idv-govcheck/v1/br-identity/{cpfNumber}/check-national-bank-arrest-warrants/status/{ref}

[SANDBOX Environment]

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

Request header parameters

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	Bearer JWT token

URI request parameters

NAME	REQUIRED	TYPE	DESCRIPTION
cpfNumber	✅	string	CPF number (same as used in Step 1)
ref	✅	string	Ticket ref returned by the Step 1 POST

Status code responses

Code	Description
200	OK (pending, not found, or result)
400	Bad request
401	Unauthorized
403	Forbidden
500	Internal server error

The full documentation for error codes can be found here.

Response 200 — Still processing

Retry after a few seconds.

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

Response 200 — Not found

The email was not found during enrichment, so the email check stage could not run.

{
    "traceId": "d638df58b52151ec",
    "timestamp": "2026-03-11 11:21:41",
    "data": {
        "ref": "06479665570-kyc-a3f1bc2e-2",
        "status": "NOT_FOUND",
        "message": "Email not found in enrichment data. The email check stage requires a valid email address."
    }
}

Response 200 — Not found (alternative response)

No warrants data available for the requested identity.

{
    "traceId": "a2fcf48853956679",
    "timestamp": "2026-03-11 11:22:40",
    "data": {
        "source": null,
        "warrants": null,
        "issuedAt": null,
        "nothingFound": false,
        "resultType": {
            "present": false
        },
        "warrantCount": 0,
        "warrantCountByState": null,
        "warrantCountWithHomonym": null,
        "warrantCountWithoutHomonym": null,
        "hasWarrantWithHomonym": null,
        "hasWarrantWithoutHomonym": null
    }
}

Response 200 — Completed, no warrants found

{
    "traceId": "d638df58b52151ec",
    "timestamp": "2026-03-11 11:21:41",
    "data": {
        "nothing_found": true,
        "warrant_count": 0
    }
}

Response 200 — Completed, warrant records found

{
    "traceId": "d638df58b52151ec",
    "timestamp": "2026-03-11 11:21:41",
    "data": {
        "source": "MandadosPrisaoBancoNacional",
        "warrants": [
            {
                "name": "JOSÉ WEVERTON DA SILVA",
                "state": "AL",
                "mother_name": "Eroneide Zeferino da Silva",
                "father_name": "Não informado",
                "homonym": true,
                "status": "Pendente de Cumprimento",
                "magistrate": "FAUSTO MAGNO DAVID ALVES",
                "warrant_date": "09/12/2021",
                "expiration_date": "08/06/2041",
                "civil_warrant": false,
                "warrant_number": "0701104552017802006701000123",
                "case_number": "07011045520178020067"
            }
        ],
        "issued_at": "2026-03-10T21:23:12.211715Z",
        "nothing_found": false,
        "warrant_count": 1,
        "warrant_count_by_state": {
            "AL": 1
        },
        "warrant_count_with_homonym": 1,
        "warrant_count_without_homonym": 0,
        "has_warrant_with_homonym": true,
        "has_warrant_without_homonym": false
    }
}

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-national-bank-arrest-warrants/status/{ref}"
}

Response 403 status code

{
    "traceId": "string",
    "timestamp": "string",
    "code": "string",
    "message": "Forbidden"
}

Response 500 status code

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