Processos

Buscar processos para seleção

GET · API de Integração v2

GET/v2/processos/opcoes

Buscar processos para seleção

Devolve uma página de processos do seu escritório num formato enxuto, pensado para preencher um campo de seleção — não é a listagem completa nem a ficha do processo.

Para que serve: descobrir o id a informar em outras rotas que se referem a um processo (por exemplo, ao criar um compromisso em POST /v2/agenda).

Busca: q casa pelo número do processo. Omitir q devolve a primeira página sem filtrar.

Cliente: cpfCnpjCliente filtra pelo CPF/CNPJ exato da pessoa vinculada como cliente, aceitando o valor com ou sem máscara. Pode ser combinado com q.

Paginação: page começa em 1; perPage vale 15 por padrão e é limitado a 100 (valores maiores são reduzidos ao teto, sem erro). A resposta ecoa page/perPage aplicados e o total de registros.

Escopo: só processos do escritório do token. Não há parâmetro para consultar outro escritório.

Autenticação

X-API-Key no cabeçalho. Como autenticar

Parâmetros de consulta4

cpfCnpjClientestring

CPF ou CNPJ exato da pessoa vinculada como cliente, com ou sem máscara. Combina com q quando os dois forem informados.

exemplo: 12.345.678/0001-95
pageinteger

Página, começando em 1.

exemplo: 1padrão: 1
perPageinteger

Itens por página (default 15, máximo 100 — valores acima são reduzidos ao teto, sem erro).

exemplo: 15
qstring

Texto de busca (número do processo). Ausente/vazio devolve a primeira página sem filtrar.

exemplo: 0001234

Respostas3

Exemplos ilustrativos · nenhuma requisição é enviada

200 · Sucesso

Quando acontece
A operação foi concluída.
Como tratar
Leia os dados retornados; em listagens, confira também a paginação.

Exemplo declarado no OpenAPI · application/json

Exemplo · HTTP 200
{
  "content": [
    {
      "id": 45210,
      "numero": "0001234-96.2026.8.17.0001",
      "tribunal": "TJPE",
      "grau": "1º Grau",
      "partes": "ACME LTDA x João da Silva"
    }
  ],
  "page": 1,
  "perPage": 15,
  "total": 1
}

Contrato de respostas

200Página de processos (vazia se nada casar com a busca).

Página de processos (vazia se nada casar com a busca).

application/json

contentProcessoResponse[]
Ver propriedades
graustring

Grau / instância

exemplo: 1º Grau
idinteger

Id do processo (passar em processoId)

formato: int64exemplo: 123456
numerostring

Número do processo

exemplo: 0001234-56.2024.8.26.0100
partesstring

Partes do processo

exemplo: João da Silva x Empresa XYZ Ltda
tribunalstring

Tribunal (descrição amigável)

exemplo: TJSP - Tribunal de Justiça de SP
pageinteger
formato: int32
perPageinteger
formato: int32
totalinteger
formato: int64
totalPagesinteger
formato: int32
400CPF/CNPJ do cliente inválido.

CPF/CNPJ do cliente inválido.

O contrato não declara um corpo para esta resposta.

401Não autenticado (token ausente/inválido).

Não autenticado (token ausente/inválido).

O contrato não declara um corpo para esta resposta.

© 2026 Expedit LawtechFeito para conectar.