# Promotions List

**GET** `/v1/promos`

Lists promotions or discount campaigns.

Get the list of promotions.

**Query Parameters**

| **name** | **required** | **type** | **description** |
| --- | --- | --- | --- |
| `page` | required | `integer` | pagination starts from 1 |
| `type` | required | `string` | type of the object being returned |
| `per_page` | optional | `integer` | number of records per page. between 1 and 100 |
| `medium` | optional | `string` | medium/platform of the promo banner |
| `placement` | optional | `string` | placement of the promo banner |