Monitoramento de CPF/CNPJ#

O módulo de Monitoramento de CPF/CNPJ permite acompanhar, de forma contínua, novos processos judiciais associados a documentos CPF ou CNPJ cadastrados pela sua empresa. Quando um processo novo é detectado para um documento monitorado, a API envia um evento via webhook contendo os dados do processo.

Como funciona#

Configurar webhook — registre a URL onde sua empresa receberá as notificações.
Cadastrar documentos — adicione os CPFs/CNPJs que deseja monitorar.
Definir filtros — escolha quais tipos de processo deseja monitorar: cível, trabalhista ou criminal. Essa configuração é feita junto ao time de CS.
Receber eventos — quando um novo processo é detectado para um documento monitorado, a API envia um HTTP POST ao seu webhook com os dados do processo.

Importante

O webhook deve ser configurado antes de cadastrar documentos. Tentativas de criar monitoramentos sem webhook retornam 422 Unprocessable Entity.

Nota

O campo data dos eventos de webhook tem a mesma estrutura de resposta da seção Como consultar, com uma diferença: não inclui o campo pagination, pois o evento já se refere a um processo específico.

Configurar webhook#

Registra a URL de webhook da empresa para recebimento de eventos de monitoramento. Na primeira chamada retorna 201; chamadas subsequentes para atualizar a URL retornam 200.

cURL

curl -X POST 'https://api.consulta-pro.jusbrasil.com.br/monitoring/webhook-config' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: <sua_api_key>' \
  -H 'X-Request-ID: <uuid-v4>' \
  -d '{
    "url": "https://meu-sistema.com.br/webhook/monitoramento"
  }'

**Corpo da requisição**#
Parâmetro	Tipo	Descrição
`url`	string	URL de webhook válida (`https://`). Será chamada via `HTTP POST` quando houver eventos.

Resposta (201 Created ou 200 OK)

{
  "webhook_url": "https://meu-sistema.com.br/webhook/monitoramento",
  "created_at": "2026-04-08T14:30:00Z"
}

Consultar webhook configurado#

cURL

curl -X GET 'https://api.consulta-pro.jusbrasil.com.br/monitoring/webhook-config' \
  -H 'X-API-KEY: <sua_api_key>' \
  -H 'X-Request-ID: <uuid-v4>'

Resposta (200 OK)

{
  "webhook_url": "https://meu-sistema.com.br/webhook/monitoramento",
  "created_at": "2026-04-08T14:30:00Z"
}

Se o webhook não estiver configurado, retorna 404 Not Found.

Cadastrar documento para monitoramento#

Registra um CPF ou CNPJ para monitoramento contínuo. O webhook deve estar configurado antes desta chamada.

cURL

curl -X POST 'https://api.consulta-pro.jusbrasil.com.br/monitoring' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: <sua_api_key>' \
  -H 'X-Request-ID: <uuid-v4>' \
  -d '{
    "document_number": "12345678909"
  }'

**Corpo da requisição**#
Parâmetro	Tipo	Descrição
`document_number`	string	CPF (11 dígitos) ou CNPJ (14 dígitos), apenas números.

Resposta (201 Created)

HTTP/1.1 201 Created
Content-Type: application/json
Location: /monitoring/019d6a59-f499-7e7b-871f-742a5067a5e7

{
  "data": {
    "id_monitoramento": "019d6a59-f499-7e7b-871f-742a5067a5e7",
    "numero_documento": "12345678909",
    "status": "ATIVO",
    "data_criacao": "2026-04-08T15:00:00Z",
    "data_remocao": null
  }
}

Erros comuns:

Código	Descrição
`400`	Documento inválido (não é CPF/CNPJ válido).
`409`	Documento já está sendo monitorado.
`422`	Webhook não configurado. Chame `POST /monitoring/webhook-config` antes.

Consultar monitoramento por ID#

cURL

curl -X GET 'https://api.consulta-pro.jusbrasil.com.br/monitoring/019d6a59-f499-7e7b-871f-742a5067a5e7' \
  -H 'X-API-KEY: <sua_api_key>' \
  -H 'X-Request-ID: <uuid-v4>'

Resposta (200 OK)

{
  "data": {
    "id_monitoramento": "019d6a59-f499-7e7b-871f-742a5067a5e7",
    "numero_documento": "12345678909",
    "status": "ATIVO",
    "data_criacao": "2026-04-08T15:00:00Z",
    "data_remocao": null
  }
}

Se o ID não existir, retorna 404 Not Found.

Listar monitoramentos#

