Arrest Warrant Query

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
}

{
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99",
        "response_type": "warrant"
    },
    "with_attachments": true
}

{
    "search": {
        "search_type": "name",
        "search_key": "John Smith",
        "response_type": "warrant"
    },
    "with_attachments": false
}

{
    "search": {
        "search_type": "rji",
        "search_key": "00000000000000000000",
        "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

Parameter	Type	Required	Description
`search.search_type`	string	Yes	`"cpf"`, `"name"` or `"rji"`.
`search.search_key`	string	Yes	CPF, full name or RJI to search.
`search.response_type`	string	Yes	Always `"warrant"`.
`with_attachments`	boolean	No	If `true`, we download the issued warrant PDF.
`callback_url`	string	No	HTTPS 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
  }'

const res = await fetch("https://requests.production.judit.io/requests", {
  method: "POST",
  headers: {
    "api-key": process.env.JUDIT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    search: {
      search_type: "cpf",
      search_key: "999.999.999-99",
      response_type: "warrant",
    },
    with_attachments: true,
  }),
});
console.log(await res.json());

<?php
$ch = curl_init('https://requests.production.judit.io/requests');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'api-key: ' . getenv('JUDIT_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'search' => [
            'search_type'   => 'cpf',
            'search_key'    => '999.999.999-99',
            'response_type' => 'warrant',
        ],
        'with_attachments' => true,
    ]),
]);
echo curl_exec($ch);

import os, requests

resp = requests.post(
    "https://requests.production.judit.io/requests",
    headers={
        "api-key": os.environ["JUDIT_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "search": {
            "search_type": "cpf",
            "search_key": "999.999.999-99",
            "response_type": "warrant",
        },
        "with_attachments": True,
    },
    timeout=15,
)
resp.raise_for_status()
print(resp.json())

package main

import (
    "bytes"
    "encoding/json"
    "io"
    "net/http"
    "os"
)

func main() {
    body, _ := json.Marshal(map[string]any{
        "search": map[string]string{
            "search_type":   "cpf",
            "search_key":    "999.999.999-99",
            "response_type": "warrant",
        },
        "with_attachments": true,
    })
    req, _ := http.NewRequest("POST",
        "https://requests.production.judit.io/requests",
        bytes.NewReader(body))
    req.Header.Set("api-key", os.Getenv("JUDIT_API_KEY"))
    req.Header.Set("Content-Type", "application/json")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body)
    println(string(out))
}

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"

resp = requests.get(
    f"https://requests.production.judit.io/responses?request_id={request_id}",
    headers={"api-key": os.environ["JUDIT_API_KEY"]},
)
print(resp.json())

Response structure

Field	Description
`warrant_type`	Warrant type (`warrant_of_arrest`, `recapture`, etc.).
`arrest_type`	Arrest mode (`preventive`, `temporary`, `definitive`).
`law_type`	Infringed law and articles.
`issue_date` / `expiration_date`	Issue and expiration dates.
`status`	Warrant situation — see table below.
`duration_years/months/days`	Calculated sentence.
`regime`	Enforcement regime (`Open`, `Semi-open`, `Closed`).
`recapture`	`true` for recapture warrants.
`entity`	Full data of the wanted individual (follows Entity Schema).
`judgementSummary`	Text of the sentence/order that triggered the warrant.

Possible values for `status`

Status	Behavior
Pendente de Cumprimento	The warrant is active, awaiting enforcement.
Cumprido	Warrant fulfilled (arrest happened).
Suspenso	Temporarily suspended by judicia

Getting Started

Core Concepts

Data Models (Schemas)

Asynchronous Requests

Synchronous Requests

Tracking

Registration Data

Criminal Records

File Transfer

Credentials Vault

Webhook

Resources

When to use

Reinforced compliance / KYC

Human resources

Private investigation

Public defense

Step 1: Create the request (POST)

Examples by search type

Payload parameters

Request example (POST)

Creation response

Step 2: Retrieve the response

Response structure

Possible values for `status`

​When to use

Reinforced compliance / KYC

Human resources

Private investigation

Public defense

​Step 1: Create the request (POST)

​Examples by search type

​Payload parameters

​Request example (POST)

​Creation response

​Step 2: Retrieve the response

​Response structure

​Possible values for status

When to use

Step 1: Create the request (POST)

Examples by search type

Payload parameters

Request example (POST)

Creation response

Step 2: Retrieve the response

Response structure

Possible values for `status`