Monitoramento de Novas Ações por Documento - JUDIT

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
            }
        }
    ]
}

​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