# Obtener límites de código único de cupón

Obtiene el número restante de veces que se pueden utilizar los códigos. Para filtrar los códigos, utilice el parámetro de consulta codes.

Para configurar el límite de códigos propiamente dicho, vaya a Admin:
* Coupons.

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 del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto y en la barra de direcciones del navegador cuando se trabaja en un proyecto. La URL tiene el siguiente formato: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `external_id` (integer, required)
    ID externo de la promoción. Identificador único de la promoción dentro del proyecto.
    Example: "coupon_44056_1"

## Query parameters:

  - `codes[]` (array)
    Códigos únicos que distinguen mayúsculas de minúsculas. Solo contienen letras y números.

  - `limit` (integer)
    Límite para el número de elementos presentes en la página.
    Example: 50

  - `offset` (integer)
    Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0).

## Response 200 fields (application/json):

  - `promotion_id` (integer)
    ID de promoción. Identificador único de la promoción en el proyecto.

  - `items` (array)

  - `items.code` (string)
    Código único que distingue entre mayúsculas y minúsculas. Contiene letras y números.

  - `items.per_code` (object)

  - `items.per_code.total` (integer)
    Número máximo de veces que se puede utilizar un código promocional.

  - `items.per_code.available` (integer)
    El número restante de veces que se puede utilizar un código promocional.

  - `items.per_code.used` (integer)
    El número de veces que se utiliza un código promocional.

  - `items.per_code.reserved` (integer)
    El número de veces que se reserva un código promocional.

  - `total_items_count` (number)
    Número total de códigos.

  - `has_more` (boolean)
    Si existe otra página con códigos.

## 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)