# Lire les limites pour les codes promo

Récupère le nombre restant de fois que les codes peuvent être utilisés. Pour filtrer les codes, utilisez le paramètre de requête codes.

Pour configurer la limite de codes elle-même, accédez à la section Administrateur :
* Codes promo

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 de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
    Example: 44056

  - `external_id` (integer, required)
    External ID de la promotion. Identifiant unique de la promotion au sein du projet.
    Example: "coupon_44056_1"

## Query parameters:

  - `codes[]` (array)
    Codes uniques sensibles à la casse. Ne comprennent que des lettres et des chiffres.

  - `limit` (integer)
    Nombre maximal d'éléments sur une page.
    Example: 50

  - `offset` (integer)
    Numéro de l'élément à partir duquel la liste est générée (le décompte commence à 0).

## Response 200 fields (application/json):

  - `has_more` (boolean)
    S'il existe une autre page avec des codes.

  - `items` (array)

  - `items.code` (string)
    Code unique sensible à la casse. Comprend des lettres et des chiffres.
    Example: "WINTER2021"

  - `items.per_code` (object)

  - `items.per_code.available` (integer)
    Nombre restant de fois qu'un code promo peut être utilisé.

  - `items.per_code.reserved` (integer)
    Nombre de fois qu'un code promo est réservé.

  - `items.per_code.total` (integer)
    Nombre maximum de fois qu'un code promo peut être utilisé.

  - `items.per_code.used` (integer)
    Nombre de fois qu'un code promo est utilisé.

  - `promotion_id` (integer)
    ID de la promotion. Identifiant unique de la promotion au sein du projet.

  - `total_items_count` (number)
    Nombre total de codes.

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