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

# List Discount Codes

> Lista códigos de desconto.

## Parâmetros de query

<ParamField query="limit" type="integer" default="10">
  Quantidade de itens por página. Entre `1` e `100`.
</ParamField>

<ParamField query="starting_after" type="string">
  ID do código que delimita o início da próxima página.
</ParamField>

<ParamField query="ending_before" type="string">
  ID do código que delimita o fim da página anterior.
</ParamField>

<ParamField query="discount_id" type="string">
  Filtra por desconto.
</ParamField>

<ParamField query="customer" type="string">
  Filtra por cliente restrito ao código.
</ParamField>

<ParamField query="code" type="string">
  Filtra por código exato, sem diferenciar maiúsculas e minúsculas.
</ParamField>

<ParamField query="is_active" type="boolean | string">
  Quando omitido, retorna apenas `is_active=true`. Envie `false` para inativos
  ou `all` para incluir ambos.
</ParamField>

<RequestExample>
  ```bash cURL theme={}
  curl -X GET "https://api.chargefy.io/v1/discount-codes?discount_id=disc_123" \
    -H "Authorization: Bearer {{API_KEY}}"
  ```
</RequestExample>

## Resposta

<ResponseExample>
  ```json 200 theme={}
  {
    "object": "list",
    "data": [
      {
        "id": "dcode_123",
        "object": "discount_code",
        "code": "BLACK20",
        "created_at": "2026-05-21T12:00:00Z",
        "customer": null,
        "discount": "disc_123",
        "expires_at": null,
        "first_time_transaction": false,
        "is_active": true,
        "livemode": true,
        "max_redemptions": 500,
        "max_redemptions_per_customer": null,
        "metadata": {},
        "minimum_amount": 10000,
        "minimum_amount_currency": "brl",
        "redemptions_count": 0,
        "updated_at": null,
        "valid": true
      }
    ],
    "has_more": false,
    "url": "/v1/discount-codes"
  }
  ```
</ResponseExample>