Monitoramento de Novas Ações por Documento

Novo CNPJ (IN 2229/24)A Judit já aceita o novo formato de CNPJ alfanumérico em conformidade com a Instrução Normativa RFB nº 2229/2024.

Zero esforço: nenhuma alteração é necessária na sua integração.
Ambiente de teste: utilize o documento A1B2C3D4/E5F6-68 para validar o fluxo e receber um processo fictício de resposta.

O Monitoramento por Documento detecta o nascimento de novos processos vinculados a um CPF, CNPJ ou OAB. Diferente do monitoramento por CNJ (que vigia atualizações em um processo conhecido), aqui você descobre processos que ainda não existiam quando você começou a monitorar.

🤖 Endpoint: POST https://tracking.production.judit.io/tracking com search_type em cpf, cnpj ou oab. Sempre que um novo processo for ajuizado e a Judit detectar, você recebe a notificação por webhook.

Quando usar

Vigilância de carteira

Acompanhe um cliente ou contraparte e seja avisado no momento em que houver novo litígio.

Compliance contínuo

Mantenha o KYC vivo: novos processos relevantes contra um fornecedor disparam alerta automático.

Carteira de cobrança

Para grandes carteiras, descubra rapidamente quando o devedor passa a figurar como autor/réu em outras ações.

Inteligência por OAB

Saiba quando um advogado começa a atuar em um novo processo (útil para análise estratégica).

Criando um Monitoramento

Para começar a monitorar um documento, você deve realizar uma solicitação POST para a rota /tracking.

Payload da Solicitação

A solicitação POST deve incluir um payload com as seguintes propriedades:

search_type: Este campo define o tipo de entidade que será buscada. Os valores possíveis são: cpf, cnpj, oab, name, lawsuit_cnj ou lawsuit_id. Para buscas processuais, utilizaremos especificamente cpf, cnpj ou oab, que correspondem ao número do processo.
search_key: O número do processo (Código CNJ), CPF, CNPJ, OAB ou Name que você deseja buscar;
cache_ttl_in_days (opcional): Número inteiro que define até quantos dias o resultado da busca pode considerar um cache válido;
search_params: Um objeto que contém alguns parâmetros da busca como:
- lawsuit_instance (opcional): Este parâmetro permite definir a instância em que deseja buscar o processo;
- masked_response: Define se a resposta virá minificada. Este parâmetro é aplicável apenas a consultas (simples ou completas) por documento no contexto de busca processual.
  - masked_response = true: retornará uma consulta completa
  - masked_response = false: retornará uma consulta simples
*Obs Consulte as condições comerciais desses diferentes tipos de consultas por documento.

Filtros poderão ser adicionados à requisição, permitindo um retorno mais assertivo com base nos valores desejados. Para isso, o parâmetro filter deve ser incluído dentro de search_params, com os seguintes filtros disponíveis:

filter (opcional): Um objeto que contém os filtros para a busca, como:
- side (opcional): Permite buscar por tipos de participantes do processo, podendo ser: Passive, Active, Interested, Unknown;
- amount_gte (opcional): Filtra processos com valor da causa maior ou igual ao especificado em amount_gte;
- amount_lte (opcional): Filtra processos com valor da causa menor ou igual ao especificado em amount_lte;
- tribunals (opcional): Um objeto que contém os filtros de tribunais:
  - keys (opcional): Lista de códigos de tribunais disponíveis na lista de tribunais. Este filtro permite restringir a busca a processos que tenham ou não esses códigos específicos;
  - not_equal (opcional): Valor booleano que define se o filtro incluirá ou excluirá os valores especificados em keys.
- subject_codes (opcional): Um objeto que contém os filtros de assuntos:
  - contains (opcional): Lista de códigos de assuntos. Restringe a busca a processos que incluam os códigos especificados.
  - not_contains (opcional): Lista de códigos de assuntos. Exclui processos que contenham os códigos especificados.
- classification_codes (opcional): Um objeto que contém os filtros de classes processuais:
  - keys (opcional): Lista de códigos de classes processuais. Este filtro permite restringir a busca a processos que tenham ou não esses códigos específicos;
  - not_equal (opcional): Valor booleano que define se o filtro incluirá ou excluirá os valores especificados em keys.
- credential (opcional): Objeto para o uso do cofre de credenciais:
  - customer_key (opcional): Permite passar a chave do usuário cadastrada no cofre de credenciais. Caso não seja informada, a API tentará encontrar uma credencial cadastrada para uma customer_key vazia.
