Monitoramento de processos

Acompanhe processos pelo número CNJ e receba cada movimentação ou publicação nova, sem consultar de novo.

Entrada: Número CNJResposta imediata

Quando usar

Carteira de processos

Mantenha o seu sistema jurídico atualizado sem rotinas de consulta diária.

Prazos e intimações

Receba as publicações do Diário assim que forem capturadas.

Cobrança e recuperação

Saiba na hora quando um processo de execução anda.

Integração com ERP

Use o externalId para ligar cada evento à pasta do seu sistema.

Como é cobrado

Não precisa de plano. Cada processo é pago pelo saldo da carteira na ativação e renovado automaticamente a cada 30 dias. Sem saldo na renovação, o processo é pausado e o webhook recebe monitoring.paused.

Preço por volume

O valor por processo cai conforme a quantidade de processos ativos pela API: até 4.999, R$ 2,46; a partir de 5.000, R$ 1,96; de 10.000, R$ 1,74; de 20.000, R$ 1,40; de 50.000, R$ 0,98. A faixa vale para todos os processos ativos da conta.

Mantenha saldo na carteira

Sem saldo para o período, o cadastro responde 402 com o código INSUFFICIENT_BALANCE. Cadastrar de novo um processo que já está ativo não cobra.

Webhook ou consulta

Configure um webhook para receber os eventos na hora, ou chame a lista de eventos com o cursor quando for conveniente. Os dois funcionam juntos.

Limite de requisições

Cada conta pode fazer até 120 requisições por minuto nestes endpoints. Acima disso a resposta é 429 com o cabeçalho Retry-After.

Passo 1

Monitorar um processo

POST/api/partner/v2/monitorings

Coloca um processo no monitoramento da sua conta. A partir daí, cada movimentação ou publicação nova vira um evento, entregue no seu webhook e disponível em GET /api/partner/v2/monitorings/{id}/events.

Importante:

Não exige plano: cada processo é pago pelo saldo da carteira, por períodos de 30 dias
O valor por processo segue a tabela por volume de processos ativos pela API na conta (veja a página de Monitoramento na documentação)
A renovação é automática no fim de cada período (paidUntil). Sem saldo, o processo fica paused e o webhook recebe monitoring.paused
Processo já monitorado pela conta é devolvido com created: false, sem nova cobrança
Reativar um processo pausado ou encerrado dentro do período já pago não cobra de novo
Se a ativação falhar, o valor volta para o saldo automaticamente

Corpo da requisição

Campo	Tipo	Descrição
`cnj` obrigatório	string	Número CNJ, com ou sem pontuação. Ex.: `00012347120248260100`
`instance` opcional	string	Instância do processo. `123` Ex.: `1`
`externalId` opcional	string	Identificador do processo no seu sistema. Volta em todos os eventos. Ex.: `pasta-4471`

cnjstringobrigatório
Número CNJ, com ou sem pontuação.
Ex.: 00012347120248260100
instancestringopcional
Instância do processo.
123
Ex.: 1
externalIdstringopcional
Identificador do processo no seu sistema. Volta em todos os eventos.
Ex.: pasta-4471

Respostas

200Processo já estava monitorado (created false). Na primeira ativação a resposta é 201 com o mesmo formato.
400CNJ, instância ou externalId inválidos
401Token ausente ou inválido
402Saldo da carteira insuficiente para o período de 30 dias (INSUFFICIENT_BALANCE)
403E-mail da conta não verificado ou processo com restrição de privacidade
429Limite de 120 requisições por minuto atingido (RATE_LIMITED)
503Serviço de monitoramento indisponível no momento; nada foi cobrado

Requisição

curl -X POST "https://consultadeprocessos.com.br/api/partner/v2/monitorings" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{"cnj":"00012347120248260100"}'

Resposta · 200

{
  "created": true,
  "data": {
    "id": "1842",
    "cnj": "00012347120248260100",
    "instance": "1",
    "status": "active",
    "externalId": "pasta-4471",
    "court": "TJSP",
    "createdAt": "2026-10-15T13:20:00.000Z",
    "lastSyncAt": null,
    "lastMovementAt": null,
    "paidUntil": "2026-11-14T13:20:00.000Z"
  }
}

