API CRF

Introdução

Esta API permite consultar profissionais e estabelecimentos registrados nos Conselhos Regionais de Farmácia (CRF) do Brasil.

API Consultar CRF (Consultar pelo CRF)

Consulta detalhes de um registro específico.

Endpoint

GET /api/v1/crf/consultar

Requisição

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
`uf`	Texto	Sim	UF do CRF	`SP`
`numero_registro`	Texto	Sim	Número do registro (até 7 dígitos, zeros à esquerda são removidos)	`12344`

Resposta

Parâmetro	Tipo	Descrição	Exemplo
`uf`	Texto	UF do CRF	`SP`
`numero_registro`	Texto	Número do registro	`1234567`
`categoria`	Texto	Categoria do profissional	`FARMACÊUTICO`
`nome_razao_social`	Texto	Nome ou razão social do profissional	`JOÃO DA SILVA`
`situacao`	Texto	Situação do registro	`DEFINITIVO`
`cidade`	Texto	Cidade do registro	`SÃO PAULO`
`data_inscricao`	Texto	Data de inscrição (YYYY-MM-DD)	`2025-08-29`
`data_inscricao_formatada`	Texto	Data de inscrição formatada (DD/MM/AAAA)	`29/08/2025`
`cpf`	Texto	CPF do profissional	`15685971001`
`cpf_formatado`	Texto	CPF do profissional formatado	`156.859.710-01`

Erros

Código HTTP	Erro	Mensagem
`400`	`REQUISICAO_INVALIDA`
`403`	`PLANO_INATIVO`	`Plano inativo para realizar consultas.`
`403`	`CREDITOS_INSUFICIENTES`	`Sem créditos suficientes para consulta.`
`404`	`NAO_ENCONTRADO`	`Nenhum registro encontrado com os parâmetros informados.`

Exemplos

Exemplo de Requisição (cURL)

curl -X GET 'https://consultar.io/api/v1/crf/consultar?uf=sp&numero_registro=12344' -H 'Authorization: Token <seu-token>'

Exemplo de Resposta de Sucesso (200)

{
  "uf": "SP",
  "numero_registro": "1234567",
  "categoria": "FARMACÊUTICO",
  "nome_razao_social": "JOÃO DA SILVA",
  "situacao": "DEFINITIVO",
  "cidade": "SÃO PAULO",
  "data_inscricao": "2025-08-29",
  "data_inscricao_formatada": "29/08/2025",
  "cpf": "15685971001",
  "cpf_formatado": "156.859.710-01"
}

Exemplo de Resposta de Erro (404)

{
  "error": "NAO_ENCONTRADO",
  "message": "Nenhum registro foi encontrado para os parâmetros informados."
}

Limites e Considerações

Cada requisição "Consultar CRF" consome R$ 0,20 dos créditos
Todas as requisições são registradas no histórico de transações
O token de autenticação deve ser mantido em segurança
Em caso de comprometimento do token, entre em contato com o Suporte