- last_step_date_gte (opcional): Restringe a busca a processos cuja data da última movimentação seja maior que à data fornecida.
- last_step_date_lte (opcional): Restringe a busca a processos cuja data da última movimentação seja menor que à data fornecida.
- party_names (opcional): Lista de nomes que restringe a busca a processos que os contenham em alguma das partes. Obs Ao utilizar esse filtro em conjunto com o filtro de Side, o filtro de Side não será considerado para a restrição dessas partes, já que o filtro de Side é utilizado para filtrar processos onde a parte principal buscada esteja no lado especificado.
- party_documents (opcional): Lista de documentos que restringe a busca a processos que os contenham em alguma das partes. Obs Ao utilizar esse filtro em conjunto com o filtro de Side, o filtro de Side não será considerado para a restrição desses documentos, já que o filtro de Side é utilizado para filtrar processos onde a parte principal buscada esteja no lado especificado.
notification_emails (opcional): Array de strings fora do search que podem ser adicionados emails para os quais deseja receber notificação a cada atualização do monitoramento cadastrado.

Exemplo de payload sem filtros:

curl --location 'https://tracking.production.judit.io/tracking' \
--header 'api-key: <API-KEY>' \
--header 'Content-Type: application/json' \
--data '{
    "recurrence": 1,
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99"
    }
}'

O monitoramento irá ser iniciado a primeira vez, na melhor janela de concorrência de requisição ao tribunal, dentro das próximas 24 horas da data de criação.

Depois ocorrerá de acordo com a frequência cadastrada no campo recurrence. Exemplo de payload com alguns filtros opcionais:

curl --location 'https://tracking.production.judit.io/tracking' \
--header 'api-key: e8f62c5c-7465-426c-abc5-9735c67f25b1' \
--header 'Content-Type: application/json' \
--data '{
    "recurrence": 1,
    "search": {
        "search_type": "cnpj",
        "search_key": "00.000.000/0001-00",
        "search_params": {
            "filter": {
                "subject_codes": {
                    "keys": ["10433"],
                    "not_equal": false
                },
                "classification_codes": {
                    "keys": ["985"],
                    "not_equal": false
                }
            }
        }
    }
}'

Todas os monitoramentos de novas ações processuais cadastradas são realizadas on-demand. Recomendamos verificar as condições de custo associadas a este serviço antes de sua utilização.

Ver exemplo de resposta

{
  "tracking_id": "15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9",
  "user_id": "82082593-c664-4d7b-b174-2f0dc4791daf",
  "status": "created",
  "recurrence": 1,
  "search": {
    "search_type": "cnpj",
    "search_key": "00.000.000/0001-00",
    "response_type": "lawsuit",
    "search_params": {
      "filter": {},
      "pagination": {}
    }
  },
  "hour_range": 21,
  "tracked_items_count": 0,
  "tracked_items_steps_count": 0,
  "tags": {},
  "created_at": "2024-02-21T18:26:38.499Z",
  "updated_at": "2024-02-21T18:26:38.499Z"
}

Na resposta da criação do monitoramento, é retornado o campo hour_range, que indica o horário em que a consulta aos tribunais serão realizada pela primeira vez. No exemplo acima, a primeira consulta está programada para ocorrer às 21 horas.

Consultando Seus Monitoramentos

Para consultar todos os seus monitoramentos, você pode fazer uma solicitação GET para a rota /tracking. Esta rota aceita alguns parâmetros de consulta opcionais para paginar e filtrar os resultados: page: Define a página dos resultados que você deseja consultar. page_size: Define o número máximo de resultados que você deseja receber por página; search_type: retorna monitoramentos do tipo de referência especificado “cpf”, “cnpj”, “oab”, “lawsuit_cnj”, name ou rji; search_key: retorna monitoramentos com a busca relacionada ao número do CPF, CNPJ, OAB ou processo informado; status: retorna monitoramentos cujo status podem ser created, updating, updated, paused ou deleted ou mais de um status ['updating', 'paused']; Aqui está um exemplo de como consultar seus monitoramentos usando curl:

curl -X GET "https://tracking.production.judit.io/tracking?page=1&page_size=10" \
-H "api-key: YOUR_API_KEY"

Consultando o Status de um Monitoramento

Na URL vai o tracking_id retornado na criação do monitoramento:

curl --request GET \
--url "https://tracking.production.judit.io/tracking/15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9" \
--header "api-key: SUA-API-KEY" \
--header "Content-Type: application/json"

Ver exemplo de resposta