Passo 2

Monitorar em lote

POST/api/partner/v2/monitorings/batch

Cadastra até 500 processos numa chamada. Cada item tem o mesmo formato do cadastro individual e recebe o próprio resultado, na mesma ordem do envio.

Se o saldo acabar no meio do lote, os itens restantes voltam com INSUFFICIENT_BALANCE e não são cobrados.

Corpo da requisição

Campo	Tipo	Descrição
`items` obrigatório	object[]
`items[].cnj` obrigatório	string	Número CNJ, com ou sem pontuação. Ex.: `00012347120248260100`
`items[].instance` opcional	string	Instância do processo. `123` Ex.: `1`
`items[].externalId` opcional	string	Identificador do processo no seu sistema. Volta em todos os eventos. Ex.: `pasta-4471`

itemsobject[]obrigatório
items[].cnjstringobrigatório
Número CNJ, com ou sem pontuação.
Ex.: 00012347120248260100
items[].instancestringopcional
Instância do processo.
123
Ex.: 1
items[].externalIdstringopcional
Identificador do processo no seu sistema. Volta em todos os eventos.
Ex.: pasta-4471

Respostas

200Lote processado (veja o resultado de cada item)
400Corpo sem a lista items
413Mais de 500 itens
422Nenhum item foi aceito

Campos da resposta (22)

Campo	Tipo	Descrição
`summary`	object
`summary.total`	integer
`summary.created`	integer
`summary.alreadyActive`	integer
`summary.failed`	integer
`results`	object[]
`results[].index`	integer	Posição do item no envio.
`results[].ok`	boolean
`results[].created`	boolean
`results[].data`	object
`results[].data.id`	string	Identificador do monitoramento. Ex.: `1842`
`results[].data.cnj`	string	Ex.: `00012347120248260100`
`results[].data.instance`	string	Ex.: `1`
`results[].data.status`	string	paused: a renovação encontrou a carteira sem saldo. Cadastre de novo para reativar. `activepauseddeletedexpiredcancelled`
`results[].data.externalId`	string \| null
`results[].data.court`	string \| null	Tribunal ou órgão do processo.
`results[].data.createdAt`	string \| null
`results[].data.lastSyncAt`	string \| null	Última verificação do processo.
`results[].data.lastMovementAt`	string \| null	Data da movimentação mais recente conhecida.
`results[].data.paidUntil`	string \| null	Fim do período pago. A renovação de 30 dias é cobrada da carteira nessa data.
`results[].code`	string	Código do erro quando ok é false.
`results[].message`	string

summaryobject
summary.totalinteger
summary.createdinteger
summary.alreadyActiveinteger
summary.failedinteger
resultsobject[]
results[].indexinteger
Posição do item no envio.
results[].okboolean
results[].createdboolean
results[].dataobject
results[].data.idstring
Identificador do monitoramento.
Ex.: 1842
results[].data.cnjstring
Ex.: 00012347120248260100
results[].data.instancestring
Ex.: 1
results[].data.statusstring
paused: a renovação encontrou a carteira sem saldo. Cadastre de novo para reativar.
activepauseddeletedexpiredcancelled
results[].data.externalIdstring | null
results[].data.courtstring | null
Tribunal ou órgão do processo.
results[].data.createdAtstring | null
results[].data.lastSyncAtstring | null
Última verificação do processo.
results[].data.lastMovementAtstring | null
Data da movimentação mais recente conhecida.
results[].data.paidUntilstring | null
Fim do período pago. A renovação de 30 dias é cobrada da carteira nessa data.
results[].codestring
Código do erro quando ok é false.
results[].messagestring

Requisição

curl -X POST "https://consultadeprocessos.com.br/api/partner/v2/monitorings/batch" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"cnj":"00012347120248260100","externalId":"pasta-4471"},{"cnj":"10009871120238190001","instance":"2"}]}'

