# 코드에 대한 프로모션 코드 제한 가져오기

코드를 사용할 수 있는 남은 횟수를 가져옵니다. 코드를 필터링하려면 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. 이 매개 변수는 프로젝트 이름 옆의 관리자 페이지에서 또는 프로젝트 작업 시 브라우저 주소 표시줄에서 확인할 수 있습니다. URL 형식은 다음과 같습니다: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `external_id` (integer, required)
    프로모션 외부 ID입니다. 프로젝트 내부의 고유 프로모션 식별자입니다.
    Example: "coupon_44056_1"

## Query parameters:

  - `codes[]` (array)
    고유한 대/소문자 구분 코드입니다. 문자와 숫자만 포함합니다.

  - `limit` (integer)
    페이지 요소 개수 제한입니다.
    Example: 50

  - `offset` (integer)
    목록이 생성된 요소의 개수입니다(개수는 0부터 시작함).

## Response 200 fields (application/json):

  - `promotion_id` (integer)
    프로모션 ID입니다. 프로젝트 내부의 고유 프로모션 식별자입니다.

  - `items` (array)

  - `items.code` (string)
    고유한 대/소문자 구분 코드입니다. 문자와 숫자를 포함합니다.

  - `items.per_code` (object)

  - `items.per_code.total` (integer)
    프로모션 코드를 사용할 수 있는 최대 횟수입니다.

  - `items.per_code.available` (integer)
    프로모션 코드를 사용할 수 있는 남은 횟수입니다.

  - `items.per_code.used` (integer)
    프로모션 코드가 사용된 횟수입니다.

  - `items.per_code.reserved` (integer)
    프로모션 코드가 예약된 횟수입니다.

  - `total_items_count` (number)
    총 코드 개수입니다.

  - `has_more` (boolean)
    코드가 존재하는 다른 페이지가 있는 경우입니다.

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