---
title: "List Discounts"
method: GET
path: "/discounts"
tags: ["Billing"]
---

# List Discounts

`GET /discounts`

## Request

- Base URL: `https://api.hedra.com/v3`
- URL: `https://api.hedra.com/v3/discounts`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

The negotiated discounts the workspace the key bills is charged under
now. `POST /v3/models/{model}/estimate` and every charge for these models
already reflect them; `GET /v3/models` shows list prices.

## Response `200`

Successful Response

- DiscountListResponse: The negotiated discounts the key's workspace is charged under now. Every estimate and charge for these models already reflects them.
  - `data` Discount[], required: This page of items.
    - `model` string, required: The model id the discount applies to.
    - `percent_off` number, required: Percentage off the model's list price, e.g. 20 or 12.5.
    - `starts_at` string, date-time, required: When the discount took effect.
    - `ends_at` string, date-time, nullable: When the discount ends; null when open-ended.
  - `next_cursor` string, nullable, required: Opaque cursor for the next page, or null when this response completes the list. Always present. Endpoints that serve the whole collection at once always return null.

## Other responses

- `400`: Invalid or failed-validation request.
- `401`: Authentication failed: missing, malformed, or invalid credentials.
- `403`: Insufficient scope or plan.
- `404`: Resource not found.
- `429`: Rate limit exceeded.
- `500`: Internal error.

## Changes

- **2026-10-16** `06692d16e78a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hedra-labs/apis/hedra-api/changes/discounts/get.md)

---

[API](https://skmtc.dev/hedra-labs/apis/hedra-api.md) - [All operations](https://skmtc.dev/hedra-labs/apis/hedra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hedra-labs/apis/hedra-api/revisions/6ef35a11cefe?raw)