Obter beneficiário
/v1/beneficiarios/{id}Retorna os dados cadastrais de um beneficiário específico (consulta por CPF no `buscar-beneficiarios` do Orquestrador). > **INSTÁVEL NO AMBIENTE DEV (verificado em 16/07/2026):** o backend > está retornando erro 400 interno de forma persistente. Pendência > aberta com a Izii. O schema de resposta ainda não foi homologado.
Path Parameters
idstringrequired
**CPF** do beneficiário (é o único identificador aplicado pelo backend nas rotas por id; verificado ao vivo).
ex: 36442421430Headers
X-Cnpj-Provedorstringrequired
CNPJ da operadora de destino, atua como **chave de roteamento** (padrão Mediator). Ex.: SulAmérica `01685053000156`.
ex: 01685053000156Responses
Beneficiário encontrado (shape não homologado; ver aviso acima).
Não homologado; será documentado quando o upstream estabilizar.
Ver schema bruto / exemplo JSON
{
"type": "object",
"description": "Não homologado; será documentado quando o upstream estabilizar."
}Token ausente, expirado ou inválido.
Estrutura padronizada de erro.
Código HTTP do erro.
Código interno do erro.
Descrição legível do erro.
items
Crítica/erro de validação devolvido pela operadora.
Recurso não encontrado.
Estrutura padronizada de erro.
Código HTTP do erro.
Código interno do erro.
Descrição legível do erro.
items
Crítica/erro de validação devolvido pela operadora.
Obter beneficiário
/v1/beneficiarios/{id}Retorna os dados cadastrais de um beneficiário específico (consulta por CPF no `buscar-beneficiarios` do Orquestrador). > **INSTÁVEL NO AMBIENTE DEV (verificado em 16/07/2026):** o backend > está retornando erro 400 interno de forma persistente. Pendência > aberta com a Izii. O schema de resposta ainda não foi homologado.
Path Parameters
idstringrequired
**CPF** do beneficiário (é o único identificador aplicado pelo backend nas rotas por id; verificado ao vivo).
ex: 36442421430Headers
X-Cnpj-Provedorstringrequired
CNPJ da operadora de destino, atua como **chave de roteamento** (padrão Mediator). Ex.: SulAmérica `01685053000156`.
ex: 01685053000156Responses
Beneficiário encontrado (shape não homologado; ver aviso acima).
Não homologado; será documentado quando o upstream estabilizar.
Ver schema bruto / exemplo JSON
{
"type": "object",
"description": "Não homologado; será documentado quando o upstream estabilizar."
}Token ausente, expirado ou inválido.
Estrutura padronizada de erro.
Código HTTP do erro.
Código interno do erro.
Descrição legível do erro.
items
Crítica/erro de validação devolvido pela operadora.
Recurso não encontrado.
Estrutura padronizada de erro.
Código HTTP do erro.
Código interno do erro.
Descrição legível do erro.
items
Crítica/erro de validação devolvido pela operadora.