### Callback Content Example

Source: https://api.escavador.com/v2/docs/callbacks

This example shows the JSON payload structure for a 'nova_movimentacao' event. It includes details about the monitoring, the movement found, and its source.

```json
{
    "event": "nova_movimentacao",
    "monitoramento": {
        "id": 1567024,
        "numero": "1002089-72.2023.8.26.0260",
        "criado_em": "2024-10-02T18:01:34+00:00",
        "data_ultima_verificacao": null,
        "tribunais": [
            {
                "id": 102,
                "nome": "Tribunal de Justiça de São Paulo",
                "sigla": "TJSP",
                "categoria": null
            }
        ],
        "frequencia": "DIARIA",
        "status": "ENCONTRADO"
    },
    "movimentacao": {
        "id": 23895909833,
        "data": "2024-10-01",
        "tipo": "ANDAMENTO",
        "tipo_publicacao": null,
        "classificacao_predita": {
            "nome": "Antecipação de tutela",
            "descricao": "É a decisão que concede o pedido de tutela antecipada formulado pela parte. Pode ocorrer em momento liminar (antes da oitiva do Réu) ou durante o curso do processo.",
            "hierarquia": "Movimentações do Magistrado > Decisão > Concessão > Antecipação de tutela"
        },
        "conteudo": "Pedido de Liminar/Antecipação de Tutela",
        "texto_categoria": null,
        "fonte": {
            "processo_fonte_id": 538793371,
            "fonte_id": 1,
            "nome": "Tribunal de Justiça de São Paulo",
            "tipo": "TRIBUNAL",
            "sigla": "TJSP",
            "grau": 1,
            "grau_formatado": "Primeiro Grau"
        }
    },
    "uuid": "65b45990e91de83f8f40483102ce97ca"
}
```

--------------------------------

### API Request with Body and Query Parameters

Source: https://api.escavador.com/v2/docs/collection.json

This example demonstrates an API request using GET method with both a JSON request body and query parameters. It includes headers for content type and authorization.

```http
GET /api/v2/envolvido/processos?cpf_cnpj=03636198000192&ordem=desc HTTP/1.1
Host: api.escavador.com
Content-Type: application/json
Authorization: Bearer {{token}}
X-Requested-With: XMLHttpRequest

{
    "tribunais": [
        "TRF1",
        "TJSP"
    ]
}
```

--------------------------------

### Payload Example - New Process Found

Source: https://api.escavador.com/v2/docs/callbacks

Example JSON payload for the 'novo_processo' event, containing details about the monitoring and the newly found process.

```json
{
    "event": "novo_processo",
    "monitoramento": {
        "id": 11,
        "termo": "Fulano da Silva",
        "criado_em": "2024-01-18T15:15:08+00:00",
        "variacoes": [],
        "termos_auxiliares": []
    },
    "processo": {
        "numero_cnj": "0008649-70.2021.8.12.0110",
        "data_inicio": "2021-10-06",
        "tribunal": "TJMS",
        "estado_origem": {
            "nome": "Mato Grosso do Sul",
            "sigla": "MS"
        }
    },
    "uuid": "e774c93cbef5bbaab6bc6707f2609167"
}
```

--------------------------------

### Create Process Monitoring (cURL)

Source: https://api.escavador.com/v2/docs/monitoramento-de-processos

Example of creating a process monitoring using cURL. Includes optional tribunal and frequency parameters.

```Bash
curl -X POST "https://api.escavador.com/api/v2/monitoramentos/processos" \
  -H "Authorization: Bearer {{token}}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "numero": "0000001-00.0000.0.00.0000",
    "tribunal": "",
    "frequencia": ""
}'
```

--------------------------------

### Authentication Header Example

Source: https://api.escavador.com/v2/docs/index

Demonstrates the correct format for the Authorization header when using a generated Bearer token.

```http
Authorization: Bearer {seu-token-gerado}
```

--------------------------------

### List Callbacks (Python SDK)

Source: https://api.escavador.com/v2/docs/callback

Example of listing callbacks using the Escavador Python SDK. Requires API key configuration and authentication.

```python
from escavador import *\nimport datetime\nconfig("API_KEY")\n\nresponse = Callback().callbacks(\n  data_maxima=datetime.datetime(2019, 10, 23, 7, 1, 22),\n  data_minima=datetime.datetime(2019, 9, 23, 7, 1, 22),\n  evento="resultado_busca_assincrona",\n  item_tipo="busca_assincrona",\n  item_id=100,\n  status=StatusCallback.SUCESSO\n)
```

