> ## 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.

# Warrant Schema (Arrest Warrant)

> Structure of the Warrant object returned by the Judit API arrest warrant query. Includes order, sentence, infringed laws and individual data.

> 🤖 Arrest warrant queries return the `warrant` object. The root contains the judicial order and sentence data. Information about the infringed laws is in the `law_type` array, and detailed data about the wanted individual is nested in the `entity` object (which follows the standard Individual (natural person) structure of the Judit API).

## General Structure

The warrant JSON is organized into 4 main blocks:

* **Warrant Header:** Order data, issuing court, status, and sentence calculation.
* **Legal Framework (law\_type):** Array with the infringed laws and articles.
* **Individual (entity):** Detailed object of the wanted person (CPF, name, parentage).
* **Attachments (attachments):** Array of warrant documents (official PDFs).

***

## Data Dictionary

### 1. Warrant Header (Object Root)

These properties come directly at the root of the returned object.

| Property | Type | Description |
| :- | :- | :- |
| `number` | string | Internal warrant number in the issuing system (usually contains the CNJ number of the source lawsuit). |
| `code` | string | Unique lawsuit number (CNJ standard) linked to the warrant. |
| `warrant_type` | string | Type of warrant issued (e.g., `"Mandado de Prisão"`, `"Mandado de Recaptura"`). |
| `arrest_type` | string | Nature of the arrest (e.g., `"definitive"`, `"temporary"`, `"preventive"`). |
| `status` | string | Current status of the warrant (e.g., `"Aguardando Cumprimento"`, `"Cumprido"`, `"Revogado"`). |
| `issue_date` | string | Date (ISO 8601) on which the warrant was officially issued. |
| `expiration_date` | string | Date (ISO 8601) on which the warrant loses its prescriptive validity. |
| `recapture` | boolean | Returns `true` if the warrant is for the recapture of an individual who escaped from the prison system. |
| `judgementSummary` | string | Text summary of the judicial decision that underpinned the warrant. |
| `individual_id` | string | Unique internal identifier of the related person. |

#### Issuing Body

| Property | Type | Description |
| :- | :- | :- |
| `tribunal_id` | string | Numeric identifier of the responsible court (BNMP ID). |
| `tribunal` | string | Official numeric code of the court in the CNJ standard. |
| `tribunal_acronym` | string | Official court acronym (e.g., `"TJSP"`, `"TJRJ"`). |
| `justice` | string | Identifier code for the branch of justice. |
| `instance` | number | Judicial degree/instance that issued the warrant (e.g., `1`). |
| `court` | string | Exact judging body (name of the court or originating judgeship). |

#### Sentence Calculation

| Property | Type | Description |
| :- | :- | :- |
| `duration` | string | Textual representation of the total sentence duration (e.g., `"5 anos, 2 meses e 10 dias"`). |
| `duration_years` | number | Exact number of years of the sentence. |
| `duration_months` | number | Exact number of months of the sentence. |
| `duration_days` | number | Exact number of days of the sentence. |
| `regime` | string | Initial regime stipulated for serving the sentence (e.g., `"FECHADO"`, `"SEMIABERTO"`, `"ABERTO"`). |

### 2. Legal Framework (`law_type`)

Array of objects detailing the crimes committed that motivated the warrant.

| Property | Type | Description |
| :- | :- | :- |
| `number` | string | Title or identifier code of the law (e.g., `"Código Penal"`, `"Lei de Drogas"`). |
| `description` | string | Text with the exact article, paragraph, or item infringed (e.g., `"Art. 157, § 2º"`). |

### 3. Wanted Individual (`entity`)

Object containing the complete qualification of the person. Follows the structure of the [Entity Object](/en/schemas/entity) for Individuals (natural persons).