Resposta · 200

{
  "summary": {
    "total": 2,
    "created": 1,
    "alreadyActive": 0,
    "failed": 1
  },
  "results": [
    {
      "index": 0,
      "ok": true,
      "created": true,
      "data": {
        "id": "1842",
        "cnj": "00012347120248260100",
        "instance": "1",
        "status": "active",
        "externalId": "pasta-4471",
        "court": "TJSP",
        "createdAt": "2026-10-15T13:20:00.000Z",
        "lastSyncAt": null,
        "lastMovementAt": null,
        "paidUntil": "2026-11-14T13:20:00.000Z"
      }
    },
    {
      "index": 1,
      "ok": false,
      "code": "INVALID_INPUT",
      "message": "CNJ inválido."
    }
  ]
}

Passo 3

Listar monitorados

GET/api/partner/v2/monitorings

Lista os monitoramentos da conta, do mais recente para o mais antigo. Sem status, traz os ativos e os pausados. Para a próxima página, envie o nextCursor recebido.

Parâmetros de consulta

Campo	Tipo	Descrição
`status` opcional	string	Filtra por situação. `activepauseddeletedexpiredcancelled`
`cnj` opcional	string	Filtra por número CNJ.
`externalId` opcional	string	Filtra pelo identificador do seu sistema.
`limit` opcional	integer	Itens por página.
`cursor` opcional	string	nextCursor da página anterior.

statusstringopcional
Filtra por situação.
activepauseddeletedexpiredcancelled
cnjstringopcional
Filtra por número CNJ.
externalIdstringopcional
Filtra pelo identificador do seu sistema.
limitintegeropcional
Itens por página.
cursorstringopcional
nextCursor da página anterior.

Respostas

200Página de monitoramentos
401Token ausente ou inválido

Campos da resposta (12)

Campo	Tipo	Descrição
`data`	object[]
`data[].id`	string	Identificador do monitoramento. Ex.: `1842`
`data[].cnj`	string	Ex.: `00012347120248260100`
`data[].instance`	string	Ex.: `1`
`data[].status`	string	paused: a renovação encontrou a carteira sem saldo. Cadastre de novo para reativar. `activepauseddeletedexpiredcancelled`
`data[].externalId`	string \| null
`data[].court`	string \| null	Tribunal ou órgão do processo.
`data[].createdAt`	string \| null
`data[].lastSyncAt`	string \| null	Última verificação do processo.
`data[].lastMovementAt`	string \| null	Data da movimentação mais recente conhecida.
`data[].paidUntil`	string \| null	Fim do período pago. A renovação de 30 dias é cobrada da carteira nessa data.
`nextCursor`	string \| null	Cursor da próxima página; null quando acabou.

dataobject[]
data[].idstring
Identificador do monitoramento.
Ex.: 1842
data[].cnjstring
Ex.: 00012347120248260100
data[].instancestring
Ex.: 1
data[].statusstring
paused: a renovação encontrou a carteira sem saldo. Cadastre de novo para reativar.
activepauseddeletedexpiredcancelled
data[].externalIdstring | null
data[].courtstring | null
Tribunal ou órgão do processo.
data[].createdAtstring | null
data[].lastSyncAtstring | null
Última verificação do processo.
data[].lastMovementAtstring | null
Data da movimentação mais recente conhecida.
data[].paidUntilstring | null
Fim do período pago. A renovação de 30 dias é cobrada da carteira nessa data.
nextCursorstring | null
Cursor da próxima página; null quando acabou.

Requisição

curl -X GET "https://consultadeprocessos.com.br/api/partner/v2/monitorings" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Passo 4

Consultar um monitoramento

GET/api/partner/v2/monitorings/{id}

Consultar um monitoramento.

Parâmetros do caminho

Campo	Tipo	Descrição
`id` obrigatório	string	id devolvido no cadastro.

idstringobrigatório
id devolvido no cadastro.

Respostas

200Monitoramento
404Monitoramento não encontrado na conta

Campos da resposta (11)