--------------------------------

### Create Process Monitoring (JavaScript)

Source: https://api.escavador.com/v2/docs/monitoramento-de-processos

Example of creating a process monitoring using JavaScript's fetch API. Demonstrates setting headers and sending JSON data.

```JavaScript
fetch("https://api.escavador.com/api/v2/monitoramentos/processos", {
  method: "POST",
  headers:   {
      "Accept": "application/json",
      "Authorization": "Bearer {{token}}",
      "Content-Type": "application/json"
  },
  body: JSON.stringify(  {
      "numero": "0000001-00.0000.0.00.0000",
      "tribunal": "",
      "frequencia": ""
  })
})
  .then(response => response.json())
  .then(data => console.log(data));
```

--------------------------------

### API Response Examples

Source: https://api.escavador.com/v2/docs/certificados-digitais

Examples of successful (HTTP 200) and unauthorized (HTTP 401) responses for the digital certificates listing endpoint.

```json
{
  "items": [
    {
      "id": 17,
      "nome": "ANA MARIA",
      "cpf": "11111111111",
      "criado_em": "2025-06-10T13:40:27+00:00",
      "expira_em": "2026-06-10T00:00:00+00:00"
    }
  ],
  "links": {
    "next": null,
    "prev": null,
    "first": "https://api.escavador.com/api/v2/certificados?page=1",
    "last": "https://api.escavador.com/api/v2/certificados?page=1"
  },
  "paginator": {
    "current_page": 1,
    "per_page": 20,
    "total": 1,
    "total_pages": 1
  }
}
```

```json
{
  "error": "Unauthenticated"
}
```

--------------------------------

### Create New Process Monitoring (JavaScript)

Source: https://api.escavador.com/v2/docs/monitoramento-de-novos-processos

This JavaScript fetch example demonstrates how to create a new process monitoring via the API. It includes setting the necessary headers and sending the request body as a JSON string.

```javascript
fetch("https://api.escavador.com/api/v2/monitoramentos/novos-processos", {
  method: "POST",
  headers:   {
      "Accept": "application/json",
      "Authorization": "Bearer {{token}}",
      "Content-Type": "application/json"
  },
  body: JSON.stringify(  {
      "termo": "João",
      "variacoes": [
          "João",
          "Joãozinho"
      ],
      "termos_auxiliares": [
          {
              "condicao": "CONTEM",
              "termo": "Maria"
          },
          {
              "condicao": "NAO_CONTEM",
              "termo": "João"
          },
          {
              "condicao": "CONTEM_ALGUMA",
              "termo": "José"
          }
      ],
      "tribunais": [
          "TJSP",
          "TJMG"
      ]
  })
})
  .then(response => response.json())
  .then(data => console.log(data));
```

--------------------------------

### Payload Example - Process Update Completed

Source: https://api.escavador.com/v2/docs/callbacks

Example JSON payload for the 'atualizacao_processo_concluida' event, detailing the update status and process information.

```json
{
    "event": "atualizacao_processo_concluida",
    "atualizacao": {
        "id": 22,
        "status": "SUCESSO",
        "criado_em": "2024-02-07T17:07:44+00:00",
        "numero_cnj": "0011699-83.2017.5.15.0087",
        "concluido_em": "2024-02-07T17:08:46+00:00",
        "enviar_callback": "SIM"
    },
    "uuid": "65b45990e91de83f8f40483102ce97ca"
}
```

--------------------------------

### Create Process Monitoring (PHP)

Source: https://api.escavador.com/v2/docs/monitoramento-de-processos

Example of creating a process monitoring using PHP with the Guzzle HTTP client. Shows how to set request headers and send JSON payload.

```PHP
$client = new \GuzzleHttp\Client();

$response = $client->request("POST", "https://api.escavador.com/api/v2/monitoramentos/processos", [
    'headers' => [
        'Accept' => 'application/json',
        'Authorization' => 'Bearer {{token}}',
        'Content-Type' => 'application/json',
    ],
    'json' => [
        'numero' => '0000001-00.0000.0.00.0000',
        'tribunal' => '',
        'frequencia' => '',
    ],
]);

echo $response->getBody()->getContents();
```

--------------------------------

### Create Digital Certificate with 2FA (Python)

Source: https://api.escavador.com/v2/docs/certificados-digitais

This Python example demonstrates how to send a POST request to create a digital certificate, including 2FA configurations. The `requests` library is used for the HTTP call.

