> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upag.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar cupons

> Lista os cupons da conta, do mais novo para o mais antigo

Permissão: `coupon.read` (chave secreta).

## Endpoint

<CodeGroup>
  ```bash cURL theme={null}
  curl -G https://api.upag.dev/v1/coupons \
    -H "Authorization: Bearer sk_test_your_api_key" \
    -d "page=1" \
    -d "limit=15"
  ```

  ```javascript Node.js SDK theme={null}
  import { Upag } from 'upag';

  const upag = new Upag('sk_test_your_api_key');

  const { data, count } = await upag.coupons.list({ page: 1, limit: 15 });
  ```
</CodeGroup>

<Note>
  Em produção use `https://api.upag.io/v1` com `sk_live_...`.
</Note>

## Parâmetros

<ParamField query="page" type="integer" default="1">
  Página (mínimo 1).
</ParamField>

<ParamField query="limit" type="integer" default="15">
  Itens por página (mínimo 1).
</ParamField>

## Resposta

`200 OK`

```json Response theme={null}
{
  "data": [
    {
      "id": "a3c4d5e6-7f80-4912-8abc-0d1e2f3a4b5c",
      "name": "Black Friday",
      "description": null,
      "active": true,
      "type": "percentage",
      "code": "BLACK20",
      "currency": null,
      "amountOff": null,
      "percentOff": 20,
      "uses": 3,
      "maxUses": 100,
      "appliesTo": "all",
      "appliesToProducts": null,
      "expiresAt": "2026-12-01T00:00:00.000Z",
      "createdAt": "2026-03-18T11:10:00.000Z",
      "updatedAt": "2026-03-18T11:10:00.000Z"
    }
  ],
  "count": 1
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.