---
title: "List organization discounts"
method: GET
path: "/organizations/{organization_id}/discounts"
tags: ["Discounts"]
---

# List organization discounts

`GET /organizations/{organization_id}/discounts`

Retrieves all applicable discounts granted to the specified organization.

## Path parameters

- `organization_id` string, required

## Response `200`

OK

- object
  - `items` Discount[]
    - `id` integer — The ID of the organization discount.
    - `organization_id` string — The ULID of the organization the discount applies to.
    - `type` 'allowance' | 'startup' | 'enterprise' — The machine name of the discount type.
    - `type_label` string — The label of the discount type.
    - `status` 'inactive' | 'active' | 'expired' | 'deactivated' — The status of the discount.
    - `commitment` object, nullable — The minimum commitment associated with the discount (if applicable).
      - `months` integer — Commitment period length in months.
      - `amount` object — Commitment amounts.
        - `monthly` CurrencyAmount — Currency amount with detailed components.
          - `formatted` string — Formatted currency value.
          - `amount` number, float — Plain amount.
          - `currency_code` string — Currency code.
          - `currency_symbol` string — Currency symbol.
        - `commitment_period` CurrencyAmount — Currency amount with detailed components.
          - `formatted` string — Formatted currency value.
          - `amount` number, float — Plain amount.
          - `currency_code` string — Currency code.
          - `currency_symbol` string — Currency symbol.
        - `contract_total` CurrencyAmount — Currency amount with detailed components.
          - `formatted` string — Formatted currency value.
          - `amount` number, float — Plain amount.
          - `currency_code` string — Currency code.
          - `currency_symbol` string — Currency symbol.
      - `net` object — Net commitment amounts (discount deducted).
        - `monthly` CurrencyAmount — Currency amount with detailed components.
          - `formatted` string — Formatted currency value.
          - `amount` number, float — Plain amount.
          - `currency_code` string — Currency code.
          - `currency_symbol` string — Currency symbol.
        - `commitment_period` CurrencyAmount — Currency amount with detailed components.
          - `formatted` string — Formatted currency value.
          - `amount` number, float — Plain amount.
          - `currency_code` string — Currency code.
          - `currency_symbol` string — Currency symbol.
        - `contract_total` CurrencyAmount — Currency amount with detailed components.
          - `formatted` string — Formatted currency value.
          - `amount` number, float — Plain amount.
          - `currency_code` string — Currency code.
          - `currency_symbol` string — Currency symbol.
    - `total_months` integer, nullable — The contract length in months (if applicable).
    - `discount` object — Discount value per relevant time periods.
      - `monthly` CurrencyAmount — Currency amount with detailed components.
        - `formatted` string — Formatted currency value.
        - `amount` number, float — Plain amount.
        - `currency_code` string — Currency code.
        - `currency_symbol` string — Currency symbol.
      - `commitment_period` CurrencyAmountNullable, nullable — Currency amount with detailed components.
        - `formatted` string — Formatted currency value.
        - `amount` number, float — Plain amount.
        - `currency_code` string — Currency code.
        - `currency_symbol` string — Currency symbol.
      - `contract_total` CurrencyAmountNullable, nullable — Currency amount with detailed components.
        - `formatted` string — Formatted currency value.
        - `amount` number, float — Plain amount.
        - `currency_code` string — Currency code.
        - `currency_symbol` string — Currency symbol.
    - `config` object — The discount type specific configuration.
    - `start_at` string, date-time — The start time of the discount period.
    - `end_at` string, date-time, nullable — The end time of the discount period (if applicable).
  - `_links` ListLinks
    - `self` Link — A hypermedia link to the {current, next, previous} set of items.
      - `href` string — URL of the link
    - `previous` Link — A hypermedia link to the {current, next, previous} set of items.
      - `href` string — URL of the link
    - `next` Link — A hypermedia link to the {current, next, previous} set of items.
      - `href` string — URL of the link

## Other responses

- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)