```python
import requests

url = "https://api.escavador.com/api/v2/certificados"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer {{token}}"
}
json_data = {
    "certificado": "example",
    "senha": "123456",
    "autenticacoes": [
        "example"
    ],
    "autenticacoes[].tribunal": "TRF2",
    "autenticacoes[].sistemas": [
        "EPROC-TRF2",
        "EPROC-SJRJ"
    ],
    "autenticacoes[].secret_2fa": "JBSWY3DPEHPK3PXP"
}

response = requests.request(
    "POST",
    url,
    headers=headers,
    json=json_data,
)

print(response.json())

```

--------------------------------

### API Escavador v2 Callback Payload Example

Source: https://api.escavador.com/v2/docs/callbacks

This JSON payload represents an example of the data received when a process is not found. It includes details about the event, monitoring information, and a unique UUID.

```json
{
    "event": "processo_nao_encontrado",
    "monitoramento": {
        "id": 1567024,
        "numero": "1002089-72.2023.8.26.0260",
        "criado_em": "2024-10-02T18:01:34+00:00",
        "data_ultima_verificacao": null,
        "tribunais": [
            {
                "id": 102,
                "nome": "Tribunal de Justiça de São Paulo",
                "sigla": "TJSP",
                "categoria": null
            }
        ],
        "frequencia": "DIARIA",
        "status": "NAO_ENCONTRADO"
    },
    "uuid": "65b45990e91de83f8f40483102ce97ca"
}
```

--------------------------------

### Orchestration Example for Intelligent Summary

Source: https://api.escavador.com/v2/docs/fluxo-resumo-processos-ia

This pseudocode demonstrates a recommended integration sequence for obtaining an intelligent process summary. It includes requesting the summary, polling its status with exponential backoff, and finally fetching the summary upon completion or handling timeouts and failures.

```javascript
async function obterResumoInteligente(numeroCnj, token) {
  await solicitarResumo(numeroCnj, token); // POST

  const maxTentativas = 12;
  let esperaMs = 5000;

  for (let tentativa = 1; tentativa <= maxTentativas; tentativa++) {
    const status = await consultarStatusResumo(numeroCnj, token); // GET status

    if (status === "CONCLUIDO") {
      return await buscarResumo(numeroCnj, token); // GET resumo
    }

    if (status === "FALHA") {
      throw new Error("Falha na geração do resumo inteligente");
    }

    await new Promise((r) => setTimeout(r, esperaMs));
    esperaMs = Math.min(esperaMs + 3000, 30000);
  }

  throw new Error("Timeout ao aguardar conclusão do resumo inteligente");
}
```

--------------------------------

### Monitoring with Auxiliary Terms and Variations Response Example

Source: https://api.escavador.com/v2/docs/monitoramento-de-novos-processos

This example demonstrates a successful monitoring creation that includes both auxiliary terms and variations. This allows for complex filtering based on primary terms, variations, and specific conditions.

```json
{
    "id": 112,
    "termo": "Fulano de tal",
    "tipo": "TERMO",
    "criado_em": "2023-11-23 18:15:13",
    "variacoes": [
        " de tal",
        " de tal e tal"
    ],
    "termos_auxiliares": {
        "CONTEM": [ "Fulano" ],
        "NAO_CONTEM": [ "Fulano de tal" ],
        "CONTEM_ALGUMA": [ "Fulano", "Fulano de tal" ]
    }
}
```

--------------------------------

### Requisição GET para Status de Atualização de Processo (Bash)

Source: https://api.escavador.com/v2/docs/atualizacao-de-processos

Exemplo de como fazer uma requisição GET para o endpoint de status de atualização de processo usando cURL. Inclui o cabeçalho de autorização.

```bash
curl -X GET "https://api.escavador.com/api/v2/processos/numero_cnj/0000000-00.0000.0.00.0000/status-atualizacao" \
  -H "Authorization: Bearer {{token}}" \
  -H "Accept: application/json"
```

--------------------------------

### Listar Monitoramentos de Novos Processos (Python)

Source: https://api.escavador.com/v2/docs/monitoramento-de-novos-processos

Utilize este snippet para listar todos os monitoramentos de novos processos associados à sua conta. Certifique-se de incluir seu token de autenticação no cabeçalho.

```python
import requests

url = "https://api.escavador.com/api/v2/monitoramentos/novos-processos"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer {{token}}"
}

response = requests.request(
    "GET",
    url,
    headers=headers,
)

print(response.json())
```

--------------------------------

### Requisição GET para Listar Monitoramentos (Python)

