Skip to main content
GET
/
api
/
v1
/
promotions
Get all promotions
curl --request GET \
  --url https://api.example.com/api/v1/promotions \
  --header 'x-calry-api-key: <api-key>'
[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Summer Sale 2023",
    "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",
    "thumbnailURL": "https://example.com/promotions/summer-sale-2023",
    "status": "ACTIVE",
    "createdAt": "2025-05-15T10:30:00.000Z",
    "updatedAt": "2025-05-16T14:45:00.000Z",
    "description": "Get 15% off on all summer bookings",
    "city": "San Francisco",
    "couponCode": "SUMMER2023"
  }
]

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

​
id
string
required

Unique identifier for the promotion

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
name
string
required

Name of the promotion

Example:

"Summer Sale 2023"

​
discountPercentage
number
required

Discount percentage to apply

Example:

15

​
workspaceID
string
required

ID of the workspace this promotion belongs to

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
startDate
string<date-time>
required

Start date of the promotion

Example:

"2025-06-01T00:00:00.000Z"

​
endDate
string<date-time>
required

End date of the promotion

Example:

"2025-08-31T23:59:59.999Z"

​
bookingPeriodStart
string
required

Start date of the booking period this promotion applies to

Example:

"2025-06-01"

​
bookingPeriodEnd
string
required

End date of the booking period this promotion applies to

Example:

"2025-09-30"

​
thumbnailURL
string
required

Thumbnail URL for the promotion

Example:

"https://example.com/promotions/summer-sale-2023"

​
status
enum<string>
required

Status of the promotion

Available options:
ACTIVE,
INACTIVE
Example:

"ACTIVE"

​
createdAt
string<date-time>
required

When the promotion was created

Example:

"2025-05-15T10:30:00.000Z"

​
updatedAt
string<date-time>
required

When the promotion was last updated

Example:

"2025-05-16T14:45:00.000Z"

​
description
object

Description of the promotion

Example:

"Get 15% off on all summer bookings"

​
city
object

City this promotion is valid in

Example:

"San Francisco"

​
couponCode
object

Coupon code for the promotion

Example:

"SUMMER2023"