A JUDIT permite que você monitore processos, CPFs, CNPJs, OAB ou Código(CNJ), mantendo-o atualizado sobre qualquer nova movimentação.

O monitoramento é a automatização das consultas processuais do item anterior.

Diariamente, nossa API busca em todos os tribunais do Brasil processos relacionados ao CPF, CNPJ, OAB ou Código(CNJ) que você está monitorando.

Rota de Monitoramento

Para começar a monitorar um processo, 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:

  • recurrence: A recorrência em dias de atualização dos processos.

  • search: Objeto que vai para a busca.

    • search_type: No contexto de monitoramento processual, o valor dsse campo sempre será lawsuit_cnj.
    • search_key: O número do processo (Código CNJ), CPF, CNPJ, OAB ou NAME que você deseja buscar;
  • with_attachments (opcional): Esse campo define se você quer trazer anexos referente ao processo buscado podendo ser true ou false

    • Obs: Os anexos só serão retornados caso o search_type for lawsuit_cnj.
  • 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;

      *Obs: Caso o parâmetro lawsuit_instance não seja especificado, a busca retornará automaticamente a instância mais recente do processo. Por exemplo, se o processo estiver tramitando tanto na primeira quanto na segunda instância, a busca considerará a segunda instância, por ser a mais atualizada.

  • credential (opcional): Objeto para o uso do cofre de credenciais.

    • customer_key (opcional): Permite passar a chave do usuário que você cadastrou no cofre de credenciais, não seja informado, a API tentará encontrar uma credencial cadastrada para a customer_key vazia.
  • 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.

  • step_terms: Esta propriedade é um array de strings que permite filtrar as movimentações processuais com base em termos específicos. Quando utilizada em conjunto com o monitoramento via webhook, o usuário receberá notificações apenas se algum dos termos especificados for encontrado em uma nova movimentação processual.

Este parâmetro deve ser incluído dentro do objeto chamado notification_filters.

Exemplo de payload com alguns filtros opcionais:

{
	"recurrence": 1,
    "search": {
        "search_type": "lawsuit_cnj",
        "search_key": "1111111-04.1111.1.11.1111"
    },
    "notification_emails": ["teste@teste.com"]
	"notification_filters": {
		"step_terms": [
			'petição',
			'acordo'
		]
	}
}

Exemplo de payload sem filtros:


{
    "recurrence": 1,
    "search": {
        "search_type": "lawsuit_cnj",
        "search_key": "1111111-04.1111.1.11.1111"
    }
}

Aqui está um exemplo de retorno esperado ao criar um monitoramento:

{
    "tracking_id": "d923253e-45c1-46e5-ac70-164839d9851c",
    "user_id": "7f8065a3-4891-428d-9456-dedfc12ff850",
    "status": "created",
    "recurrence": 1,
    "notification_emails": [
        "teste@teste.com"
    ],
    "notification_filters": {
        "step_terms": [],
        "_id": "67ffb7a1062277871357743f"
    },
    "with_attachments": false,
    "plan_config_type": "simple_lawsuit_tracking",
    "fixed_time": false,
    "hour_range": 21,
    "search": {
        "search_type": "lawsuit_cnj",
        "search_key": "1111111-04.1111.1.11.1111",
        "response_type": "lawsuit",
        "search_params": {
            "filter": {},
            "pagination": {}
        }
    },
    "tags": {},
    "created_at": "2025-04-16T13:58:56.352Z",
    "updated_at": "2025-04-16T13:58:56.352Z"
}

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

Aqui está um exemplo de como usar esses parâmetros de consulta com curl:

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

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.

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 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.prod.judit.io/tracking/{monitoramento}" \
-H "api-key: YOUR_API_KEY"
-d '{
  "recurrence": 5,
  "search": {
    "search_type": "lawsuit_cnj",
    "search_key": "1111111-04.1111.1.11.1111"
  }
}'

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 buscar relacionadas 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 de status [‘updating’, ‘paused’];

Aqui está um exemplo de como consultar seus monitoramentos usando curl:

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

Exemplo de notificação de webhook para monitoramento