{
  "tracking_id": "15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9",
  "user_id": "82082593-c664-4d7b-b174-2f0dc4791daf",
  "status": "created",
  "recurrence": 1,
  "search": {
    "search_type": "cnpj",
    "search_key": "00.000.000/0001-00",
    "response_type": "lawsuit",
    "search_params": {
      "filter": {},
      "pagination": {}
    }
  },
  "tracked_items_count": 0,
  "tracked_items_steps_count": 0,
  "tags": {
    "dashboard_id": null
  },
  "request_id": "05ee9825-b2b4-480b-b29e-f071ca7d9c72",
  "created_at": "2024-02-21T18:26:38.499Z",
  "updated_at": "2024-02-21T18:26:38.499Z"
}

A propriedade status informa a situação atual do monitoramento, podendo ser:

created: Monitoramento criado, porém nunca executado.
updating: Está com uma requisição em processamento.
updated: Monitoramento atualizado já com alguma resposta disponível. O campo updated_at pode informar a data de última atualização do monitoramento e a propriedade request_id o id da última request feita pelo monitoramento.
paused: Monitoramento pausado, podendo ainda ser reativado.
deleted: Monitoramento cancelado e não pode mais ser reativado.

A propriedade request_id só é criada a partir da primeira vez que o monitoramento executou, ou seja, chegou ao status updated.

Atualizando um Monitoramento

Para atualizar um monitoramento, você pode fazer uma solicitação PATCH para a rota /tracking/{monitoramento}, substituindo {monitoramento} pelo ID do monitoramento que você deseja atualizar. Esta rota aceita campos opcionais para atualização do tracking: recurrence, tags e o objeto de search para a busca com exceção de alguns campos. Aqui está um exemplo de como fazer isso usando curl:

curl -X PATCH "https://tracking.production.judit.io/tracking/{monitoramento}" \
-H "api-key: YOUR_API_KEY" \
-d '{
  "recurrence": 5,
  "search": {
    "search_type": "cpf",
    "search_key": "999.999.999-99"
  }
}'

Pausando um Monitoramento

Para pausar um monitoramento, você pode fazer uma solicitação POST para a rota /tracking/{monitoramento}/pause, substituindo {monitoramento} pelo ID do monitoramento que você deseja pausar. Aqui está um exemplo de como pausar o monitoramento usando o curl:

curl -X POST "https://tracking.production.judit.io/tracking/15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9/pause" \
-H "api-key: YOUR_API_KEY"

Aqui está um exemplo de retorno do monitoramento pausado:

{
  "tracking_id": "15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9",
  "user_id": "82082593-c664-4d7b-b174-2f0dc4791daf",
  "status": "paused",
  "recurrence": 1,
  "search": {
    "search_type": "cpf",
    "search_key": "999.999.999-99",
    "response_type": "lawsuit",
    "search_params": {
      "filter": {},
      "pagination": {}
    }
  },
  "tracked_items_count": 0,
  "tracked_items_steps_count": 0,
  "tags": {},
  "created_at": "2024-02-21T18:26:38.499Z",
  "updated_at": "2024-02-21T18:26:38.499Z"
}

Reativando um Monitoramento

Para reativar um monitoramento pausado, você pode fazer uma solicitação POST para a rota /tracking/{monitoramento}/resume, substituindo {monitoramento} pelo ID do monitoramento que você deseja reativar. Aqui está um exemplo de como reativar um monitoramento usando curl:

curl -X POST "https://tracking.production.judit.io/tracking/15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9/resume" \
-H "api-key: YOUR_API_KEY"

Aqui está um exemplo de retorno do monitoramento ativo:

{
  "tracking_id": "15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9",
  "user_id": "82082593-c664-4d7b-b174-2f0dc4791daf",
  "status": "updated",
  "recurrence": 1,
  "search": {
    "search_type": "cpf",
    "search_key": "999.999.999-99",
    "response_type": "lawsuit",
    "search_params": {
      "filter": {},
      "pagination": {}
    }
  },
  "tracked_items_count": 0,
  "tracked_items_steps_count": 0,
  "tags": {},
  "created_at": "2024-02-21T18:26:38.499Z",
  "updated_at": "2024-02-21T18:26:38.499Z"
}

Deletando um Monitoramento

Para deletar um monitoramento, você pode fazer uma solicitação DELETE para a rota /tracking/{monitoramento}, substituindo {monitoramento} pelo ID do monitoramento que você deseja excluir.

A exclusão é definitiva: o tracker para de rodar imediatamente, suas execuções futuras são canceladas e o histórico de respostas vinculadas a ele permanece consultável apenas via GET /responses com o origin_id antigo. Se você só quer suspender temporariamente, use Pausar e depois Reativar.

Aqui está um exemplo de como deletar um monitoramento usando curl:

curl -X DELETE "https://tracking.production.judit.io/tracking/15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9" \
-H "api-key: YOUR_API_KEY"

Aqui está um exemplo de retorno do monitoramento deletado:

