# 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 du projet. Vous trouverez ce paramètre dans le Compte éditeur, à côté du nom du projet, ainsi que dans l'URL affichée dans la barre d'adresse du navigateur lorsque vous utilisez ce projet. L'URL présente le format suivant : https://publisher.xsolla.com//projects/.
    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):

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

  - `items` (array)

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

  - `items.per_code` (object)

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

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

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

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

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

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

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