| Main Property | Type | Description |
| :- | :- | :- |
| `name` | string | Full name of the wanted person. |
| `main_document` | string | CPF of the person (numbers only). |
| `aka_names` | array | False names, known nicknames, or aliases used by the individual. |
| `parents` | array | Parentage (mother's and father's names). Widely used by authorities to disambiguate namesakes. |
| `birth_date` | string | Date of birth. |
| `gender` | string | Registered gender or sex. |
| `addresses` | array | List of the latest known or registered addresses of the person. |
| `warnings_and_determinations` | string | Critical alerts for authorities (e.g., `"Indivíduo de alta periculosidade"`, `"Membro de facção"`). |
| `observations` | string | Additional notes or registered physical characteristics. |

### 4. Attachments (`attachments`)

Official documents of the judicial order.

| Property | Type | Description |
| :- | :- | :- |
| `attachment_id` | string | Unique internal identifier of the attachment. |
| `extension` | string | Format of the extracted file (usually `"PDF"` of the signed original order). |
| `status` | string | Download status of the file from the court (`"done"` or `"pending"`). |

***

## Payload Example (Arrest Warrant)

<CodeGroup>
  ```json Response theme={null}
  Example of response return:
  {
  	"page": 1,
  	"page_data": [
  		{
  			"request_id": "87d9f7bf-0071-41ee-a721-e6e1b4082bc9",
  			"response_id": "c7ae682c-3d7c-4634-a0b1-e414ae38fdeb",
  			"origin": "api",
  			"origin_id": "33fad316-cd98-40b9-bcd4-70e3c74ff947",
  			"response_type": "warrant",
  			"response_data": {
  				"_id": "65f29d5c48f9210b7040b5a3",
  				"warrant_id": "eb532bb3-2f0e-41c9-a80d-50f17258126f",
  				"entity_id": "09c91d1b-fba7-4b0e-bfc3-e87a8b092802",
  				"tribunal_id": "33123363_1",
  				"individual_id": "18155647970",
  				"warrant_type": "warrant_of_arrest",
  				"arrest_type": "definitive",
  				"law_type": {
  					"number": "2848",
  					"description": "2848, 157, § 2º, I;II;"
  				},
  				"number": "0007826652016810000101000112",
  				"previous_number": "",
  				"issue_date": "2018-05-28T11:52:37.716Z",
  				"create_date": "2018-05-28T12:05:09.040Z",
  				"expiration_date": "2028-11-27T00:00:00.000Z",
  				"status": "Pendente de Cumprimento",
  				"code": "99999999-99.9999.9.99.9999",
  				"instance": 1,
  				"tribunal": "10",
  				"justice": "8",
  				"tribunal_acronym": "TJMA",
  				"court": "Tribunal de Justiça do Estado do Maranhão",
  				"judge": "USUÁRIO TESTE",
  				"judgementSummary": "O MINISTÉRIO PÚBLICO ESTADUAL, através da douta Promotora de Justiça com exercício nesta Unidade Jurisdicional, lastreada em Inquérito Policial ofereceu denúncia contra LUÍS SOUZA, brasileiro, solteiro, natural de Cedral/MA, nascido em 17/07/1995, RG n.º 999999999999-9 SSPMA, filho de Eduardo Silva Trindade e Maria da Conceição Silva, residente na Rua centro, n.º 99, bairro Centro, São Luís/MA, incursando-o no crime tipificado no art. 157, § 2º, I e II, do Código Penal.Ante o exposto, julgo procedente a denúncia e CONDENO o acusado LUÍS SOUZA, supraqualificado, nas penas do artigo 157, § 2º, I e II, do Código Penal. Não ocorre causa de diminuição de pena. Por outro lado, presente a causa de aumento de pena pelo emprego de arma e concurso de pessoas, pelo que elevo a reprimenda no patamar mínimo de 1/3 (um terço), ou seja, 01 ano e 04 (quatro) meses de reclusão e 03 (três) dias multa, resultando na reprimenda definitiva de 05 (CINCO) ANOS E 04 (QUATRO) MESES DE RECLUSÃO E 13 (TREZE) DIAS MULTA, a qual deverá ser cumprida em regime inicialmente semiaberto, na Penitenciária Agrícola de Pedrinhas. Com o trânsito em julgado desta, o nome do condenado deverá ser inscrito no Livro Rol dos Culpados, calculada a pena de multa e intimado para pagamento, oficiando-se ao TRE para as providências quanto a sua situação eleitoral, bem como expedida carta de guia definitiva e mandado de prisão.",
  				"duration": "5 ano(s) 4 mês(es) 0 dia(s).",
  				"duration_years": 5,
  				"duration_months": 4,
  				"duration_days": 0,
  				"observations": "DEFINITIVA",
  				"regime": "Semiaberto",
  				"recapture": false,
  				"crawler": {
  					"source_name": "JBnmp - BR - Warrant - No Auth",
  					"crawl_id": "eb9c2c3a-1893-4ace-a98f-6210f8e78f72",
  					"updated_at": "2024-03-14T06:46:24.996Z",
  					"weight": 10,
  					"_id": "65f29d5c48f9210b7040b5a4"
  				},
  				"created_at": "2024-03-14T06:46:24.996Z",
  				"updated_at": "2024-03-14T06:46:24.996Z",
  				"entity": {
  					"_id": "65f29d5c48f9210b7040b59b",
  					"entity_id": "09c91d1b-fba7-4b0e-bfc3-e87a8b092802",
  					"entity_type": "person",
  					"name": "JOÃO SILVA",
  					"main_document": "99999999999",
  					"documents": [
  						{
  							"document": "99999999999",
  							"document_type": "cpf",
  							"_id": "65f29d5c48f9210b7040b59c"
  						},
  						{
  							"document": "99999999999-9",
  							"document_type": "rg",
  							"_id": "65f29d5c48f9210b7040b59d"
  						},
  						{
  							"document": "99999999999-9",
  							"document_type": "rji",
  							"_id": "65f29d5c48f9210b7040b59e"
  						}
  					],
  					"addresses": [
  						{
  							"street": "RUA CENTRO",
  							"number": "99",
  							"neighborhood": "CENTRO",
  							"city": "Sao Luis",
  							"state": "MA",
  							"ibge_code": 9999999,
  							"country": "Brasil",
  							"_id": "65f29d5c48f9210b7040b59f"
  						}
  					],
  					"contacts": [],
  					"aka_names": [
  						"LOURO"
  					],
  					"parents": [
  						{
  							"name": "USUÁRIO TESTE",
  							"kinship": "father",
  							"_id": "65f29d5c48f9210b7040b5a0"
  						},
  						{
  							"name": "MARIA SILVA",
  							"kinship": "mother",
  							"_id": "65f29d5c48f9210b7040b5a1"
  						}
  					],
  					"partners": [],
  					"birth_date": "1995-07-17T03:00:00.000Z",
  					"place_of_birth": "Cedral",
  					"gender": "male",
  					"created_at": "2024-03-14T06:46:24.996Z",
  					"updated_at": "2024-03-14T07:03:00.407Z"
  				}
  			},
  			"user_id": "6dc91e78-400e-489c-b30c-61789e323d7c",
  			"created_at": "2024-03-14T07:35:35.911Z",
  			"request_created_at": "2024-03-14T07:35:14.272Z",
  			"tags": {
  				"dashboard_id": null
  			}
  		}
  	],
  	"page_count": 1,
  	"all_count": 1,
  	"all_pages_count": 1
  }
  ```
</CodeGroup>

***

## Next Steps

* 👉 **[Criminal Records Queries](/en/criminal-consultation/warrant):** See the documentation for the specific endpoint to trigger arrest warrant searches.
* 👉 **[Entity Object](/en/schemas/entity):** Review all possible properties of the `entity` object returned within the warrant.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.