{
  "tracking_id": "15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9",
  "user_id": "82082593-c664-4d7b-b174-2f0dc4791daf",
  "status": "deleted",
  "recurrence": 1,
  "search": {
    "search_type": "cpf",
    "search_key": "999.999.999-99",
    "response_type": "lawsuit",
    "search_params": {
      "filter": {},
      "pagination": {}
    }
  },
  "tracked_items_count": 0,
  "tracked_items_steps_count": 0,
  "tags": {},
  "created_at": "2024-02-21T18:26:38.499Z",
  "updated_at": "2024-02-21T18:26:38.499Z"
}

Consultando a resposta gerada pelo monitoramento via pooling

Exemplo de requisição (GET)

curl --location 'https://requests.production.judit.io/responses?page_size=100&request_id=<request_id>' \
  --header 'api-key: '"$JUDIT_API_KEY"

const res = await fetch(
  `https://requests.production.judit.io/responses?page_size=100&request_id=${requestId}`,
  { headers: { "api-key": process.env.JUDIT_API_KEY } }
);
const data = await res.json();
console.log(data.page_data);

<?php
$ch = curl_init('https://requests.production.judit.io/responses?page_size=100&request_id=' . urlencode($requestId));
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['api-key: ' . getenv('JUDIT_API_KEY')],
]);
echo curl_exec($ch);

import os, requests

resp = requests.get(
    "https://requests.production.judit.io/responses",
    params={"request_id": request_id, "page_size": 100},
    headers={"api-key": os.environ["JUDIT_API_KEY"]},
    timeout=15,
)
print(resp.json())

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "os"
)

func main() {
    requestID := "<request_id>"
    base, _ := url.Parse("https://requests.production.judit.io/responses")
    q := base.Query(); q.Set("request_id", requestID); q.Set("page_size", "100")
    base.RawQuery = q.Encode()
    req, _ := http.NewRequest("GET", base.String(), nil)
    req.Header.Set("api-key", os.Getenv("JUDIT_API_KEY"))
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    out, _ := io.ReadAll(res.Body); fmt.Println(string(out))
}

Exemplos de resposta

Ver exemplo de resposta — múltiplos processos detectados (200 OK)

