CalryOTA Docs
Promotions

Get all promotions

Retrieves all promotions for the workspace

GET
/api/v1/promotions

Authorization

x-calry-api-key
x-calry-api-key<token>

In: header

Query Parameters

includeInactive?boolean

Whether to include inactive promotions in the results

Header Parameters

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.

Response Body

application/json

curl -X GET "https://example.com/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"
  }
]