---
title: "List promotions for an email domain set"
method: GET
path: "/api/v1/email_domain_sets/{id}/promotions"
tags: ["Email domain sets"]
---

# List promotions for an email domain set

`GET /api/v1/email_domain_sets/{id}/promotions`

## Path parameters

- `id` integer, required

## Response `200`

promotions listed

- object
  - `promotions` object[], required
    - `id` integer, required — Promotion ID
    - `account_id` integer, required
    - `product_id` integer, nullable, required
    - `product_title` string, nullable, required
    - `product_archived_at` string, nullable, required
    - `account_name` string, required
    - `currency` string, required
    - `amount` string, required — Discount amount (decimal)
    - `discount_type` string, required — Type of discount
    - `code` string, required — Code used to apply the discount
    - `name` string, required
    - `description` string, nullable, required
    - `active` boolean, required
    - `start_date` string, nullable, required
    - `end_date` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
    - `deleted_at` string, nullable, required
    - `usage_type` string, required
    - `canvas_root_account_uuid` string, required
    - `email_domain_set_id` integer, required — Email domain set the promotion is restricted to
    - `email_domain_set_name` string, required
    - `email_domains` object[], required
      - `id` integer, required
      - `domain` string, required — Email domain (e.g. example.com)
      - `email_domain_set_id` integer, required
      - `canvas_root_account_uuid` string, required
      - `created_at` string, required
      - `updated_at` string, required
      - `deleted_at` string, nullable, required
    - `status` string, required
    - `max_per_user` integer, nullable, required
    - `max_total_use` integer, nullable, required
    - `enable_for_multi_seat_purchases` boolean, required

---

[API](https://skmtc.net/instructure/apis/canvas-catalog-api.md) · [All operations](https://skmtc.net/instructure/apis/canvas-catalog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instructure/canvas-catalog-api/revisions/78578cd3e37a/schema)