# Advogados — Cadastro Nacional (OAB)

> Localiza profissionais inscritos no Cadastro Nacional dos Advogados da OAB, retornando a lista de advogados e estagiários que correspondem à busca, com número de inscrição, seccional (UF) e tipo de inscrição. Útil para conferir se um advogado possui registro válido e em qual estado atua.

- **Consulta:** `oab-advogados`
- **Categoria:** Compliance & Risco
- **Preço:** R$ 0,60 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/oab-advogados`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/compliance-e-risco/oab-advogados

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Consulta o Cadastro Nacional dos Advogados mantido pela Ordem dos Advogados do Brasil e devolve os profissionais que batem com os critérios informados. A busca pode ser feita pelo nome do advogado (retornando todos os homônimos ou nomes semelhantes espalhados pelas seccionais) ou pela combinação de número de inscrição e UF, que identifica um registro específico. Serve para validar a existência e a regularidade de um registro profissional antes de contratações, procurações ou verificações de compliance.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/oab-advogados?nome=SEU_NOME&uf=SP"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/oab-advogados",
    params={"nome": "SEU_NOME", "uf": "SP"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/oab-advogados");

url.search = new URLSearchParams({
  "nome": "SEU_NOME",
  "uf": "SP"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

Informe `nome` ou `inscricao`.

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `nome` | texto | condicional | Nome completo ou parcial do advogado. Retorna todos os homônimos e nomes semelhantes de todas as seccionais. | formato: Nome completo |
| `inscricao` | texto | condicional | Número de inscrição do profissional na OAB (só dígitos, sem a sigla da UF). Use junto com `uf` para identificar um registro único. | formato: 000000 |
| `uf` | texto | não | Sigla da seccional (UF) onde a inscrição foi emitida — 2 letras (ex.: SP, MG). Acompanha o parâmetro `inscricao`. Aceita minúsculas. | `SP` |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> **Dados da pesquisa**
> - `nomePesquisado`: nome enviado na consulta (quando a busca foi por nome).
> - `inscricao`: número de inscrição enviado na consulta (quando a busca foi por inscrição).
> - `uf`: seccional enviada na consulta (quando a busca foi por inscrição).
> - `possuiRegistros`: indica se algum profissional foi localizado.
> - `observacoes`: resumo textual do resultado, incluindo a quantidade de registros encontrados.
>
> **Lista de advogados (`advogados[]`)**
> - `nome`: nome do profissional conforme cadastrado na OAB.
> - `nomeSocial`: nome social, quando registrado.
> - `inscricao`: número de inscrição do profissional.
> - `tipoInscricao`: categoria do registro (ex.: ADVOGADO, ESTAGIÁRIO).
> - `uf`: seccional em que o profissional está inscrito.
> - `situacao`: situação do registro, quando disponível.
> - `organizacao`: sociedade ou organização vinculada, quando disponível.
> - `telefone`: telefone de contato, quando disponível.
> - `endereco`: endereço profissional, quando disponível.
> - `foto`: URL ou conteúdo da foto do profissional, quando disponível.

### Exemplo de resposta

```json
{
  "uf": "string",
  "advogados": [
    {
      "uf": "string",
      "foto": "string",
      "nome": "string",
      "endereco": null,
      "situacao": "string",
      "telefone": "string",
      "inscricao": "string",
      "nomeSocial": null,
      "organizacao": "string",
      "tipoInscricao": "string"
    }
  ],
  "inscricao": "string",
  "observacoes": "string",
  "nomePesquisado": null,
  "possuiRegistros": "boolean"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "uf": {
      "type": [
        "string",
        "null"
      ],
      "description": "Seccional (UF) informada na consulta, quando a busca é feita por inscrição."
    },
    "advogados": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "Sigla da seccional em que o profissional está inscrito."
          },
          "foto": {
            "type": [
              "string",
              "null"
            ],
            "description": "Foto do profissional (URL ou conteúdo), quando disponível."
          },
          "nome": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome do profissional conforme cadastro da OAB."
          },
          "endereco": {
            "type": [
              "string",
              "null"
            ],
            "description": "Endereço profissional, quando disponível."
          },
          "situacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Situação do registro, quando disponível."
          },
          "telefone": {
            "type": [
              "string",
              "null"
            ],
            "description": "Telefone de contato profissional, quando disponível."
          },
          "inscricao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número de inscrição do profissional na OAB."
          },
          "nomeSocial": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome social do profissional, quando registrado."
          },
          "organizacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Sociedade ou organização vinculada, quando disponível."
          },
          "tipoInscricao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Categoria do registro (ex.: ADVOGADO, ESTAGIÁRIO)."
          }
        }
      },
      "description": "Lista de profissionais que correspondem aos critérios da busca."
    },
    "inscricao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número de inscrição informado na consulta, quando a busca é feita por inscrição."
    },
    "observacoes": {
      "type": [
        "string",
        "null"
      ],
      "description": "Resumo textual do resultado da consulta, com a quantidade de registros encontrados."
    },
    "nomePesquisado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome informado na consulta, quando a busca é feita por nome."
    },
    "possuiRegistros": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se algum profissional foi localizado na base."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Fonte oficial: Cadastro Nacional dos Advogados da OAB. A disponibilidade e o preenchimento dos campos dependem do que a Ordem publica para cada registro; itens como situação, organização, telefone, endereço e foto costumam vir vazios na busca por nome.
> - A busca por nome pode retornar múltiplos homônimos; refine com `Inscricao` + `UF` para chegar a um registro único.
> - Quando nenhum profissional é localizado, o campo `possuiRegistros` retorna `false` e a lista `advogados` vem vazia — a consulta é considerada respondida e cobrada normalmente, pois "nada consta" também é uma resposta válida da fonte.

---

Página em HTML: https://fontedata.com/docs/compliance-e-risco/oab-advogados
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp