Listar benefícios

GET /api/v1/valepix/benefits

Lista benefícios configurados para a integração autorizada, com busca opcional por nome.

Autenticação

Envie um API token ativo no header Authorization.

Authorization: Bearer <VALEPIX_API_TOKEN>
Accept: application/json

Path params

Esta rota não possui path params.

Query params

Parâmetro	Tipo	Obrigatório	Descrição
search	string	Não	Busca por nome do benefício

Exemplo curl

curl --request GET \
  --header "Authorization: Bearer $VALEPIX_API_TOKEN" \
  --header "Accept: application/json" \
  --url "https://routes.valepix.com.br/api/v1/valepix/benefits?search=flex"

Response

{
  "success": "success",
  "data": {
    "benefits": [
      {
        "id": "00000000-0000-4000-8000-000000000030",
        "name": "Benefício Flexível",
        "description": "Configuração padrão para colaboradores elegíveis",
        "coparticipation_percentage": 0,
        "items": [
          {
            "product_id": "00000000-0000-4000-8000-000000000201",
            "product_slug": "alimentacao",
            "product_name": "Alimentação",
            "monthly_amount": 50000
          }
        ]
      }
    ]
  }
}

O campo id de cada item é o valor que deve ser usado como benefit_id nas rotas de colaboradores.

Erros comuns

HTTP	Quando acontece	Ação recomendada
400	Parâmetros inválidos	Corrigir query string ou IDs
401	Token ausente, inválido, expirado ou revogado	Conferir token
403	Token sem acesso ao recurso solicitado	Confirmar token com a ValePix
500	Erro interno temporário	Tentar novamente com backoff