# Promotion Code

## Endpoints

### Create a promotion code

- [POST /v1/promotion_codes](https://docs.stripe.com/api/promotion_codes/create.md?api-version=2025-03-31.basil)

### Update a promotion code

- [POST /v1/promotion_codes/:id](https://docs.stripe.com/api/promotion_codes/update.md?api-version=2025-03-31.basil)

### Retrieve a promotion code

- [GET /v1/promotion_codes/:id](https://docs.stripe.com/api/promotion_codes/retrieve.md?api-version=2025-03-31.basil)

### List all promotion codes

- [GET /v1/promotion_codes](https://docs.stripe.com/api/promotion_codes/list.md?api-version=2025-03-31.basil)

A Promotion Code represents a customer-redeemable code for a [coupon](https://docs.stripe.com/api/promotion_codes.md?api-version=2025-03-31.basil#coupons). It can be used to create multiple codes for a single coupon.