Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.judit.io/llms.txt

Use this file to discover all available pages before exploring further.

The Arrest Warrant Query integrates with the Brazilian National Arrest Warrant Database (BNMP 2.0) by CPF, Name or RJI and returns, in Judit’s standard JSON, the judicial order, calculated sentence, infringed laws and full data of the wanted individual. It covers preventive, temporary, definitive and recapture warrants.
🤖 Asynchronous flow. Same route as the lawsuit query: POST https://requests.production.judit.io/requests with response_type: "warrant". To download the warrant PDF, set with_attachments: true.

​
When to use

Reinforced compliance / KYC

Identify active warrants against the counterpart during onboarding or periodic review.

Human resources

Background check during selection for sensitive or trusted positions.

Private investigation

Locate and profile individuals with public legal grounding.

Public defense

Verify open orders before hearings, with automatic retrieval of the warrant PDF.

​
Step 1: Create the request (POST)

POST https://requests.production.judit.io/requests

​
Examples by search type

{
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99",
        "response_type": "warrant"
    },
    "with_attachments": false
}
response_type must always be "warrant". search_type accepts "cpf", "name" or "rji" (the BNMP 2.0 personal identifier).

​
Payload parameters

ParameterTypeRequiredDescription
search.search_typestringYes"cpf", "name" or "rji".
search.search_keystringYesCPF, full name or RJI to search.
search.response_typestringYesAlways "warrant".
with_attachmentsbooleanNoIf true, we download the issued warrant PDF.
callback_urlstringNoHTTPS URL to receive the response via Webhook.

​
Request example (POST)

curl -X POST 'https://requests.production.judit.io/requests' \
  --header 'api-key: '"$JUDIT_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "search": {
      "search_type": "cpf",
      "search_key": "999.999.999-99",
      "response_type": "warrant"
    },
    "with_attachments": true
  }'

​
Creation response

{
    "request_id": "87d9f7bf-0071-41ee-a721-e6e1b4082bc9",
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99",
        "response_type": "warrant"
    },
    "with_attachments": true,
    "status": "pending",
    "created_at": "2024-03-14T07:35:14.272Z"
}

​
Step 2: Retrieve the response

The query is asynchronous — wait for the Webhook or fetch via GET /responses?request_id={request_id}. 
curl --location 'https://requests.production.judit.io/responses?request_id=<REQUEST_ID>' \
  --header 'api-key: '"$JUDIT_API_KEY"

​
Response structure

FieldDescription
warrant_typeWarrant type (warrant_of_arrest, recapture, etc.).
arrest_typeArrest mode (preventive, temporary, definitive).
law_typeInfringed law and articles.
issue_date / expiration_dateIssue and expiration dates.
statusWarrant situation — see table below.
duration_years/months/daysCalculated sentence.
regimeEnforcement regime (Open, Semi-open, Closed).
recapturetrue for recapture warrants.
entityFull data of the wanted individual (follows Entity Schema).
judgementSummaryText of the sentence/order that triggered the warrant.

​
Possible values for status

StatusBehavior
Pendente de CumprimentoThe warrant is active, awaiting enforcement.
CumpridoWarrant fulfilled (arrest happened).
SuspensoTemporarily suspended by judicia