Lista os documentos monitorados pela empresa com paginação baseada em cursor.

cURL

curl -X GET 'https://api.consulta-pro.jusbrasil.com.br/monitoring?status=ATIVO&limit=20' \
  -H 'X-API-KEY: <sua_api_key>' \
  -H 'X-Request-ID: <uuid-v4>'

**Query params**#
Parâmetro	Tipo	Descrição
`document_number`	string (opcional)	Filtrar pelos monitoramentos de um CPF (11 dígitos) ou CNPJ (14 dígitos), apenas números. Pode ser combinado com `status`.
`status`	string (opcional)	Filtrar por `ATIVO` ou `INATIVO`.
`limit`	integer (opcional)	Itens por página (1–100, padrão 20).
`last_id_value`	string (opcional)	Cursor: último ID da página anterior.
`last_sort_value`	string (opcional)	Cursor: último valor de ordenação da página anterior.

Nota

O mesmo CPF/CNPJ pode ter vários monitoramentos ao longo do tempo (por exemplo, ATIVO → INATIVO → ATIVO novamente), cada um com seu próprio id_monitoramento. Por isso o document_number é um atributo filtrável, e não a chave do recurso — o identificador continua sendo o id_monitoramento.

Filtrando por documento

Use document_number para verificar se um CPF/CNPJ está sendo monitorado sem manter controle paralelo do lado do cliente. O filtro é combinável com status:

# Monitoramento ativo de um CPF (se houver)
curl -X GET 'https://api.consulta-pro.jusbrasil.com.br/monitoring?document_number=12345678909&status=ATIVO' \
  -H 'X-API-KEY: <sua_api_key>' \
  -H 'X-Request-ID: <uuid-v4>'

# Histórico completo do CPF (ATIVO + INATIVO) — sem filtro de status
curl -X GET 'https://api.consulta-pro.jusbrasil.com.br/monitoring?document_number=12345678909' \
  -H 'X-API-KEY: <sua_api_key>' \
  -H 'X-Request-ID: <uuid-v4>'

Sem o filtro de status, são retornados todos os monitoramentos do documento (ATIVO e INATIVO), útil para consultar o histórico.

Resposta (200 OK)

{
  "data": [
    {
      "id_monitoramento": "019d6a59-f499-7e7b-871f-742a5067a5e7",
      "numero_documento": "12345678909",
      "status": "ATIVO",
      "data_criacao": "2026-04-08T15:00:00Z",
      "data_remocao": null
    }
  ],
  "_meta": {
    "total": 42,
    "limit": 20,
    "cursor": {
      "last_id_value": "019d6a59-f499-7e7b-871f-742a5067a5e7",
      "last_sort_value": "2026-04-08T15:00:00Z"
    }
  }
}

Para obter a próxima página, envie last_id_value e last_sort_value da resposta anterior como query params.

Erros comuns:

Código	Descrição
`400`	`document_number` inválido: não possui 11 ou 14 dígitos, ou falhou na validação de checksum do CPF/CNPJ.

Remover monitoramento#

Encerra o monitoramento de um documento. O documento passa para o status INATIVO e deixa de gerar eventos de webhook.

Nota

Para retomar o monitoramento do mesmo CPF/CNPJ, basta cadastrá-lo novamente via POST /monitoring. Um novo id_monitoramento será gerado.

cURL

curl -X DELETE 'https://api.consulta-pro.jusbrasil.com.br/monitoring/019d6a59-f499-7e7b-871f-742a5067a5e7' \
  -H 'X-API-KEY: <sua_api_key>' \
  -H 'X-Request-ID: <uuid-v4>'

Resposta (200 OK)

{
  "data": {
    "id_monitoramento": "019d6a59-f499-7e7b-871f-742a5067a5e7",
    "numero_documento": "12345678909",
    "status": "INATIVO",
    "data_criacao": "2026-04-08T15:00:00Z",
    "data_remocao": "2026-04-09T10:00:00Z"
  }
}

Erros comuns:

Código	Descrição
`404`	Monitoramento não encontrado.
`409`	Monitoramento já está inativo.

Parâmetros de resposta do monitoramento#

Parâmetro	Tipo	Descrição
`id_monitoramento`	string	Identificador único do monitoramento (UUID).
`numero_documento`	string	CPF ou CNPJ monitorado.
`status`	string	Status atual: `ATIVO` ou `INATIVO`.
`data_criacao`	string	Data de criação (ISO 8601).
`data_remocao`	string/null	Data de remoção (ISO 8601) ou `null` se ativo.

Eventos de webhook#

