> ## 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.

# Próxima Fatura

> Retorna a prévia da próxima fatura de uma assinatura

Retorna a prévia da próxima cobrança para uma assinatura (período, itens e valor total). Útil para exibir ao cliente o valor da próxima renovação.

## Endpoint

```bash cURL theme={null}
curl -G https://api.upag.io/v1/invoices/upcoming \
  -H "Authorization: Bearer {token}" \
  -d subscription=sub_abc123xyz
```

## Parâmetros

<ParamField query="subscription" type="string" required>
  ID da assinatura (`sub_...`) usado para calcular a próxima fatura.
</ParamField>

## Resposta

Objeto de prévia (não é uma fatura persistida). Inclui período de cobrança previsto, cliente, moeda, itens derivados da assinatura e `amountDue` total.

```json Response theme={null}
{
  "subscriptionId": "sub_abc123xyz",
  "customerId": "cus_ahwDXrgYvur89iPs",
  "currency": "BRL",
  "periodStart": "2024-12-15T10:00:00.000Z",
  "periodEnd": "2025-01-15T10:00:00.000Z",
  "amountDue": 9900,
  "items": [
    {
      "productId": "prod_xyz789abc",
      "priceId": "price_def456ghi",
      "name": "Plano Pro",
      "amount": 9900,
      "quantity": 1,
      "total": 9900
    }
  ]
}
```