# Obtener límite del código promocional para los códigos

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:
* Promo Codes

Endpoint: GET /v2/project/{project_id}/admin/code/limit/promocode/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.
    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):

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

  - `items` (array)

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

  - `items.per_code` (object)

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

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

  - `items.per_code.total` (integer)
    Número máximo 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.

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

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

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

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

  - `statusCode` (integer)
    Example: 401

## Response 404 fields (application/json):

  - `errorCode` (integer)

  - `errorMessage` (string)

  - `statusCode` (integer)

  - `transactionId` (string)

## Response 422 fields (application/json):

  - `errorCode` (integer)

  - `errorMessage` (string)

  - `errorMessageExtended` (array)

  - `statusCode` (integer)