# CRF — Conselho Regional de Farmácia

> Valida a inscrição de farmacêuticos no Conselho Regional de Farmácia (CRF) a partir do número de registro, direto da fonte oficial.

- **Consulta:** `crf`
- **Categoria:** Conselhos
- **Preço:** R$ 0,30 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/crf`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/conselhos/crf

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Valida a inscrição de farmacêuticos no Conselho Regional de Farmácia (CRF), retornando os dados de registro profissional a partir do número da inscrição. A consulta é feita em tempo real junto à fonte oficial do conselho.
>
> **Casos de uso:**
> - Verificação de habilitação profissional em processos de contratação e credenciamento
> - Onboarding e KYC de profissionais e prestadores de serviço
> - Prevenção a fraudes e validação de identidade profissional
> - Conformidade regulatória e auditoria de equipes técnicas
> - Checagem de situação (ativo/regular) antes de convênios e parcerias

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/crf?uf=SP&cidade=S%C3%83O+PAULO&numero_registro=123456"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/crf",
    params={"uf": "SP", "cidade": "SÃO PAULO", "numero_registro": "123456"},
    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/crf");

url.search = new URLSearchParams({
  "uf": "SP",
  "cidade": "SÃO PAULO",
  "numero_registro": "123456"
}).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

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `uf` | texto | sim | UF do registro (sigla do estado). | `SP` |
| `cidade` | texto | sim | Cidade do registro (nome por extenso, em maiúsculas). | `SÃO PAULO` |
| `numero_registro` | texto | sim | Número do registro no conselho. | `123456` |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Retorna os dados cadastrais do registro: identificação do profissional (nome), categoria, situação do registro e os identificadores da inscrição. Campos ausentes na fonte retornam nulos.

### Exemplo de resposta

```json
{
  "uf": "SP",
  "cpf": "***",
  "nome": "NOME DO PROFISSIONAL",
  "cidade": "SÃO PAULO",
  "situacao": "DEFINITIVO",
  "categoria": "FARMACÊUTICO",
  "data_inscricao": "2020-01-15",
  "numero_registro": "123456",
  "data_inscricao_br": "15/01/2020"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "uf": {
      "type": [
        "string",
        "null"
      ],
      "description": "Unidade federativa do registro."
    },
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF do profissional (somente dígitos), quando disponível."
    },
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome completo do profissional."
    },
    "cidade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Cidade do registro."
    },
    "situacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação do registro (ex.: DEFINITIVO)."
    },
    "categoria": {
      "type": [
        "string",
        "null"
      ],
      "description": "Categoria do profissional."
    },
    "data_inscricao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de inscrição no formato ISO (AAAA-MM-DD)."
    },
    "numero_registro": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número do registro no conselho."
    },
    "data_inscricao_br": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de inscrição no formato brasileiro (DD/MM/AAAA)."
    }
  }
}
```

## 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 | não foi encontrado registro para os parâmetros informados. |
| `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. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Cada requisição consulta **um único registro**.
> - Os dados refletem a situação no momento da consulta, direto da fonte oficial do conselho.
> - Consultas sem correspondência retornam **404 (Não Encontrado)**.

---

Página em HTML: https://fontedata.com/docs/conselhos/crf
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