Campo	Tipo	Descrição
`data`	object
`data.id`	string	Identificador do monitoramento. Ex.: `1842`
`data.cnj`	string	Ex.: `00012347120248260100`
`data.instance`	string	Ex.: `1`
`data.status`	string	paused: a renovação encontrou a carteira sem saldo. Cadastre de novo para reativar. `activepauseddeletedexpiredcancelled`
`data.externalId`	string \| null
`data.court`	string \| null	Tribunal ou órgão do processo.
`data.createdAt`	string \| null
`data.lastSyncAt`	string \| null	Última verificação do processo.
`data.lastMovementAt`	string \| null	Data da movimentação mais recente conhecida.
`data.paidUntil`	string \| null	Fim do período pago. A renovação de 30 dias é cobrada da carteira nessa data.

dataobject
data.idstring
Identificador do monitoramento.
Ex.: 1842
data.cnjstring
Ex.: 00012347120248260100
data.instancestring
Ex.: 1
data.statusstring
paused: a renovação encontrou a carteira sem saldo. Cadastre de novo para reativar.
activepauseddeletedexpiredcancelled
data.externalIdstring | null
data.courtstring | null
Tribunal ou órgão do processo.
data.createdAtstring | null
data.lastSyncAtstring | null
Última verificação do processo.
data.lastMovementAtstring | null
Data da movimentação mais recente conhecida.
data.paidUntilstring | null
Fim do período pago. A renovação de 30 dias é cobrada da carteira nessa data.

Requisição

curl -X GET "https://consultadeprocessos.com.br/api/partner/v2/monitorings/1842" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Passo 5

Listar eventos do processo

GET/api/partner/v2/monitorings/{id}/events

Movimentações e publicações do processo, na ordem em que foram capturadas. Serve para quem prefere consultar periodicamente em vez de receber webhook.

Na primeira chamada, envie since (ou nada, para o histórico completo). Guarde o nextCursor e mande de volta na chamada seguinte: a resposta traz só o que chegou depois. Enquanto hasMore for true, há mais itens para buscar na hora.

Parâmetros do caminho

Campo	Tipo	Descrição
`id` obrigatório	string	id do monitoramento.

idstringobrigatório
id do monitoramento.

Parâmetros de consulta

Campo	Tipo	Descrição
`since` opcional	string	Só eventos capturados depois desta data (ISO 8601). Ignorado quando há cursor.
`cursor` opcional	string	nextCursor da chamada anterior.
`limit` opcional	integer	Itens por página.

sincestringopcional
Só eventos capturados depois desta data (ISO 8601). Ignorado quando há cursor.
cursorstringopcional
nextCursor da chamada anterior.
limitintegeropcional
Itens por página.

Respostas

200Página de eventos
400since inválido
404Monitoramento não encontrado na conta

Campos da resposta (17)

Campo	Tipo	Descrição
`data`	object[]
`data[].id`	string
`data[].type`	string	movement: andamento no tribunal. publication: intimação ou comunicação no Diário de Justiça.
`data[].cnj`	string
`data[].instance`	string
`data[].date`	string \| null	Data do ato no tribunal.
`data[].capturedAt`	string	Quando o evento foi capturado.
`data[].title`	string \| null
`data[].description`	string \| null
`data[].publication`	object	Só em eventos do tipo publication.
`data[].publication.court`	string
`data[].publication.kind`	string	Tipo da comunicação (ex.: Intimação).
`data[].publication.body`	string \| null	Órgão julgador.
`data[].publication.text`	string
`data[].publication.link`	string \| null
`nextCursor`	string \| null	Guarde e envie na próxima chamada.
`hasMore`	boolean

dataobject[]
data[].idstring
data[].typestring
movement: andamento no tribunal. publication: intimação ou comunicação no Diário de Justiça.
data[].cnjstring
data[].instancestring
data[].datestring | null
Data do ato no tribunal.
data[].capturedAtstring
Quando o evento foi capturado.
data[].titlestring | null
data[].descriptionstring | null
data[].publicationobject
Só em eventos do tipo publication.
data[].publication.courtstring
data[].publication.kindstring
Tipo da comunicação (ex.: Intimação).
data[].publication.bodystring | null
Órgão julgador.
data[].publication.textstring
data[].publication.linkstring | null
nextCursorstring | null
Guarde e envie na próxima chamada.
hasMoreboolean