{
    "request_status": "completed",
    "page": 1,
    "page_count": 1,
    "all_pages_count": 1,
    "all_count": 2,
    "page_data": [
        {
            "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "response_id": "a37ca823-e1d2-4de4-a973-ec9e859d21ed",
            "origin": "tracking",
            "origin_id": "cfb61e6e-f2bd-4375-8c87-373405cac6db",
            "response_type": "lawsuit",
            "response_data": {
                "amount": 13687.36,
                "attachments": [],
                "classifications": [
                    {
                        "code": "1116",
                        "name": "EXECUÇÃO FISCAL"
                    }
                ],
                "code": "3000133-12.2025.8.19.0001",
                "county": "TESTE TRIBUNAL",
                "city": "RIO DE JANEIRO",
                "state": "RJ",
                "justice_description": "JUSTIÇA ESTADUAL",
                "created_at": "2025-01-23T16:09:20.134Z",
                "updated_at": "2025-01-24T16:10:56.948Z",
                "distribution_date": "2025-01-22T15:19:46.000Z",
                "free_justice": false,
                "instance": 1,
                "justice": "8",
                "last_step": {
                    "lawsuit_cnj": "3000133-12.2025.8.19.0001",
                    "lawsuit_instance": 1,
                    "private": false,
                    "step_id": "91dc5544",
                    "step_date": "2025-01-22T18:40:18.000Z",
                    "content": "Conclusos para decisão/despacho",
                    "steps_count": 1
                },
                "name": "USUÁRIO EXEMPLO 1 X USUÁRIO EXEMPLO 2",
                "parties": [
                    {
                        "side": "Active",
                        "name": "USUÁRIO EXEMPLO 1",
                        "main_document": "99999999999999",
                        "person_type": "EXEQUENTE",
                        "entity_type": "company",
                        "documents": [
                            {
                                "document": "99999999999999",
                                "document_type": "CNPJ"
                            }
                        ],
                        "lawyers": []
                    },
                    {
                        "side": "Passive",
                        "name": "USUÁRIO EXEMPLO 2",
                        "main_document": "99999999999",
                        "person_type": "EXECUTADO",
                        "entity_type": "company",
                        "documents": [
                            {
                                "document": "99999999999",
                                "document_type": "CPF"
                            }
                        ],
                        "lawyers": []
                    }
                ],
                "related_lawsuits": [],
                "secrecy_level": 0,
                "steps": [],
                "subjects": [
                    {
                        "code": "6017",
                        "name": "DÍVIDA ATIVA (EXECUÇÃO FISCAL)"
                    }
                ],
                "tribunal": "19",
                "tribunal_acronym": "TJRJ"
            },
            "user_id": "98c1d8e0-94bf-43ab-b298-a7158a9efbc9",
            "created_at": "2025-01-24T16:10:53.278Z",
            "tags": {
                "dashboard_id": null
            }
        },
        {
            "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "response_id": "a6690acb-0856-4e4d-ae69-c8d808ce7d9e",
            "origin": "tracking",
            "origin_id": "cfb61e6e-f2bd-4375-8c87-373405cac6db",
            "response_type": "lawsuit",
            "response_data": {
                "amount": 17456.15,
                "attachments": [],
                "classifications": [
                    {
                        "code": "1116",
                        "name": "EXECUÇÃO FISCAL"
                    }
                ],
                "code": "3000233-64.2025.8.19.0001",
                "county": "CAPITAL 12 VARA FAZ PUBLICA",
                "city": "RIO DE JANEIRO",
                "state": "RJ",
                "justice_description": "JUSTIÇA ESTADUAL",
                "created_at": "2025-01-27T16:09:19.112Z",
                "updated_at": "2025-01-27T16:09:19.112Z",
                "distribution_date": "2025-01-24T17:08:03.000Z",
                "free_justice": false,
                "instance": 1,
                "justice": "8",
                "last_step": {
                    "lawsuit_cnj": "3000233-64.2025.8.19.0001",
                    "lawsuit_instance": 1,
                    "private": false,
                    "step_id": "5d93c333",
                    "step_date": "2025-01-27T10:30:20.000Z",
                    "content": "Expedição de Carta pelo Correio - 1 carta",
                    "steps_count": 1
                },
                "name": "USUÁRIO EXEMPLO 3 X USUÁRIO EXEMPLO 4",
                "parties": [
                    {
                        "side": "Active",
                        "name": "USUÁRIO EXEMPLO 3",
                        "main_document": "99999999999999",
                        "person_type": "EXEQUENTE",
                        "entity_type": "company",
                        "documents": [
                            {
                                "document": "99999999999999",
                                "document_type": "CNPJ"
                            }
                        ],
                        "lawyers": []
                    },
                    {
                        "side": "Passive",
                        "name": "USUÁRIO EXEMPLO 4",
                        "main_document": "99999999999",
                        "person_type": "EXECUTADO",
                        "entity_type": "company",
                        "documents": [
                            {
                                "document": "99999999999",
                                "document_type": "CPF"
                            }
                        ],
                        "lawyers": []
                    }
                ],
                "related_lawsuits": [],
                "secrecy_level": 0,
                "steps": [],
                "subjects": [
                    {
                        "code": "6017",
                        "name": "DÍVIDA ATIVA (EXECUÇÃO FISCAL)"
                    }
                ],
                "tribunal": "19",
                "tribunal_acronym": "TJRJ"
            },
            "user_id": "98c1d8e0-94bf-43ab-b298-a7158a9efbc9",
            "created_at": "2025-01-27T16:09:18.752Z",
            "tags": {
                "dashboard_id": null
            }
        }
    ]
}

Recebendo a resposta enviada por webhook para monitoramento

👉 Aprenda a configurar e receber Webhooks aqui

Obs: Cada novo processo distribuído para o documento monitorado será notificado via webhook contendo o processo por completo.

Ver exemplo de resposta

{
  "_id": {
    "$oid": "65f0efe046ad3bda5b27be2d"
  },
  "callback_id": "be1406d9-d62d-402d-8e0e-8684044645de",
  "event_type": "response_created",
  "reference_type": "tracking",
  "reference_id": "8744cfea-f9d4-4e83-801e-bc05003ebf6b",
  "user_id": "ac98336e-c493-4609-a058-cf7114f7a2ed",
  "webhook_id": "2f82201d-1439-436d-8c6a-2e6b3e36a54f",
  "payload": {
    "request_id": "7d50b66c-3e86-4d0b-95af-5ff7561d18ff",
    "response_id": "12576767-d3ea-4ea2-8805-6f2a73ef3439",
    "response_type": "lawsuit",
    "response_data": {
      "code": "3000133-12.2025.8.19.0001",
      "justice": "8",
      "tribunal": "19",
      "tribunal_acronym": "TJRJ",
      "instance": 1,
      "distribution_date": "2025-01-22T15:19:46.000Z",
      "secrecy_level": 0,
      "subjects": [
        {
          "code": "6017",
          "name": "DÍVIDA ATIVA (EXECUÇÃO FISCAL)"
        }
      ],
      "classifications": [
        {
          "code": "1116",
          "name": "EXECUÇÃO FISCAL"
        }
      ],
      "parties": [
        {
          "side": "Active",
          "name": "USUÁRIO EXEMPLO 1",
          "main_document": "99999999999999",
          "person_type": "EXEQUENTE",
          "documents": [
            {
              "document": "99999999999999",
              "document_type": "CNPJ"
            }
          ],
          "lawyers": []
        },
        {
          "side": "Passive",
          "name": "USUÁRIO EXEMPLO 2",
          "main_document": "99999999999",
          "person_type": "EXECUTADO",
          "documents": [
            {
              "document": "99999999999",
              "document_type": "CPF"
            }
          ],
          "lawyers": []
        }
      ],
      "attachments": [],
      "steps": [],
      "amount": 13687.36,
      "state": "RJ",
      "city": "RIO DE JANEIRO",
      "justice_description": "JUSTIÇA ESTADUAL"
    }
  }
}

