# Promotions

Promotions are banners and videos placed in strategic locations to attract attention and promote a particular product, service, or message.

In Tradly, promotions can be directed towards a listing, an account, an external link, or a static message.

To learn more about promotions click [here](https://tradly.app/docs/promotion)

**Object**

```
{
    "id": 12,
    "reference": "campaign - fresh produce",
    "image_path": "https://storage.googleapis.com/tradlyapp/images/19542/c2d24f03-eef2-436b-a625-c91f734f4bc0.jpg",
    "medium": "app",
    "type": "general",
    "placement": "home_top_banner",
    "value": "listing id 1",
    "active": true,
    "start_at": "2021-01-01",
    "end_at": "2021-02-01"
}

```

| **name** | **type** | **description** |
| --- | --- | --- |
| `id` | `integer` | unique identifier of the promo banner |
| `reference` | `string` | reference name |
| `image_path` | `string` | image URL. shouldn't be empty |
| `medium` | `string` | any medium or platform you want to add. For example, you can add one banner for the android app and one banner for the web app |
| `type` | `string` | type of the object being returned. |
| `placement` | `string` | optional placement string. example: a banner can be placed at the top of the web page or side of the page |
| `value` | `string` | any optional value. For example, you can add a listing id here or a deep link that you can use to redirect the user |
| `start_at` | `date` | YYYY-MM-DD start date of the promo banner |
| `end_at` | `date` | YYYY-MM-DD end date of the promo banner |
| `active` | `boolean` | states whether this promo banner is active or not |