# Получение ограничений для уникальных кодов купонов

Возвращает оставшееся количество применений кодов. Для фильтрации кодов используйте параметр запроса codes.

Для настройки самого ограничения кода перейдите в раздел администратора:
* Купоны

Endpoint: GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта, а также в адресной строке браузера при работе с проектом. URL-адрес имеет следующий формат: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `external_id` (integer, required)
    External ID акции. Уникальный идентификатор акции в рамках проекта.
    Example: "coupon_44056_1"

## Query parameters:

  - `codes[]` (array)
    Уникальные коды, чувствительные к регистру. Содержат только буквы и цифры.

  - `limit` (integer)
    Лимит количества элементов на странице.
    Example: 50

  - `offset` (integer)
    Номер элемента, с которого выполняется вывод на странице (нумерация ведется с 0).

## Response 200 fields (application/json):

  - `promotion_id` (integer)
    ID акции. Уникальный идентификатор акции в рамках проекта.

  - `items` (array)

  - `items.code` (string)
    Уникальный код, чувствительный к регистру. Содержит буквы и цифры.

  - `items.per_code` (object)

  - `items.per_code.total` (integer)
    Максимальное количество использований промокода.

  - `items.per_code.available` (integer)
    Оставшееся количество использований промокода.

  - `items.per_code.used` (integer)
    Сколько раз использовался промокод.

  - `items.per_code.reserved` (integer)
    Сколько раз резервировался промокод.

  - `total_items_count` (number)
    Общее количество кодов.

  - `has_more` (boolean)
    Существует ли другая страница с кодами.

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

## Response 404 fields (application/json):

  - `statusCode` (integer)

  - `errorCode` (integer)

  - `errorMessage` (string)

  - `transactionId` (string)

## Response 422 fields (application/json):

  - `statusCode` (integer)

  - `errorCode` (integer)

  - `errorMessage` (string)

  - `errorMessageExtended` (array)