# Get promo code limit for codes

Gets the remaining number of times codes can be used. For filtering the codes, use the codes query parameter.

For configuring the code limit itself, go to the Admin section:
* 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)
    Project ID. You can find this parameter in your Publisher Account next to the name of the project.
    Example: 44056

  - `external_id` (integer, required)
    Promotion external ID. Unique promotion identifier within the project.
    Example: "coupon_44056_1"

## Query parameters:

  - `codes[]` (array)
    Unique case-sensitive codes. Contain only letters and numbers.

  - `limit` (integer)
    Limit for the number of elements on the page.
    Example: 50

  - `offset` (integer)
    Number of the element from which the list is generated (the count starts from 0).

## Response 200 fields (application/json):

  - `promotion_id` (integer)
    Promotion ID. Unique promotion identifier within the project.

  - `items` (array)

  - `items.code` (string)
    Unique case sensitive code. Contains letters and numbers.
    Example: "WINTER2021"

  - `items.per_code` (object)

  - `items.per_code.total` (integer)
    The maximum number of times a promo code can be used.

  - `items.per_code.available` (integer)
    The remaining number of times promo code can be used.

  - `items.per_code.used` (integer)
    The number of times a promo code is used.

  - `items.per_code.reserved` (integer)
    The number of times a promo code is reserved.

  - `total_items_count` (number)
    Total number of codes.

  - `has_more` (boolean)
    If another page with codes exists.

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