> Documentation index: [Saleor](/llms.txt) · [This section](/api-reference/discounts/llms.txt)
> Source: https://docs.saleor.io/api-reference/discounts/queries/promotions

# promotions Query

List of the promotions.

Requires the MANAGE\_DISCOUNTS permission.

```graphql
promotions(
  where: PromotionWhereInput
  sortBy: PromotionSortingInput
  before: String
  after: String
  first: Int
  last: Int
): PromotionCountableConnection
```

Details

```graphql
type PromotionCountableConnection {
  pageInfo: PageInfo!
  edges: [PromotionCountableEdge!]!
  totalCount: Int
}
```

<a id="arguments"></a>

### Arguments

<a id="where"></a>

#### [`where`](#where) ● [`PromotionWhereInput`](/api-reference/discounts/inputs/promotion-where-input.md)

Where filtering options for promotions.

<a id="sort-by"></a>

#### [`sortBy`](#sort-by) ● [`PromotionSortingInput`](/api-reference/discounts/inputs/promotion-sorting-input.md)

Sort promotions.

<a id="before"></a>

#### [`before`](#before) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

Return the elements in the list that come before the specified cursor.

<a id="after"></a>

#### [`after`](#after) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

Return the elements in the list that come after the specified cursor.

<a id="first"></a>

#### [`first`](#first) ● [`Int`](/api-reference/miscellaneous/scalars/int.md)

Retrieve the first n elements from the list. Note that the system only allows fetching a maximum of 100 objects in a single query.

<a id="last"></a>

#### [`last`](#last) ● [`Int`](/api-reference/miscellaneous/scalars/int.md)

Retrieve the last n elements from the list. Note that the system only allows fetching a maximum of 100 objects in a single query.

<a id="type"></a>

### Type

<a id="promotioncountableconnection"></a>

#### [`PromotionCountableConnection`](/api-reference/discounts/objects/promotion-countable-connection.md)
