GET
/
api
/
v1
/
promotions
[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Summer Sale 2023",
    "description": "Get 15% off on all summer bookings",
    "city": "San Francisco",
    "discountPercentage": 15,
    "workspaceID": "123e4567-e89b-12d3-a456-426614174000",
    "startDate": "2025-06-01T00:00:00.000Z",
    "endDate": "2025-08-31T23:59:59.999Z",
    "bookingPeriodStart": "2025-06-01",
    "bookingPeriodEnd": "2025-09-30",
    "couponCode": "SUMMER2023",
    "thumbnailURL": "https://example.com/promotions/summer-sale-2023",
    "status": "ACTIVE",
    "createdAt": "2025-05-15T10:30:00.000Z",
    "updatedAt": "2025-05-16T14:45:00.000Z"
  }
]

Authorizations

​
x-calry-api-key
string
header
required

Headers

​
x-calry-tenant-id
string

Optional tenant ID to specify which tenant to operate as. Controls access to promotions and their associated listings. If not provided, the default tenant will be used.

Query Parameters

​
includeInactive
boolean

Whether to include inactive promotions in the results

Example:

false

Response

200 - application/json

List of promotions

The response is of type object[].