Promotions
Get a promotion by ID
Retrieves a specific promotion by its ID
Authorization
x-calry-api-key x-calry-api-key<token>
In: header
Path Parameters
id*string
Promotion ID
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/123e4567-e89b-12d3-a456-426614174000"{
"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"
}Empty
Empty
Empty