MDSAPI Portal/IZII MDS — Orquestrador de Benefícios (REST)
get

Listar locais de atendimento

/v1/locais

Retorna locais de atendimento / rede credenciada de uma operadora. > **INDISPONÍVEL NO AMBIENTE DEV (verificado em 16/07/2026):** o > backend (`buscar-locais`) está retornando erro 502 de forma > persistente. Endpoint de baixa prioridade (sem uso conhecido).

Query Parameters

ufstring

UF para filtrar locais.

municipiostring

Município para filtrar.

Headers

X-Cnpj-Provedorstringrequired

CNPJ da operadora de destino, atua como **chave de roteamento** (padrão Mediator). Ex.: SulAmérica `01685053000156`.

ex: 01685053000156

Responses

200

Lista de locais (shape não homologado; ver aviso acima).

object

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."
}
401

Token ausente, expirado ou inválido.

object

Estrutura padronizada de erro.

statusinteger

Código HTTP do erro.

codigostring

Código interno do erro.

mensagemstring

Descrição legível do erro.

criticasarray

items

object

Crítica/erro de validação devolvido pela operadora.

codigostring
campostring
mensagemstring