Source: https://api.escavador.com/v2/docs/monitoramento-de-processos

Exemplo de como fazer uma requisição GET para a API de monitoramento de processos usando a biblioteca `requests` em Python. Inclui a configuração de headers para aceitar JSON e autorização.

```python
import requests

url = "https://api.escavador.com/api/v2/monitoramentos/processos"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer {{token}}"
}

response = requests.request(
    "GET",
    url,
    headers=headers,
)

print(response.json())
```

--------------------------------

### Solicitar atualização de processos em lote

Source: https://api.escavador.com/v2/docs/atualizacao-de-processos

Solicita a atualização de múltiplos processos nos sistemas dos Tribunais. Permite definir configurações globais (como download de autos ou uso de credenciais) que serão aplicadas a todos os processos do lote. Cada processo do lote será validado individualmente. Se um processo já possuir uma atualização recente ou em andamento, ele será identificado na resposta de erro do lote. A cobrança é realizada individualmente por processo criado.

```APIDOC
## POST /api/v2/processos/lote/solicitar-atualizacao

### Description
Solicita a atualização de múltiplos processos nos sistemas dos Tribunais, permitindo a configuração de opções globais para o lote.

### Method
POST

### Endpoint
/api/v2/processos/lote/solicitar-atualizacao

### Parameters
#### Request Body
- **processos** (array) - Obrigatório - Lista de objetos contendo os números dos processos.
- **enviar_callback** (boolean) - Opcional - Se `enviar_callback=1`, um callback será enviado para sua URL configurada para cada processo que concluir a atualização.
- **documentos_publicos** (boolean) - Opcional - Se `documentos_publicos=1`, serão baixados os documentos públicos para todos os processos do lote.
- **autos** (boolean) - Opcional - Se `autos=1`, baixa os autos completos dos processos do lote. Requer credenciais (`utilizar_certificado=1` ou `usuario` e `senha`) e não pode ser usado com `documentos_publicos`.
- **utilizar_certificado** (boolean) - Opcional - Se `utilizar_certificado=1`, a autenticação das buscas que exigem login será feita com certificado digital.
- **certificado_id** (integer) - Opcional - Se `utilizar_certificado=1`, você pode informar o ID do certificado a ser usado no lote. Se não for informado, um certificado válido cadastrado será selecionado aleatoriamente.
- **usuario** (string) - Opcional - Usuário de acesso utilizado em cada busca aos tribunais deste lote (quando aplicável).
- **senha** (string) - Opcional - Senha de acesso utilizada em cada busca aos tribunais deste lote (quando aplicável).
- **ignorar_atualizados** (boolean) - Opcional - Se `ignorar_atualizados=1`, processos com atualização recente ou em andamento são ignorados sem erro individual; o lote só retorna erro se nenhum processo puder ser processado.

### Request Example
```json
{
  "processos": [
    {"numero_cnj": "0000000-00.0000.0.00.0000"},
    {"numero_cnj": "1111111-11.1111.1.11.1111"}
  ],
  "enviar_callback": true,
  "documentos_publicos": true,
  "autos": false,
  "utilizar_certificado": false,
  "certificado_id": null,
  "usuario": "seu_usuario",
  "senha": "sua_senha",
  "ignorar_atualizados": false
}
```
```

--------------------------------

### Requisição GET para Status de Atualização de Processo (PHP)

Source: https://api.escavador.com/v2/docs/atualizacao-de-processos

Exemplo de como fazer uma requisição GET para o endpoint de status de atualização de processo usando Guzzle HTTP em PHP. O cabeçalho de autorização é obrigatório.

```php
$client = new \GuzzleHttp\Client();

$response = $client->request("GET", "https://api.escavador.com/api/v2/processos/numero_cnj/0000000-00.0000.0.00.0000/status-atualizacao", [
    'headers' => [
        'Accept' => 'application/json',
        'Authorization' => 'Bearer {{token}}',
    ],
]);

echo $response->getBody()->getContents();
```

--------------------------------

### Exemplo de Resposta de Monitoramento de Novos Processos

Source: https://api.escavador.com/v2/docs/monitoramento-de-novos-processos

Este é um exemplo de resposta bem-sucedida ao buscar um monitoramento de novos processos. A resposta inclui detalhes como ID, termo, data de criação e listas de variações e termos auxiliares.

```json
{
    "id": 111,
    "termo": "Fulano",
    "criado_em": "2023-11-23T18:12:12+00:00",
    "variacoes": [],
    "termos_auxiliares": [],
    "tribunais_especificos": []
}
```

