Entre em contato conosco e-mail: integracoes.parcerias@clubpetro.com.br

Consultar Prêmios

GET

/external-data/v1/rewards

ResgatePrêmiosConsulta

Responsável:Leonardo Salazar

Consulte o catálogo de prêmios da sua Rede: nome, categoria, pontuação, custo, estoque e desconto de cada prêmio.

Este endpoint não usa intervalo de datas — o catálogo é paginado por limit / offset e ordenado do mais recente para o mais antigo.

Limites de uso. Os limites de requisições e volume de dados valem para o conjunto das chamadas. Consumo nos headers X-RateLimit-Remaining e X-Data-Used-Bytes e no endpoint GET /v1/usage. Ao exceder, a API responde 429 com Retry-After.

Requisição

Authorization

Bearer Token

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Consulta

Respostas

🟢200OK

application/json

Bodyapplication/json

🟠401Não Autorizado

🟠403Proibido

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://gateway.clubpetro.com/external-data/v1/rewards?store_document=undefined&limit=undefined&offset=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Exemplo de Sucesso

{
    "data": [
        {
            "documento_loja": "11343855000131",
            "loja_premio": "CONVENIENCIA SANTA CRUZ",
            "premio": "GARRAFA TERMICA 1L",
            "descricao": "",
            "status": true,
            "pontuacao_necessaria": 1940,
            "custo_premio_reais": 0,
            "valor_venda_reais": 97,
            "estoque": 3,
            "sorteio": false,
            "id_externo": "",
            "data_criacao": "2026-08-07 18:28:31",
            "data_atualizacao": "2026-08-07 18:28:31",
            "categoria_premio": "BRINDE",
            "tipo_desconto": "",
            "valor_desconto": 0
        }
    ],
    "pagination": {
        "limit": 1000,
        "offset": 0,
        "count": 1
    }
}