GET /api/v1/instituicoes/{instituicaoId}
Retorna ficha completa da instituição (nome, CNPJ, endereço, número de processos).
Path parameters
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
instituicaoId | string | sim | ID interno da instituição. |
Headers
Authorization: Bearer <token>
Accept: application/json
Exemplo
curl "https://api.ogmmajus.com.br/api/v1/instituicoes/111" \
-H "Authorization: Bearer SEU_TOKEN"
Resposta 200 OK
Estrutura de resposta segue o contrato do Escavador (proxy transparente). Consulte a documentação original do Escavador para o schema completo da resposta deste endpoint.
Erros possíveis
| Status | code | Quando |
|---|---|---|
| 401 | TOKEN_AUSENTE | Header sem Authorization: Bearer ... |
| 401 | TOKEN_INVALIDO | Token revogado ou inexistente |
| 429 | RATE_LIMIT | Limite de requisições atingido |
| 502 | UPSTREAM_INDISPONIVEL | Escavador/tribunal upstream offline |
| 504 | TIMEOUT | Operação excedeu o tempo limite |
Pricing
Custo conforme tabela do plano Ogmmajus. Erros (4xx/5xx) não são tarifados.
Referência original
- Escavador V1: https://api.escavador.com/v1/docs/instituicoes.html