# The SubscriptionDiscount object

The discount that lowers the next payments of the subscription

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `discount_id` | string | no | The discount code it came from; null for a discount without a code |
| `code` | string | no |  |
| `type` | string | yes | One of: `percentage`, `fixed`. |
| `value` | string | yes |  |
| `currency` | string | no |  |
| `duration` | string | yes | One of: `once`, `repeating`, `forever`. |
| `periods_total` | integer | no |  |
| `periods_used` | integer | yes |  |
| `total_discounted` | string | yes |  |
| `created_at` | string | no |  |

```json
{
    "discount_id": "aB3dE5fG7h",
    "code": "SUMMER25",
    "type": "percentage",
    "value": "25.00",
    "currency": "EUR",
    "duration": "repeating",
    "periods_total": 3,
    "periods_used": 1,
    "total_discounted": "7.50",
    "created_at": "2026-05-20 10:00:00"
}
```