```json
{
    "id": 112,
    "termo": "Fulano de tal",
    "tipo": "TERMO",
    "criado_em": "2023-11-23 18:15:13",
    "variacoes": [
        " de tal",
        " de tal e tal"
    ]
}
```

```json
{
    "id": 112,
    "termo": "Fulano de tal",
    "tipo": "TERMO",
    "criado_em": "2023-11-23 18:15:13",
    "termos_auxiliares": {
        "CONTEM": [ "Fulano" ],
        "NAO_CONTEM": [ "Fulano de tal" ],
        "CONTEM_ALGUMA": [ "Fulano", "Fulano de tal" ]
    }
}
```

```json
{
    "id": 112,
    "termo": "Fulano de tal",
    "tipo": "TERMO",
    "criado_em": "2023-11-23 18:15:13",
    "variacoes": [
        " de tal",
        " de tal e tal"
    ],
    "termos_auxiliares": {
        "CONTEM": [ "Fulano" ],
        "NAO_CONTEM": [ "Fulano de tal" ],
        "CONTEM_ALGUMA": [ "Fulano", "Fulano de tal" ]
    }
}
```

--------------------------------

### Buscar Monitoramento de Novos Processos (JavaScript)

Source: https://api.escavador.com/v2/docs/monitoramento-de-novos-processos

Exemplo de requisição usando `fetch` em JavaScript para obter dados de um monitoramento de novos processos. Inclui cabeçalhos de aceitação e autorização.

```javascript
fetch("https://api.escavador.com/api/v2/monitoramentos/novos-processos/1", {
  method: "GET",
  headers:   {
      "Accept": "application/json",
      "Authorization": "Bearer {{token}}"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
```

--------------------------------

### Requisição GET para Status de Atualização de Processo (JavaScript)

Source: https://api.escavador.com/v2/docs/atualizacao-de-processos

Exemplo de como fazer uma requisição GET para o endpoint de status de atualização de processo usando `fetch` em JavaScript. Certifique-se de incluir o cabeçalho de autorização.

```javascript
fetch("https://api.escavador.com/api/v2/processos/numero_cnj/0000000-00.0000.0.00.0000/status-atualizacao", {
  method: "GET",
  headers:   {
      "Accept": "application/json",
      "Authorization": "Bearer {{token}}"
  }
})
  .then(response => response.json())
  .then(data => console.log(data));
```

--------------------------------

### Requisição GET para Status de Atualização de Processo (Python)

Source: https://api.escavador.com/v2/docs/atualizacao-de-processos

Exemplo de como fazer uma requisição GET para o endpoint de status de atualização de processo usando a biblioteca `requests` em Python. O cabeçalho de autorização deve ser fornecido.

```python
import requests

url = "https://api.escavador.com/api/v2/processos/numero_cnj/0000000-00.0000.0.00.0000/status-atualizacao"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer {{token}}"
}

response = requests.request(
    "GET",
    url,
    headers=headers,
)


```

--------------------------------

### List Callbacks (Bash)

Source: https://api.escavador.com/v2/docs/callback

Example of listing callbacks with specific filters using curl. Requires authentication.

```bash
curl -X GET "https://api.escavador.com/api/v2/callbacks?data_maxima=2019-10-23+07%3A01%3A22&data_minima=2019-09-23+07%3A01%3A22&evento=resultado_busca_assincrona&item_tipo=busca_assincrona&item_id=101&status=sucesso" \
  -H "Authorization: Bearer {{token}}" \
  -H "Accept: application/json"
```

--------------------------------

### Configurar Autenticações de Certificado (PHP)

Source: https://api.escavador.com/v2/docs/certificados-digitais

Utilize este exemplo para configurar autenticações de 2FA ou atualizar segredos de sistemas vinculados a um certificado específico. Certifique-se de que os valores de 'tribunal' e 'sistemas' sejam válidos consultando as rotas de listagem.

```php
<?php

use GuzzleHttp\Client;
use GuzzleHttp\Psr7\Request;

$client = new Client();

$options = [
    'headers' => [
        'Accept' => 'application/json',
        'Authorization' => 'Bearer {{token}}',
        'Content-Type' => 'application/json',
    ],
    'json' => [
        'autenticacoes' => 'example',
        'autenticacoes[].tribunal' => 'TRF2',
        'autenticacoes[].sistemas' => '["EPROC-TRF2", "EPROC-SJRJ"]',
        'autenticacoes[].secret_2fa' => 'JBSWY3DPEHPK3PXP',
    ],
];

$request = new Request('POST', 'https://api.escavador.com/api/v2/certificados/248/autenticacoes');
$response = $client->send($request, $options);

echo $response->getBody()->getContents();

```

