API ProcessOnline

COMO FUNCIONA

1. Verifique o processo (existe? qual tribunal/partes?) — grátis.
2. Solicite a cópia — consome 1 crédito (ou a cota mensal, no plano fatura).
3. Nosso robô obtém os autos no tribunal (segundos, se já temos em cache; caso contrário, minutos).
4. Avisamos seu sistema pelo webhook quando fica pronto.
5. Baixe o PDF por uma URL assinada (o arquivo fica disponível por 7 dias).

Recebe um documento (CPF de 11 dígitos ou CNPJ de 14) e devolve a lista de processos daquela pessoa/empresa nas bases nacionais, com TODOS os dados que a base entrega por processo (número CNJ, partes, capa, área, classe, assunto, situação, valor da causa, órgão julgador, movimentações, fontes por tribunal), mais o bloco `envolvido` (nome, OABs, quadro societário, total de processos) e o `paginator`. Debita 1 crédito SÓ quando a consulta é bem-sucedida — nada encontrado (lista vazia) e indisponibilidade da base não cobram. O mesmo documento consultado de novo em até 24h vem do cache, sem novo débito. Use o `numero_cnj` de cada processo para pedir a cópia integral em seguida. Com chave de teste, use os documentos de exemplo (111.444.777-35 ou 47.968.189/0001-74).

curl -X POST https://api.processonline.com.br/functions/v1/api-search-documento \
  -H "Authorization: Bearer po_live_SUACHAVE" \
  -H "Idempotency-Key: busca-12345" \
  -H "Content-Type: application/json" \
  -d '{"documento":"47.968.189/0001-74"}'

Resposta

{
  "documento_tipo": "cnpj",
  "version": "1",
  "total": 2,
  "envolvido": {
    "nome": "EMPRESA X LTDA",
    "tipo_pessoa": "JURIDICA",
    "quantidade_processos": 2,
    "quantidade_processos_retornados": 2,
    "oabs": [],
    "quadro_societario": []
  },
  "paginator": { "per_page": 20 },
  "results": [
    {
      "id": 868872297,
      "numero_cnj": "0801234-56.2023.8.19.0001",
      "ano_inicio": 2023,
      "data_inicio": "2023-04-10",
      "titulo_polo_ativo": "Fulano de Tal",
      "titulo_polo_passivo": "Empresa X S.A.",
      "estado_origem": { "nome": "Rio de Janeiro", "sigla": "RJ" },
      "unidade_origem": { "nome": "1a Vara Civel", "tribunal_sigla": "TJRJ" },
      "quantidade_movimentacoes": 42,
      "data_ultima_movimentacao": "2026-08-19",
      "fontes_tribunais_estao_arquivadas": false,
      "fontes": [
        {
          "id": 1, "sigla": "TJRJ", "grau": 1, "tipo": "TRIBUNAL", "sistema": "PJe",
          "capa": {
            "area": "Civel", "classe": "PROCEDIMENTO COMUM CIVEL", "assunto": "Contratos",
            "situacao": "ATIVO", "valor_causa": { "valor": "10000.00", "moeda": "R$" },
            "orgao_julgador": "1a Vara Civel", "data_distribuicao": "2023-04-10"
          }
        }
      ]
    }
  ],
  "credits_charged": 1
}

Confirma se o processo existe e devolve tribunal, classe e partes. Grátis (com limite por minuto) — use antes de gastar um crédito.

curl -X POST https://api.processonline.com.br/functions/v1/api-verify \
  -H "Authorization: Bearer po_live_SUACHAVE" \
  -H "Content-Type: application/json" \
  -d '{"cnj":"5062404-56.2024.8.13.0702"}'

Resposta

{
  "exists": true,
  "cnj": "50624045620248130702",
  "tribunal": "TJMG",
  "classe": "PROCEDIMENTO COMUM CÍVEL",
  "parties": { "active": "Fulano", "passive": "Banco X" }
}

Cria a solicitação e debita 1 crédito (ou consome a cota mensal, no regime de fatura). Envie o header Idempotency-Key (até 64 caracteres) para retries seguros: a mesma key devolve o mesmo pedido sem débito novo. Declare o motivo do pedido em `interesse` — os autos trazem dados de pessoas que não são você, e registramos a finalidade junto do pedido (Lei 11.419/2006, art. 11, § 7º). Valores: parte, advogado, arrematante, sucessor, credor, outro. Com `advogado`, mande também `interesse_detalhe` com a inscrição na OAB (ex.: "MG 123456"). O campo é opcional hoje e será obrigatório — quem já envia não precisa mudar nada depois. Sem webhook configurado, a resposta traz `hint` com o código `no_webhook`: alguns tribunais levam horas, e sem o webhook você só fica sabendo que o pedido ficou pronto consultando `/api-get-request`.

curl -X POST https://api.processonline.com.br/functions/v1/api-create-request \
  -H "Authorization: Bearer po_live_SUACHAVE" \
  -H "Idempotency-Key: pedido-12345" \
  -H "Content-Type: application/json" \
  -d '{"cnj":"5062404-56.2024.8.13.0702","interesse":"advogado","interesse_detalhe":"MG 123456"}'

Resposta

{
  "request_id": "f0995809-0bee-4e8c-bc52-fb14ec3d80f5",
  "status": "processing",
  "credits_charged": 1,
  "hint": { "code": "no_webhook", "message": "Sem webhook configurado: …" }
}

Status público: processing | completed | failed | secret | expired. Em failed/secret o crédito é devolvido (campo refunded). Prefira o webhook a consultar em loop: o tempo até ficar pronto vai de minutos a horas, conforme o tribunal.

curl "https://api.processonline.com.br/functions/v1/api-get-request?id=REQUEST_ID" \
  -H "Authorization: Bearer po_live_SUACHAVE"

Resposta

{
  "request_id": "f0995809-…",
  "cnj": "50624045620248130702",
  "status": "completed",
  "expires_at": "2026-08-27T02:27:48Z",
  "credits_charged": 1,
  "refunded": false
}

Devolve uma URL assinada válida por 1 hora — gere uma nova a cada download. O arquivo fica disponível por 7 dias após ficar pronto (persista sua cópia). Com chave de teste, devolve um PDF de exemplo. Processos muito grandes são entregues em PARTES de até 200 MB: confira sempre parts_count e baixe todas as parts[] — download_url aponta apenas para a parte 1.

curl "https://api.processonline.com.br/functions/v1/api-download?id=REQUEST_ID" \
  -H "Authorization: Bearer po_live_SUACHAVE"

Resposta

{
  "request_id": "f0995809-…",
  "download_url": "https://api.processonline.com.br/storage/v1/object/sign/…",
  "parts_count": 3,
  "parts": [
    { "idx": 1, "url": "https://…/parte-01-de-03.pdf?token=…", "bytes": 209715200 },
    { "idx": 2, "url": "https://…/parte-02-de-03.pdf?token=…", "bytes": 209715200 },
    { "idx": 3, "url": "https://…/parte-03-de-03.pdf?token=…", "bytes": 94371840 }
  ],
  "expires_in": 3600,
  "file_expires_at": "2026-08-27T02:27:48Z"
}