---
title: "Retrieve a list of promo codes"
method: GET
path: "/Business/PromoCodes"
tags: ["Rest"]
---

# Retrieve a list of promo codes

`GET /Business/PromoCodes`

## Query parameters

- `request.activeOnly` boolean
- `request.onlineOnly` boolean
- `request.ids` integer[]
- `request.startDate` string, date-time
- `request.endDate` string, date-time
- `request.orderBy` string
- `request.limit` integer
- `request.offset` integer

## Headers

- `SiteId` integer, required

## Response `200`

OK

- MindbodyRestApiDtoModelsBusinessGetPromoCodesResponse[]
  - `PaginationResponse` MindbodyRestApiDtoModelsPaginationPaginationResponse
    - `RequestedLimit` integer — Limit from pagination request
    - `RequestedOffset` integer — Offset from pagination request
    - `PageSize` integer — Number of results returned in this response
    - `TotalResults` integer — Total number of results in dataset
  - `PromoCodes` MindbodyRestApiDtoModelsBusinessPromoCode[] — Promo code results
    - `Id` integer — ID
    - `Name` string — Name of the promo code
    - `Code` string — Code to be used at purchase for discount
    - `Active` boolean — Active status
    - `Discount` MindbodyRestApiDtoModelsBusinessDiscount — Discount for a promo code
      - `Type` string — Type of discount percentage/amount
      - `Amount` number, double — Amount of discount
    - `ActivationDate` string — Date activated
    - `ExpirationDate` string — Date expired
    - `MaxUses` integer — How many times it can be used
    - `NumberOfAutopays` integer — Number of Autopays
    - `DaysAfterCloseDate` integer — Days after close date
    - `AllowOnline` boolean — Whether it can be used online
    - `DaysValid` string[] — What days the promo code can be used
    - `ApplicableItems` MindbodyRestApiDtoModelsBusinessApplicableItem[] — Items that the promo code will have the discount for. If Null, promo code applies to all items.
      - `Type` string — Type of a promo code
      - `Id` integer — ID of the item
      - `Name` string — Name of the item

## Other responses

- `400` — BadRequest
- `401` — Unauthorized

---

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