Obs: Toda movimentação serão notificadas via webhook contendo o processo por completo, incrementando as últimas movimentações.

{
  "_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": "9999999-99.9999.9.99.9999",
      "justice": "8",
      "tribunal": "05",
      "instance": 1,
      "distribution_date": "2024-01-17T15:43:39.000Z",
      "judge": "AUGUSTO YUZO JOUTI",
      "tribunal_acronym": "TJBA",
      "secrecy_level": 0,
      "tags": {
        "crawl_id": "f9b29daf-4cd4-48e9-97cd-0cee91400765"
      },
      "subjects": [
        {
          "code": "7779",
          "name": "INDENIZAÇÃO POR DANO MORAL"
        },
        {
          "code": "6220",
          "name": "RESPONSABILIDADE DO FORNECEDOR"
        },
        {
          "code": "1156",
          "name": "DIREITO DO CONSUMIDOR"
        }
	],
}

Obs 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": "lawsuit_cnj",
        "search_key": "1111111-04.1111.1.11.1111"
    },
    "callback_url": "https://webhook.site/b0ac6522-5bfc-42fa-bebf-a8c2b5ec0999",
    "notification_emails": ["teste@teste.com"],
    "with_attachments": true
}

## 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/{monitoramento}`, substituindo `{monitoramento}` pelo ID do monitoramento que você deseja consultar.

Aqui está um exemplo de como fazer isso usando curl:

```bash
curl -X GET "https://tracking.prod.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": "lawsuit_cnj",
  "search_key": "9999999-99.9999.9.99.9999",
  "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 /tracking/, substituindo 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.prod.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:

{
    "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": [
                    {
                        "attachment_id": "f2f14dca-5b3f-aba2-a9bd95bd367f",
                        "attachment_date": "2025-01-22T15:19:46.000Z",
                        "attachment_name": "id_externo_3",
                        "content": "CÁLCULOS",
                        "extension": "octet-stream",
                        "status": "done",
                        "tags": {
                            "crawl_id": "bf565435-68c6-4b6b-8004-6533cbd0fb8e"
                        },
                        "user_data": null
                    },
                    {
                        "attachment_id": "e26be17f-06ba-9f0c-7fc840e092b1",
                        "attachment_date": "2025-01-22T15:19:46.000Z",
                        "attachment_name": "id_externo_2",
                        "content": "CERTIDÃO DE DÍVIDA ATIVA",
                        "extension": "octet-stream",
                        "status": "done",
                        "tags": {
                            "crawl_id": "bf565435-68c6-4b6b-8004-6533cbd0fb8e"
                        },
                        "user_data": null
                    },
                    {
                        "attachment_id": "54e833a9-58a3-9484-0e6e1cb6c457",
                        "attachment_date": "2025-01-22T15:19:46.000Z",
                        "attachment_name": "id_externo_1",
                        "content": "PETIÇÃO INICIAL",
                        "step_id": "ac8ea79b",
                        "extension": "octet-stream",
                        "status": "done",
                        "tags": {
                            "crawl_id": "bf565435-68c6-4b6b-8004-6533cbd0fb8e"
                        },
                        "user_data": null
                    }
                ],
                "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,
                "status": "Ativo",
                "phase": "Inicial",
                "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,
                "status": "Ativo",
                "phase": "Inicial",
                "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
            }
        }
    ]
}

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.prod.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": "lawsuit_cnj",
  "search_key": "9999999-99.9999.9.99.9999",
  "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.prod.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": "lawsuit_cnj",
  "search_key": "9999999-99.9999.9.99.9999",
  "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 deletar.

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

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

Aqui está um exemplo do 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": "lawsuit_cnj",
  "search_key": "9999999-99.9999.9.99.9999",
  "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"
}

E é isso! Com esses recursos, você pode manter-se atualizado sobre qualquer movimentação em processos judiciais de seu interesse. Se você tiver alguma dúvida ou encontrar algum problema, nossa equipe de suporte está à disposição para ajudá-lo. Entre em contato conosco através do nosso portal de suporte.

Não nos responsabilizamos por consulta por documento inválido, cobranças poderão ser efetuadas decorrente de uso indevido.