Quando um novo processo judicial é detectado para um CPF/CNPJ monitorado, a API envia um HTTP POST ao webhook cadastrado. O corpo da chamada é sempre uma lista de eventos.

Formato do evento#

Cada evento na lista é um objeto JSON com os seguintes atributos:

Campo	Tipo	Descrição
`id`	number	Identificador numérico único do evento.
`evt_type`	number	Tipo do evento. Para monitoramento de CPF/CNPJ o valor é `21`.
`created_at`	string	Data de criação do evento (ISO 8601).
`target_url`	string	URN opaca que identifica o evento. Formato: `urn:cpro:bgc-monitoring:<hash>`.
`target_number`	string	ID do documento monitorado (UUID).
`source_url`	array	Lista com a URL do recurso de monitoramento que originou o evento.
`api_name`	string	Identificador da API de origem (`consulta-pro`).
`data`	object	Dados detalhados do evento (ver estrutura abaixo).

Estrutura do campo `data`#

O campo data segue a mesma estrutura de resposta da consulta por CPF/CNPJ (nome, identificacao, processos), sem o campo pagination.

Cada processo dentro de processos contém os mesmos campos descritos em Parâmetros de resposta processos: tipo_processo, numero_processo, tribunal, UF, comarca, forum, natureza, assunto, classe_processual, valor_causa, ano_do_processo, ano_distribuicao, data_ultima_atualizacao, data_andamento_mais_recente, confianca_associacao, polo_passivo, processo_principal, papel, nome_na_capa, link, partes, advogados, status, tipificacao_identificada, tipificacao e processos_relacionados.

Exemplo de evento recebido via webhook#

[
  {
    "id": 1232782833,
    "evt_type": 21,
    "created_at": "2026-04-08T21:39:06.947967+00:00",
    "api_name": "consulta-pro",
    "target_url": "urn:cpro:bgc-monitoring:a1b2c3d4e5f6a1b2c3d4e5f6",
    "target_number": "019d6a59-f499-7e7b-871f-742a5067a5e7",
    "source_url": [
      "https://api.jusbrasil.com.br/background-check/monitoring/019d6a59-f499-7e7b-871f-742a5067a5e7"
    ],
    "source_user_custom": null,
    "data": {
      "nome": "EMPRESA EXEMPLO S/A",
      "identificacao": {
        "tipo": "CNPJ",
        "valor": "00000000000191"
      },
      "processos": [
        {
          "numero_processo": "0000001-00.2023.8.00.0000",
          "tipo_processo": "CRIMINAL",
          "tribunal": "TJRJ",
          "UF": "RJ",
          "comarca": "Rio de Janeiro",
          "forum": "Vara Criminal",
          "natureza": "Ação Penal",
          "classe_processual": "OUTROS",
          "assunto": "Estelionato",
          "valor_causa": null,
          "ano_do_processo": "2023",
          "ano_distribuicao": "2023",
          "data_ultima_atualizacao": "2026-04-08",
          "data_andamento_mais_recente": "2026-04-06",
          "confianca_associacao": "ALTA",
          "polo_passivo": true,
          "processo_principal": false,
          "papel": "Parte passiva",
          "nome_na_capa": "Empresa Exemplo S/A",
          "link": "https://www.jusbrasil.com.br/consulta-pro/processos/0000001-00.2023.8.00.0000",
          "status": {
            "tribunal": null,
            "inferido": "Ativo",
            "data": "2026-04-08",
            "normalizado": null
          },
          "partes": [
            { "papel": "RÉU", "nome": "João da Silva" },
            { "papel": "POLO PASSIVO (PRINCIPAL)", "nome": "Empresa Exemplo S/A" }
          ],
          "advogados": [
            { "oab": "000000", "nome": "Maria Oliveira" }
          ],
          "processos_relacionados": []
        }
      ]
    }
  }
]

Boas práticas#

Resposta rápida — retorne 200 OK rapidamente e processe os dados de forma assíncrona. Timeouts prolongados podem ser interpretados como falha de entrega.
Link do processo — utilize o campo link dentro de cada processo para acessar a página pública com detalhes completos no Consulta PRO.

Monitoramento de CPF/CNPJ#

Como funciona#

Configurar webhook#

Consultar webhook configurado#

Cadastrar documento para monitoramento#

Consultar monitoramento por ID#

Listar monitoramentos#

Remover monitoramento#

Parâmetros de resposta do monitoramento#

Eventos de webhook#

Formato do evento#

Estrutura do campo data#

Exemplo de evento recebido via webhook#

Boas práticas#

Estrutura do campo `data`#