Skip to main content
🤖 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.
PropertyTypeDescription
numberstringInternal warrant number in the issuing system (usually contains the CNJ number of the source lawsuit).
codestringUnique lawsuit number (CNJ standard) linked to the warrant.
warrant_typestringType of warrant issued (e.g., "Mandado de Prisão", "Mandado de Recaptura").
arrest_typestringNature of the arrest (e.g., "definitive", "temporary", "preventive").
statusstringCurrent status of the warrant (e.g., "Aguardando Cumprimento", "Cumprido", "Revogado").
issue_datestringDate (ISO 8601) on which the warrant was officially issued.
expiration_datestringDate (ISO 8601) on which the warrant loses its prescriptive validity.
recapturebooleanReturns true if the warrant is for the recapture of an individual who escaped from the prison system.
judgementSummarystringText summary of the judicial decision that underpinned the warrant.
individual_idstringUnique internal identifier of the related person.

​
Issuing Body

PropertyTypeDescription
tribunal_idstringNumeric identifier of the responsible court (BNMP ID).
tribunalstringOfficial numeric code of the court in the CNJ standard.
tribunal_acronymstringOfficial court acronym (e.g., "TJSP", "TJRJ").
justicestringIdentifier code for the branch of justice.
instancenumberJudicial degree/instance that issued the warrant (e.g., 1).
courtstringExact judging body (name of the court or originating judgeship).

​
Sentence Calculation

PropertyTypeDescription
durationstringTextual representation of the total sentence duration (e.g., "5 anos, 2 meses e 10 dias").
duration_yearsnumberExact number of years of the sentence.
duration_monthsnumberExact number of months of the sentence.
duration_daysnumberExact number of days of the sentence.
regimestringInitial regime stipulated for serving the sentence (e.g., "FECHADO", "SEMIABERTO", "ABERTO").
Array of objects detailing the crimes committed that motivated the warrant.
PropertyTypeDescription
numberstringTitle or identifier code of the law (e.g., "Código Penal", "Lei de Drogas").
descriptionstringText 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 PropertyTypeDescription
namestringFull name of the wanted person.
main_documentstringCPF of the person (numbers only).
aka_namesarrayFalse names, known nicknames, or aliases used by the individual.
parentsarrayParentage (mother’s and father’s names). Widely used by authorities to disambiguate namesakes.
birth_datestringDate of birth.
genderstringRegistered gender or sex.
addressesarrayList of the latest known or registered addresses of the person.
warnings_and_determinationsstringCritical alerts for authorities (e.g., "Indivíduo de alta periculosidade", "Membro de facção").
observationsstringAdditional notes or registered physical characteristics.

​
4. Attachments (attachments)

Official documents of the judicial order.
PropertyTypeDescription
attachment_idstringUnique internal identifier of the attachment.
extensionstringFormat of the extracted file (usually "PDF" of the signed original order).
statusstringDownload 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.