Para cadastrar seu webhook, entre em contato com a equipe de suporte e solicite a criação. Alternativamente, o webhook também pode ser especificado adicionando o parâmetro callback_url no payload da requisição, conforme o exemplo abaixo:

{
    "recurrence": 1,
    "search": {
        "search_type": "cpf",
        "search_key": "999.999.999-99"
    },
    "callback_url": "https://webhook.site/b0ac6522-5bfc-42fa-bebf-a8c2b5ec0999",
    "notification_emails": ["teste@teste.com"]
}

Consultando Informações de um Monitoramento

Para consultar todas as informações sobre um monitoramento específico, você pode fazer uma solicitação GET para a rota /tracking, passando o tracking_id como parâmetro de consulta. Aqui está um exemplo de como fazer isso usando curl:

curl -X GET "https://tracking.production.judit.io/tracking?tracking_id=15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9" \
-H "api-key: YOUR_API_KEY"

Aqui está o retorno esperado:

{
  "tracking_id": "15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9",
  "user_id": "82082593-c664-4d7b-b174-2f0dc4791daf",
  "status": "updated",
  "recurrence": 1,
  "search": {
    "search_type": "cpf",
    "search_key": "999.999.999-99",
    "response_type": "lawsuit",
    "search_params": {
      "filter": {},
      "pagination": {}
    }
  },
  "tracked_items_count": 0,
  "tracked_items_steps_count": 0,
  "tags": {},
  "created_at": "2024-02-21T18:26:38.499Z",
  "updated_at": "2024-02-21T18:26:38.499Z"
}

Consultando histórico de um monitoramento

Para consultar o histórico de respostas geradas por um monitoramento específico, faça uma solicitação GET para a rota /responses/tracking/{monitoramento}, substituindo {monitoramento} pelo ID do monitoramento desejado. Você pode filtrar os resultados usando os parâmetros created_at_gte e created_at_lte, onde: created_at_gte: define a data inicial da consulta. created_at_lte: define a data final da consulta. Aqui está um exemplo de como fazer isso usando curl:

curl --location 'https://requests.production.judit.io/responses/tracking/<TRACKING_ID>?order=asc&page=1&page_size=50&created_at_gte=2024-03-05T00%3A00%3A00&created_at_lte=2025-03-11T00%3A00%3A00' \
--header 'api-key: <API-KEY>'

Aqui está o retorno esperado:

Ver exemplo de resposta