--------------------------------

### List Callbacks (Python)

Source: https://api.escavador.com/v2/docs/callback

Example of listing callbacks with specific filters using the requests library. Requires authentication.

```python
import requests\n\nurl = "https://api.escavador.com/api/v2/callbacks"\nheaders = {\n    "Accept": "application/json",\n    "Authorization": "Bearer {{token}}"\n}\nparams = {\n    "data_maxima": "2019-10-23 07:01:22",\n    "data_minima": "2019-09-23 07:01:22",\n    "evento": "resultado_busca_assincrona",\n    "item_tipo": "busca_assincrona",\n    "item_id": 101,\n    "status": "sucesso"\n}\n\nresponse = requests.request(\n    "GET",\n    url,\n    headers=headers,\n    params=params,\n)\n\nprint(response.json())
```

--------------------------------

### List Callbacks (JavaScript)

Source: https://api.escavador.com/v2/docs/callback

Example of listing callbacks with specific filters using fetch API. Requires authentication.

```javascript
fetch("https://api.escavador.com/api/v2/callbacks?data_maxima=2019-10-23+07%3A01%3A22&data_minima=2019-09-23+07%3A01%3A22&evento=resultado_busca_assincrona&item_tipo=busca_assincrona&item_id=101&status=sucesso", {\n  method: "GET",\n  headers:   {\n      "Accept": "application/json",\n      "Authorization": "Bearer {{token}}"\n  }\n})\n  .then(response => response.json())\n  .then(data => console.log(data));
```

--------------------------------

### Configurar Autenticações de Certificado (Python)

Source: https://api.escavador.com/v2/docs/certificados-digitais

Este script Python demonstra como enviar uma requisição POST para configurar autenticações de 2FA ou atualizar segredos de sistemas para um certificado. É necessário fornecer um token de autenticação válido e os dados corretos para 'tribunal' e 'sistemas'.

```python
import requests

url = "https://api.escavador.com/api/v2/certificados/248/autenticacoes"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer {{token}}"
}
json_data = {
    "autenticacoes": "example",
    "autenticacoes[].tribunal": "TRF2",
    "autenticacoes[].sistemas": "[\"EPROC-TRF2\", \"EPROC-SJRJ\"]",
    "autenticacoes[].secret_2fa": "JBSWY3DPEHPK3PXP"
}

response = requests.request(
    "POST",
    url,
    headers=headers,
    json=json_data,
)

print(response.json())

```

--------------------------------

### List Callbacks (PHP)

Source: https://api.escavador.com/v2/docs/callback

Example of listing callbacks with specific filters using Guzzle HTTP client. Requires authentication.

```php
$client = new \GuzzleHttp\Client();\n\n$response = $client->request("GET", "https://api.escavador.com/api/v2/callbacks", [\n    'headers' => [\n        'Accept' => 'application/json',\n        'Authorization' => 'Bearer {{token}}',\n    ],\n    'query' => [\n        'data_maxima' => '2019-10-23 07:01:22',\n        'data_minima' => '2019-09-23 07:01:22',\n        'evento' => 'resultado_busca_assincrona',\n        'item_tipo' => 'busca_assincrona',\n        'item_id' => 101,\n        'status' => 'sucesso',\n    ],\n]);\n\necho $response->getBody()->getContents();
```

--------------------------------

### Listar Resultados de Monitoramento de Novos Processos

Source: https://api.escavador.com/v2/docs/monitoramento-de-novos-processos

Use este endpoint para buscar os resultados de um monitoramento de novos processos existente, identificado por seu ID. Certifique-se de incluir seu token de autenticação na requisição.

```bash
curl -X GET "https://api.escavador.com/api/v2/monitoramentos/novos-processos/1/resultados" \
  -H "Authorization: Bearer {{token}}" \
  -H "Accept: application/json"
```

--------------------------------

### Successful Batch Creation Response

Source: https://api.escavador.com/v2/docs/atualizacao-de-processos

This is an example of a successfully created batch response. It indicates the status of the batch and the individual processes within it.

