Список промокодов поставщика

Выгрузка актуальных промокодов только вашего supplier_id.

Эндпоинт

POST /v1/supplier/promo-codes/list

Scope: supplier:codes:read

Lifecycle (бизнес-фильтры)

lifecycle	Статусы	Смысл
`active`	available, reserved, realized	действующие (ещё не погашены)
`used`	redeemed	использованные
`cancelled`	revoked, blocked	отменённые
`expired`	expired	просроченные

Либо lifecycle, либо status / statuses[] — не одновременно.

Пример: действующие

{
  "data": {
    "lifecycle": "active",
    "page": 1,
    "pageSize": 200,
    "maskCode": true,
    "sortBy": "updatedAt",
    "sortOrder": "desc"
  }
}

Пример: использованные с сверкой

{
  "data": {
    "lifecycle": "used",
    "updatedSince": "2026-07-01T00:00:00Z",
    "page": 1
  }
}

Пример: отменённые

{ "data": { "lifecycle": "cancelled" } }

Другие фильтры

incomingId, productId, productLine
validUntilFrom, validUntilTo (или legacy validUntilBefore)
statuses: ["available","realized"]
pageSize max 500; полный код — только через promo-codes/get

Поля item

id, codeDisplay (masked), status, productId, productName, productLine, validFrom, validUntil, incomingId, realizedAt, redeemedAt, revokedAt, updatedAt, createdAt.