{
    "request_status": "completed",
    "page": 1,
    "page_count": 2,
    "all_pages_count": 1,
    "all_count": 2,
    "page_data": [
        {
            "request_id": "644a4759-1ae2-48a4-8b09-76afffc75849393",
            "response_id": "a37ca823-e1d2-4de4-a973-ec9e859d21ed",
            "origin": "tracking",
            "origin_id": "cfb61e6e-f2bd-4375-8c87-373405cac6db",
            "response_type": "lawsuit",
            "response_data": {
                "amount": 13687.36,
                "attachments": [],
                "classifications": [
                    {
                        "code": "1116",
                        "name": "EXECUÇÃO FISCAL"
                    }
                ],
                "code": "3000133-12.2025.8.19.0001",
                "county": "TESTE TRIBUNAL",
                "city": "RIO DE JANEIRO",
                "state": "RJ",
                "area": "NÃO INFORMADO",
                "justice_description": "JUSTIÇA ESTADUAL",
                "created_at": "2025-01-23T16:09:20.134Z",
                "updated_at": "2025-01-24T16:10:56.948Z",
                "metadata": {},
                "courts": [
                    {
                        "code": "7798",
                        "name": "TESTE RETORNO TRIUNAL"
                    }
                ],
                "crawler": {
                    "source_name": "JTJ - BR - Document / Lawsuit - Auth",
                    "crawl_id": "8b485368-4315-4247-8314-a6169aa46e0b",
                    "weight": 0,
                    "updated_at": "2025-01-24T16:10:50.024Z"
                },
                "distribution_date": "2025-01-22T15:19:46.000Z",
                "free_justice": false,
                "instance": 1,
                "justice": "8",
                "last_step": {
                    "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                    "lawsuit_instance": 1,
                    "private": false,
                    "step_id": "91dc5544",
                    "step_date": "2025-01-22T18:40:18.000Z",
                    "content": "Conclusos para decisão/despacho",
                    "step_type": "51",
                    "tags": {
                        "crawl_id": "8b485368-4315-4247-8314-a6169aa46e0b"
                    },
                    "steps_count": 1
                },
                "name": "USUÁRIO EXEMPLO 1 X USUÁRIO EXEMPLO 2",
                "parties": [
                    {
                        "side": "Active",
                        "name": "USUÁRIO EXEMPLO 1",
                        "main_document": "99999999999",
                        "person_type": "EXEQUENTE",
                        "entity_type": "company",
                        "documents": [
                            {
                                "document": "99999999999999",
                                "document_type": "CNPJ"
                            }
                        ],
                        "lawyers": [
                            {
                                "name": "USUÁRIO EXEMPLO 3",
                                "main_document": "99999999999",
                                "documents": [
                                    {
                                        "document": "99999999999",
                                        "document_type": "cpf"
                                    }
                                ]
                            }
                        ],
                        "tags": {
                            "crawl_id": "8b485368-4315-4247-8314-a6169aa46e0b"
                        }
                    },
                    {
                        "side": "Passive",
                        "name": "USUÁRIO EXEMPLO 2",
                        "main_document": "99999999999",
                        "person_type": "EXECUTADO",
                        "entity_type": "company",
                        "documents": [
                            {
                                "document": "99999999999999",
                                "document_type": "CNPJ"
                            }
                        ],
                        "tags": {
                            "crawl_id": "8b485368-4315-4247-8314-a6169aa46e0b"
                        },
                        "lawyers": []
                    }
                ],
                "related_lawsuits": [],
                "secrecy_level": 0,
                "steps": [],
                "subjects": [
                    {
                        "code": "6017",
                        "name": "DÍVIDA ATIVA (EXECUÇÃO FISCAL)"
                    },
                    {
                        "code": "5953",
                        "name": "IPVA - IMPOSTO SOBRE PROPRIEDADE DE VEÍCULOS AUTOMOTORES"
                    }
                ],
                "tags": {
                    "crawl_id": "8b485368-4315-4247-8314-a6169aa46e0b",
                    "dictionary_updated_at": "2025-01-24T16:10:50.384Z"
                },
                "tribunal": "19",
                "tribunal_acronym": "TJRJ"
            },
            "user_id": "98c1d8e0-94bf-43ab-b298-a7158a9efbc9",
            "created_at": "2025-01-24T16:10:53.278Z",
            "tags": {
                "dashboard_id": null
            }
        },
        {
            "request_id": "32e0cbb6-71ed-4165-81d5-08ef4dcf80c6",
            "response_id": "a6690acb-0856-4e4d-ae69-c8d808ce7d9e",
            "origin": "tracking",
            "origin_id": "cfb61e6e-f2bd-4375-8c87-373405cac6db",
            "response_type": "lawsuit",
            "response_data": {
                "amount": 17456.15,
                "attachments": [],
                "classifications": [
                    {
                        "code": "1116",
                        "name": "EXECUÇÃO FISCAL"
                    }
                ],
                "code": "3000233-64.2025.8.19.0001",
                "county": "CAPITAL 12 VARA FAZ PUBLICA",
                "city": "RIO DE JANEIRO",
                "state": "RJ",
                "area": "NÃO INFORMADO",
                "justice_description": "JUSTIÇA ESTADUAL",
                "created_at": "2025-01-27T16:09:19.112Z",
                "updated_at": "2025-01-27T16:09:19.112Z",
                "metadata": {},
                "courts": [
                    {
                        "code": "79705",
                        "name": " CAPITAL 17 FAZ PUBLICA"
                    }
                ],
                "crawler": {
                    "source_name": "JTJ - BR - Document / Lawsuit - Auth",
                    "crawl_id": "f9efa845-8501-4804-9595-f01c25fd7ba1",
                    "weight": 0,
                    "updated_at": "2025-01-27T16:09:18.570Z"
                },
                "distribution_date": "2025-01-24T17:08:03.000Z",
                "free_justice": false,
                "instance": 1,
                "justice": "8",
                "last_step": {
                    "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                    "lawsuit_instance": 1,
                    "private": false,
                    "step_id": "5d93c333",
                    "step_date": "2025-01-27T10:30:20.000Z",
                    "content": "Expedição de Carta pelo Correio - 1 carta",
                    "step_type": "60",
                    "tags": {
                        "crawl_id": "f9efa845-8501-4804-9595-f01c25fd7ba1"
                    },
                    "steps_count": 1
                },
                "name": "usuário teste 1 X usuário teste 2",
                "parties": [
                    {
                        "side": "Active",
                        "name": "USUÁRIO 1",
                        "main_document": "99999999999999",
                        "person_type": "EXEQUENTE",
                        "entity_type": "company",
                        "documents": [
                            {
                                "document": "99999999999999",
                                "document_type": "CNPJ"
                            }
                        ],
                        "lawyers": [
                            {
                                "name": "USUÁRIO 2",
                                "main_document": "99999999999",
                                "documents": [
                                    {
                                        "document": "99999999999",
                                        "document_type": "cpf"
                                    }
                                ]
                            }
                        ],
                        "tags": {
                            "crawl_id": "f9efa845-8501-4804-9595-f01c25fd7ba1"
                        }
                    },
                    {
                        "side": "Passive",
                        "name": "USUÁRIO 2",
                        "main_document": "99999999999999",
                        "person_type": "EXECUTADO",
                        "entity_type": "company",
                        "documents": [
                            {
                                "document": "99999999999999",
                                "document_type": "CNPJ"
                            }
                        ],
                        "tags": {
                            "crawl_id": "f9efa845-8501-4804-9595-f01c25fd7ba1"
                        },
                        "lawyers": []
                    }
                ],
                "related_lawsuits": [],
                "secrecy_level": 0,
                "steps": [],
                "subjects": [
                    {
                        "code": "6017",
                        "name": "DÍVIDA ATIVA (EXECUÇÃO FISCAL)"
                    },
                    {
                        "code": "5953",
                        "name": "IPVA - IMPOSTO SOBRE PROPRIEDADE DE VEÍCULOS AUTOMOTORES"
                    }
                ],
                "tags": {
                    "crawl_id": "f9efa845-8501-4804-9595-f01c25fd7ba1",
                    "dictionary_updated_at": "2025-01-27T16:09:19.635Z"
                },
                "tribunal": "19",
                "tribunal_acronym": "TJRJ"
            },
            "user_id": "98c1d8e0-94bf-43ab-b298-a7158a9efbc9",
            "created_at": "2025-01-27T16:09:18.752Z",
            "tags": {
                "dashboard_id": null
            }
        }
    ]
}