```APIDOC
## HTTP 200 OK

### Description
Request processed successfully.

### Response
#### Success Response (200)
- **id** (integer) - The unique identifier for the batch.
- **status_geral** (string) - The overall status of the batch (e.g., "PENDENTE").
- **criado_em** (string) - The timestamp when the batch was created.
- **total** (integer) - The total number of processes in the batch.
- **pendente** (integer) - The number of processes pending.
- **sucesso** (integer) - The number of processes that were successfully updated.
- **nao_encontrado** (integer) - The number of processes not found.
- **erro** (integer) - The number of processes with errors.
- **processos** (object) - An object containing lists of processes by status.
  - **pendente** (array) - List of processes that are pending.
  - **sucesso** (array) - List of processes that were successful.
  - **nao_encontrado** (array) - List of processes not found.
  - **erro** (array) - List of processes with errors.

### Response Example
```json
{
    "id": 56,
    "status_geral": "PENDENTE",
    "criado_em": "2026-02-10T14:22:25+00:00",
    "total": 3,
    "pendente": 3,
    "sucesso": 0,
    "nao_encontrado": 0,
    "erro": 0,
    "processos": {
        "pendente": [
            {
                "numero_cnj": "08025173520198230010"
            },
            {
                "numero_cnj": "30012639320168060072"
            },
            {
                "numero_cnj": "10300069720158260114"
            }
        ],
        "sucesso": [],
        "nao_encontrado": [],
        "erro": []
    }
}
```
```

--------------------------------

### Buscar Monitoramento de Processo por ID

Source: https://api.escavador.com/v2/docs/monitoramento-de-processos

Use este endpoint para recuperar os detalhes de um monitoramento de processo específico usando seu ID. Certifique-se de incluir seu token de autenticação no cabeçalho.

```Bash
curl -X GET "https://api.escavador.com/api/v2/monitoramentos/processos/1" \
  -H "Authorization: Bearer {{token}}" \
  -H "Accept: application/json"
```

--------------------------------

### POST /api/v2/processos/lote/solicitar-atualizacao

Source: https://api.escavador.com/v2/docs/atualizacao-de-processos

Solicita a atualização de múltiplos processos nos sistemas dos Tribunais. Permite definir configurações globais que serão aplicadas a todos os processos do lote. Cada processo será validado individualmente.

