> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elivaas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Promotions - List

## Overview

Retrieves all active promotions across every property accessible to your distribution channel, grouped by property ID. Use this for bulk promotion sync or building a centralized deals page.

***

## Request

```
GET /v1/properties/promotions
```

### Headers

| Header       | Type   | Required | Description                           |
| ------------ | ------ | -------- | ------------------------------------- |
| `Api-Key`    | string | Yes      | Your API key for authentication.      |
| `Channel-Id` | string | Yes      | Your distribution channel identifier. |

### Example Request

```bash theme={null}
curl -X GET "https://sandbox.elivaas.com/v1/properties/promotions" \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Channel-Id: YOUR_CHANNEL_ID"
```

***

## Response — `200 OK`

A JSON object where each key is a property ID and each value is an array of [Promotion](/api-reference/promotions/promotions-retrieve#promotion-object) objects for that property.

### Response Structure

| Key            | Type               | Description                                                                                                                                                                               |
| -------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{propertyId}` | array of Promotion | Active promotions for the given property. Each promotion object follows the schema documented in [Promotions - Retrieve](/api-reference/promotions/promotions-retrieve#promotion-object). |

### Example Response

```json theme={null}
{
  "prop_456": [
    {
      "id": "promo_001",
      "code": "SUMMER20",
      "title": "Summer Discount",
      "description": "Get 20% off on stays during summer season",
      "startDateTime": "2025-06-01T00:00:00",
      "endDateTime": "2025-08-31T23:59:59",
      "discountMethod": "PERCENTAGE",
      "discountPercentage": 20.0,
      "maximumDiscountAllowed": 5000,
      "minimumBookingAmount": 3000,
      "status": "ACTIVE",
      "type": "COUPON",
      "nonRefundable": false,
      "clubbed": false,
      "rank": 1
    },
    {
      "id": "promo_002",
      "code": "EARLY15",
      "title": "Early Bird Offer",
      "description": "Book 30 days in advance and get 15% off",
      "discountMethod": "PERCENTAGE",
      "discountPercentage": 15.0,
      "status": "ACTIVE",
      "type": "EARLY_BOOKER",
      "earlyBookerValueInDays": 30,
      "rank": 2
    }
  ],
  "prop_789": [
    {
      "id": "promo_003",
      "code": "WEEKEND10",
      "title": "Weekend Special",
      "description": "10% off on weekend stays",
      "discountMethod": "PERCENTAGE",
      "discountPercentage": 10.0,
      "status": "ACTIVE",
      "type": "COUPON",
      "weekendOnly": true,
      "rank": 1
    }
  ]
}
```

***

## Error Handling

| Status | Meaning               | Description                                                                    |
| ------ | --------------------- | ------------------------------------------------------------------------------ |
| `200`  | Success               | Promotions returned grouped by property. Empty object `{}` if none are active. |
| `401`  | Unauthorized          | Missing or invalid `Api-Key` or `Channel-Id`.                                  |
| `500`  | Internal Server Error | Unexpected error.                                                              |