---
title: "List promotions and complimentary grants"
method: GET
path: "/v1/billing/promotions"
---

# List promotions and complimentary grants

`GET /v1/billing/promotions`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/billing/promotions`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `Greatwait-Environment` and API key in header `Greatwait-Project`

Lists the verified organization's launch promotions: each promotional credit grant, complimentary project slot, perk and project-subscription discount, whether it came from an operator or a redeemed code, and when it ends or was revoked. Also reports effective project capacity by source and any restriction that applies. Promotional credit balances by kind are on billing.summary. Promotional value has no cash value, is never refunded and cannot move to another organization or product.

## Response `200`

List promotions and complimentary grants

- object
  - `grants` object[], required
    - `id` string, required
    - `source` 'operator' | 'code', required
    - `benefit` union, required
      - object
        - `kind` 'credit', required
        - `amount` object, required
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
      - object
        - `kind` 'project-slot', required
        - `project` string, required
      - object
        - `kind` 'perk', required
        - `perk` string, required
      - object
        - `kind` 'discount', required
        - `percentOff` integer
        - `amountOff` object
          - `currency` 'USD', required
          - `microdollars` string, required
          - `scale` 6, required
        - `duration` 'once' | 'repeating', required
        - `durationInMonths` integer
    - `state` 'active' | 'expired' | 'revoked', required
    - `startsAt` string, required
    - `endsAt` string
    - `revokedAt` string
  - `projectCapacity` object, required
    - `included` integer, required
    - `paid` integer, required
    - `complimentary` integer, required
  - `perks` object[], required
    - `perk` string, required
    - `endsAt` string, required
  - `restrictions` string[], required

## Other responses

- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `403`: Problem document. Possible codes at this status: scope_missing, test_to_live_escalation.
- `409`: Problem document. Possible codes at this status: project_archived.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)