Warrant Schema (Arrest Warrant)

🤖 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 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)

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
}

Next Steps

👉 Criminal Records Queries: See the documentation for the specific endpoint to trigger arrest warrant searches.
👉 Entity Object: Review all possible properties of the entity object returned within the warrant.

Getting Started

Core Concepts

Data Models (Schemas)

Asynchronous Requests

Synchronous Requests

Tracking

Registration Data

Criminal Records

File Transfer

Credentials Vault

Webhook

Resources

General Structure

Data Dictionary

1. Warrant Header (Object Root)

Issuing Body

Sentence Calculation

2. Legal Framework (`law_type`)

3. Wanted Individual (`entity`)

4. Attachments (`attachments`)

Payload Example (Arrest Warrant)

Next Steps

​General Structure

​Data Dictionary

​1. Warrant Header (Object Root)

​Issuing Body

​Sentence Calculation

​2. Legal Framework (law_type)

​3. Wanted Individual (entity)

​4. Attachments (attachments)

​Payload Example (Arrest Warrant)

​Next Steps

General Structure

Data Dictionary

1. Warrant Header (Object Root)

Issuing Body

Sentence Calculation

2. Legal Framework (`law_type`)

3. Wanted Individual (`entity`)

4. Attachments (`attachments`)

Payload Example (Arrest Warrant)

Next Steps