> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Fetch and update your discount groups

Get discount groups by ID, and rename or archive them using new API operations, giving you more control over how you organize discounts.

---

## What's new?

We've released new operations that let you fetch and update your discount groups using the API.

This change makes it easier to manage your discount groups, especially when you need to rename, archive, or fetch discount group details programmatically.

## How it works

[Discount groups](https://developer.paddle.com/api-reference/discount-groups/overview.md) let you organize your discounts for easier management. For example, you can create groups for marketing promotions, retention offers, or seasonal campaigns.

Previously, you could create discount groups and assign discounts to them. However, once a discount group was created, you couldn't rename or archive it. To change the name, you had to create a new group and manually reassign all the associated discounts. You also couldn't fetch a single discount group by its ID.

With this change, you can:

- [**Get a discount group**](https://developer.paddle.com/api-reference/discount-groups/get-discount-group.md)  
   Fetch the details of a single discount group by its `id`.
- [**Update a discount group**](https://developer.paddle.com/api-reference/discount-groups/update-discount-group.md)  
   Change the `name` of an existing discount group, or change its `status` to `archived`. You can also use the `discount_group.updated` webhook to get notified when a discount group is updated.

{% callout type="info" %}

Discount groups are only available in the Paddle API. They're coming to the dashboard at a later date.

{% /callout %}

## Next steps

This change is available in version `1` of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

Check out the [discount group entity overview](https://developer.paddle.com/api-reference/discount-groups/overview.md) and our guides on [fetching](https://developer.paddle.com/api-reference/discount-groups/get-discount-group.md) and [updating](https://developer.paddle.com/api-reference/discount-groups/update-discount-group.md) discount groups to get started.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| GET Get a discount group | API operation | added | Discount groups |  |
| PATCH Update a discount group | API operation | added | Discount groups |  |
| `discount_group.updated` | Webhook | added | Discount groups |  |