Consultas por modalidade e OAB
Tribunal e instância (modalidade)
Quando você sabe o tribunal e a instância, escolha explicitamente:
curl -X POST "$ODJUD/v1/searches/modality" \
-H "Authorization: Bearer $ODJUD_KEY" -H "Content-Type: application/json" \
-d '{"cnj":"0707031-34.2023.8.07.0008","court":"TJDFT","grade":"G2","detail":"full"}'
court usa as chaves de /v1/sources (public-courts:<CHAVE> → <CHAVE>). grade: G1, G2, TR (turma recursal) ou SUP. Instâncias sem leitor público respondem 422 SOURCE_NOT_SUPPORTED.
Na rota automática (/searches/process-number), a odjud deduz o tribunal pelo J.TR e a origem (0000 = o próprio tribunal) e, no detalhado de 1º grau, lê também o recurso em andamento quando detectado nos andamentos. Fallback é sempre identificado em source.fallback.
OAB/UF
curl -X POST "$ODJUD/v1/searches/oab" \
-H "Authorization: Bearer $ODJUD_KEY" -H "Content-Type: application/json" \
-d '{"oab":"123456","uf":"SP","from":"2026-01-01","to":"2026-10-29","maxResults":100}'
- Retorna processos com comunicações do DJEN destinadas à inscrição (não é a carteira completa do advogado).
- Paginação por cursor em
/v1/searches/{id}/results?cursor=…. - Reserva: taxa da operação + valor por processo ×
maxResults(com teto). Cobrança final: taxa + processos efetivamente entregues.
Cancelamento
POST /v1/searches/{id}/cancel: antes da execução, cancela e libera toda a reserva; durante a execução, interrompe e não cobra; depois de concluída, 409.
Leituras sem custo
GET /v1/processes/{cnj}, /movements e /publications leem o que já foi entregue à sua conta: não fazem nova consulta à fonte e não cobram. Para dados novos, crie outra busca.