```APIDOC
## POST /api/v2/processos/lote/solicitar-atualizacao

### Descrição
Solicita a atualização de múltiplos processos nos sistemas dos Tribunais. Permite definir configurações globais (como download de autos ou uso de credenciais) que serão aplicadas a todos os processos do lote. Cada processo do lote será validado individualmente. Se um processo já possuir uma atualização recente ou em andamento, ele será identificado na resposta de erro do lote. A cobrança é realizada individualmente por processo criado.

### Method
POST

### Endpoint
`/api/v2/processos/lote/solicitar-atualizacao`

### Parameters
#### Request Body
- **processos** (array) - Required - Lista de objetos contendo os números dos processos.
- **enviar_callback** (boolean) - Optional - Se `enviar_callback=true`, um callback será enviado para sua URL configurada para cada processo que concluir a atualização.
- **documentos_publicos** (boolean) - Optional - Se `documentos_publicos=true`, serão baixados os documentos públicos para todos os processos do lote.
- **autos** (boolean) - Optional - Se `autos=true`, baixa os autos completos dos processos do lote. Requer credenciais (`utilizar_certificado=true` ou `usuario` e `senha`) e não pode ser usado com `documentos_publicos`.
- **utilizar_certificado** (boolean) - Optional - Se `utilizar_certificado=true`, a autenticação das buscas que exigem login será feita com certificado digital.
- **certificado_id** (integer) - Optional - Se `utilizar_certificado=true`, você pode informar o ID do certificado a ser usado no lote. Se não for informado, um certificado válido cadastrado será selecionado aleatoriamente.
- **usuario** (string) - Optional - Usuário de acesso utilizado em cada busca aos tribunais deste lote (quando aplicável).
- **senha** (string) - Optional - Senha de acesso utilizada em cada busca aos tribunais deste lote (quando aplicável).
- **ignorar_atualizados** (boolean) - Optional - Se `ignorar_atualizados=true`, processos com atualização recente ou em andamento são ignorados sem erro individual; o lote só retorna erro se nenhum processo puder ser processado.

### Request Example
```json
{
  "processos": [
    {"numero_cnj": "0000000-00.0000.0.00.0000"},
    {"numero_cnj": "1111111-11.1111.1.11.1111"}
  ],
  "enviar_callback": true,
  "documentos_publicos": true,
  "autos": false,
  "utilizar_certificado": false,
  "certificado_id": null,
  "usuario": "seu_usuario",
  "senha": "sua_senha",
  "ignorar_atualizados": false
}
```

### Response
#### Success Response (200)
- **id** (integer) - O ID único do lote de atualização.
- **status_geral** (string) - O status geral do lote (ex: PENDENTE, CONCLUIDO).
- **criado_em** (string) - Data e hora de criação do lote.
- **total** (integer) - Número total de processos no lote.
- **pendente** (integer) - Número de processos pendentes de processamento.
- **sucesso** (integer) - Número de processos processados com sucesso.
- **nao_encontrado** (integer) - Número de processos não encontrados.
- **erro** (integer) - Número de processos que resultaram em erro.
- **processos** (object) - Detalhes sobre o status de cada processo no lote.
  - **pendente** (array) - Lista de processos pendentes.
  - **sucesso** (array) - Lista de processos processados com sucesso.
  - **nao_encontrado** (array) - Lista de processos não encontrados.
  - **erro** (array) - Lista de processos que resultaram em erro.

#### Response Example (200)
```json
{
  "id": 56,
  "status_geral": "PENDENTE",
  "criado_em": "2026-02-10T14:22:25+00:00",
  "total": 3,
  "pendente": 3,
  "sucesso": 0,
  "nao_encontrado": 0,
  "erro": 0,
  "processos": {
    "pendente": [
      {"numero_cnj": "08025173520198230010"},
      {"numero_cnj": "30012639320168060072"},
      {"numero_cnj": "10300069720158260114"}
    ],
    "sucesso": [],
    "nao_encontrado": [],
    "erro": []
  }
}
```

#### Error Response (422)
- **code** (string) - Código do erro.
- **message** (string) - Mensagem geral do erro.
- **errors** (object) - Detalhes específicos dos erros por campo.

#### Response Example (422 - Formato Inválido)
```json
{
  "code": "UNPROCESSABLE_ENTITY",
  "message": "Não foi possível processar a solicitação",
  "errors": {
    "processos.0.numero_cnj": [
      "O número do processo não está no formato CNJ."
    ]
  },
  "appends": null
}
```

#### Response Example (422 - Atualização Recente/Em Andamento)
```json
{
  "code": "UNPROCESSABLE_ENTITY",
  "message": "Não foi possível processar a solicitação",
  "errors": {
    "0802517-35.2019.8.23.0010": {
      "message": "Esse processo já está sendo atualizado.",
      "appends": {
        "ultima_verificacao": {
          "id": 519,
          "status": "NA_FILA",
          "motivo_erro": null,
          "criado_em": "2026-02-10T16:01:05+00:00",
          "numero_cnj": "0802517-35.2019.8.23.0010",
          "concluido_em": null,
          "opcoes": [],
          "enviar_callback": "NAO"
        }
      }
    },
    "3001263-93.2016.8.06.0072": {
      "message": "Esse processo já está sendo atualizado.",
      "appends": {
        "ultima_verificacao": {
          "id": 520,
          "status": "NA_FILA",
          "motivo_erro": null,
          "criado_em": "2026-02-10T16:01:05+00:00",
          "numero_cnj": "3001263-93.2016.8.06.0072",
          "concluido_em": null,
          "opcoes": [],
          "enviar_callback": "NAO"
        }
      }
    },
    "1030006-97.2015.8.26.0114": {
      "message": "Esse processo já está sendo atualizado.",
      "appends": {
        "ultima_verificacao": {
          "id": 455,
          "status": "NA_FILA",
          "motivo_erro": null,
          "criado_em": "2026-02-10T14:22:25+00:00",
          "numero_cnj": "1030006-97.2015.8.26.0114",
          "concluido_em": null,
          "opcoes": [],
          "enviar_callback": "NAO"
        }
      }
    }
  },
  "appends": null
}
```

#### Error Response (401)
- **error** (string) - Mensagem indicando autenticação falha.

#### Response Example (401)
```json
{
  "error": "Unauthenticated"
}
```

#### Error Response (402)
- **error** (string) - Mensagem indicando falta de saldo em crédito da API.

#### Response Example (402)
```json
{
  "error": "Você não possui saldo em crédito da API."
}
```
```

--------------------------------

### Resend Callback (Python SDK)

Source: https://api.escavador.com/v2/docs/callback

Example of resending a callback using the Escavador Python SDK. Requires API key configuration.

```python
from escavador import *\nconfig("API_KEY")\n\nresponse = Callback().reenviar(\n  id=1\n)
```