Requisição

curl -X GET "https://consultadeprocessos.com.br/api/partner/v2/monitorings/1842/events" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Resposta · 200

{
  "data": [
    {
      "id": "cm9a1b2c30001xy12abcd3456",
      "type": "movement",
      "cnj": "00012347120248260100",
      "instance": "1",
      "date": "2026-10-14T00:00:00.000Z",
      "capturedAt": "2026-10-15T09:12:44.000Z",
      "title": "Conclusos para despacho",
      "description": "Conclusos para despacho"
    }
  ],
  "nextCursor": "MjAyNi0xMC0xNVQwOToxMjo0NC4wMDBafG1vdmVtZW50fGNtOWExYjJjMw",
  "hasMore": false
}

Passo 6

Parar de monitorar

DELETE/api/partner/v2/monitorings/{id}

Encerra o monitoramento. O processo deixa de gerar eventos e não é renovado. Não há estorno do período em andamento; cadastrar o mesmo CNJ de novo dentro desse período não cobra.

Parâmetros do caminho

Campo	Tipo	Descrição
`id` obrigatório	string	id devolvido no cadastro.

idstringobrigatório
id devolvido no cadastro.

Respostas

200Monitoramento encerrado (status deleted)
404Monitoramento não encontrado na conta

Campos da resposta (11)

Campo	Tipo	Descrição
`data`	object
`data.id`	string	Identificador do monitoramento. Ex.: `1842`
`data.cnj`	string	Ex.: `00012347120248260100`
`data.instance`	string	Ex.: `1`
`data.status`	string	paused: a renovação encontrou a carteira sem saldo. Cadastre de novo para reativar. `activepauseddeletedexpiredcancelled`
`data.externalId`	string \| null
`data.court`	string \| null	Tribunal ou órgão do processo.
`data.createdAt`	string \| null
`data.lastSyncAt`	string \| null	Última verificação do processo.
`data.lastMovementAt`	string \| null	Data da movimentação mais recente conhecida.
`data.paidUntil`	string \| null	Fim do período pago. A renovação de 30 dias é cobrada da carteira nessa data.

dataobject
data.idstring
Identificador do monitoramento.
Ex.: 1842
data.cnjstring
Ex.: 00012347120248260100
data.instancestring
Ex.: 1
data.statusstring
paused: a renovação encontrou a carteira sem saldo. Cadastre de novo para reativar.
activepauseddeletedexpiredcancelled
data.externalIdstring | null
data.courtstring | null
Tribunal ou órgão do processo.
data.createdAtstring | null
data.lastSyncAtstring | null
Última verificação do processo.
data.lastMovementAtstring | null
Data da movimentação mais recente conhecida.
data.paidUntilstring | null
Fim do período pago. A renovação de 30 dias é cobrada da carteira nessa data.

Requisição

curl -X DELETE "https://consultadeprocessos.com.br/api/partner/v2/monitorings/1842" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

O que a resposta traz

Monitoramento

Identificador do monitoramento
id
Número do processo e instância
cnj, instance
Situação (ativo, pausado, encerrado)
status
Identificador do seu sistema
externalId
Última movimentação conhecida
lastMovementAt

Eventos

Movimentação ou publicação
type
Data do ato e data da captura
date, capturedAt
Texto do andamento
title, description
Dados da publicação no Diário
publication

Sem cobrança em caso de falha

Se a consulta terminar com erro, o valor volta para o saldo automaticamente.

Próximos passos

Autenticação

Gere a chave e envie no cabeçalho.

Erros e códigos

Como tratar cada resposta de erro.

Cobrança e reembolso

Quando cobramos e quando o valor volta.

Webhook de monitoramento

Receba os eventos dos processos monitorados no seu servidor, com assinatura e novas tentativas automáticas.