> ## 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) ```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 } ``` *** ## 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.