API & Desenvolvedores

Monitoramento processual embutido no seu produto.

Lawtechs, SaaS jurídicos e sistemas corporativos: as watchlists, os eventos e os webhooks do Rastreador.si ficam a uma chamada de distância — com contrato versionado, idempotência e envelope com trilha de evidência em cada resposta.

A superfície

Três grupos de recursos, um token

Autenticação pelo Vertikon ID com escopo por integração; consumo medido por tenant. Os endpoints abaixo são o contrato de referência do produto — versionados, com changelog publicado.

Watchlists

Criar, listar, atualizar e arquivar monitoramentos por número CNJ, com identificador externo, restrição por tribunal e instâncias suportadas.

POST /v1/processes/watchlistsGET …/events

Eventos

Histórico de movimentações e publicações por watchlist, filtrável por janela de tempo e tribunal, com carimbo duplo e id de rastreio.

GET /v1/processes/eventsdedupe nativo

Webhooks

Entregas assinadas dos eventos que você escolher, com retry e log de entrega. Assinatura dupla no header para verificação do emissor.

POST /v1/webhooksretry + log
Receitas

Do token ao primeiro evento

1. Registrar um processo para monitoramento

terminal — curlrastreador.si
curl -X POST https://api.rastreador.si/v1/processes/watchlists \
  -H "Authorization: Bearer $VTK_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: caso-000123-registro" \
  -d '{
    "numero_cnj": "0001234-56.2026.8.16.0001",
    "tribunal": "tjpr",
    "instancias": [1, 2],
    "movimentacoes": true,
    "publicacoes_dje": true,
    "id_externo": "pasta-cliente-000123"
  }'

# 201 Created — o processo entra na malha de coleta
# na frequência do plano. id_externo volta em cada evento.

2. O evento chegando no seu webhook

seu webhook — payloadevento
{
  "event": "process.movement",
  "watchlist_id": "wl_01hxc9…",
  "id_externo": "pasta-cliente-000123",
  "processo": {
    "numero_cnj": "0001234-56.2026.8.16.0001",
    "tribunal": "tjpr", "instancia": 1
  },
  "movimento_em": "2026-11-04T09:41:00-03:00",
  "coletado_em":  "2026-11-04T09:44:12-03:00",
  "tipo": "juntada",
  "fonte": "datajud:tjpr",
  "evento_id": "evt_01hxd2…",
  "prazo_auxiliar": { "norma": "CPC art. 224", … }
}

// carimbo duplo: quando aconteceu × quando vimos.
// headers: RAST-Signature (HMAC) + Idempotency-Key.

Exemplos ilustrativos do contrato de referência. A documentação canônica de endpoints, schemas e changelog acompanha a chave de API — e o envelope mínimo (request_id, tenant_id derivado da sessão, data_as_of, warnings, usage, audit_id) é o mesmo em todas as respostas.

Para agentes de IA

MCP: o rastreador como ferramenta do seu agente

O ecossistema expõe os serviços por MCP — o agente consulta watchlists e eventos com o escopo que você autorizar. Ferramentas com efeito externo começam deny-by-default: a IA não cria as próprias permissões.

  • Escopos explícitos: watchlists.read, events.read — leitura por padrão; criar e alterar monitoramento exige escopo concedido.
  • Auditoria por chamada: cada uso da ferramenta fica na trilha do tenant, com ator e resultado.
  • Sem efeito externo sem humano: o agente não envia comunicação a partes nem toma ato processual — só lê e organiza.
mcp.jsonagente
{
  "mcpServers": {
    "rastreador": {
      "command": "mcp-vertikon",
      "args": ["--service", "rastreador.si"],
      "env": { "VTK_TOKEN": "<do NeoVault>" }
    }
  }
}

// ferramentas expostas ao agente:
// watchlists.list, events.by_process,
// events.since(t) — todas read-only por padrão
Perguntas de integração

O que todo integrador pergunta

Movimentação é o ato registrado no processo (juntada, despacho, decisão); publicação é a disponibilização no Diário da Justiça Eletrônico, que costuma iniciar prazos. Monitoramos as duas — quando as fontes entregam as duas — e deduplicamos quando é o mesmo ato visto pelos dois caminhos.
Não como promessa universal. A API pública do DataJud entrega metadados de processos públicos; documentos e anexos dependem do que cada tribunal disponibiliza e das regras de sigilo. O que cada fonte entrega está na página de transparência — sem “tudo, sempre”.
Busca por documento é um produto distinto do monitoramento por número de processo — com cobertura, custos e controles de finalidade próprios (pesquisa massiva por identificador tem regras específicas de LGPD e abuso). O núcleo do Rastreador.si é o monitoramento de processos que você registrou; consultas por entidade entram como capacidade contratada à parte, com a cobertura declarada.
A fonte entra em estado degradado, visível no painel de cobertura e reportado pelo status da fonte na API. Não marcamos o monitoramento como “atualizado” quando a coleta não aconteceu — o atraso é declarado, não maquiado.
Por serviço efetivamente usado, em reais: consulta processual, busca por CPF/CNPJ/OAB e processo monitorado por mês — medidos por tenant, com contagem prévia grátis e custo devolvido em cada resposta. Webhooks não custam nada. Nada amarrado a valor de causa, honorários ou resultado do litígio. Detalhes nos planos da API.

Sua lawtech não deveria manter
um coletor de tribunais.

Registre os processos, receba os eventos, gaste sua equipe no que é o seu produto. A malha de coleta é o nosso.

Ver planos de API Conferir a cobertura