Primeiros Passos

Conceitos Fundamentais

Modelo de Dados (Schemas)

Consultas Assíncronas

Consultas Síncronas

Monitoramento

Dados Cadastrais

Consultas Penais

Transferência de Arquivos

Cofre de Credenciais

Webhook

Recursos

Quando usar

Vigilância de carteira

Compliance contínuo

Carteira de cobrança

Inteligência por OAB

Criando um Monitoramento

Payload da Solicitação

Consultando Seus Monitoramentos

Consultando o Status de um Monitoramento

Atualizando um Monitoramento

Pausando um Monitoramento

Reativando um Monitoramento

Deletando um Monitoramento

Consultando a resposta gerada pelo monitoramento via pooling

Exemplo de requisição (GET)

Exemplos de resposta

Recebendo a resposta enviada por webhook para monitoramento

Consultando Informações de um Monitoramento

Consultando histórico de um monitoramento

​Quando usar

Vigilância de carteira

Compliance contínuo

Carteira de cobrança

Inteligência por OAB

​Criando um Monitoramento

​Payload da Solicitação

​Consultando Seus Monitoramentos

​Consultando o Status de um Monitoramento

​Atualizando um Monitoramento

​Pausando um Monitoramento

​Reativando um Monitoramento

​Deletando um Monitoramento

​Consultando a resposta gerada pelo monitoramento via pooling

​Exemplo de requisição (GET)

​Exemplos de resposta

​Recebendo a resposta enviada por webhook para monitoramento

​Consultando Informações de um Monitoramento

​Consultando histórico de um monitoramento

Quando usar

Criando um Monitoramento

Payload da Solicitação

Consultando Seus Monitoramentos

Consultando o Status de um Monitoramento

Atualizando um Monitoramento

Pausando um Monitoramento

Reativando um Monitoramento

Deletando um Monitoramento

Consultando a resposta gerada pelo monitoramento via pooling

Exemplo de requisição (GET)

Exemplos de resposta

Recebendo a resposta enviada por webhook para monitoramento

Consultando Informações de um Monitoramento

Consultando histórico de um monitoramento