# Limits eindeutiger Gutscheincodes abrufen

Ruft ab, wie oft die Codes noch eingelöst werden dürfen. Verwenden Sie zum Filtern der Codes den Abfrageparameter codes.

Im Abschnitt "Verwaltung" können Sie das Code-Limit selbst festlegen:
* Gutscheine

Endpoint: GET /v2/project/{project_id}/admin/code/limit/coupon/external_id/{external_id}
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt sowie in der Adressleiste des Browsers, wenn Sie im Kundenportal ein Projekt geöffnet haben. Die URL hat das folgende Format: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `external_id` (integer, required)
    Externe ID der Werbeaktion. Eindeutige Werbeaktionskennung innerhalb des Projekts.
    Example: "coupon_44056_1"

## Query parameters:

  - `codes[]` (array)
    Eindeutige Codes, bei denen zwischen Groß-/Kleinschreibung unterschieden wird. Enthält nur Buchstaben und Ziffern.

  - `limit` (integer)
    Begrenzung der Elementanzahl auf der Seite.
    Example: 50

  - `offset` (integer)
    Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0).

## Response 200 fields (application/json):

  - `promotion_id` (integer)
    Werbeaktions-ID. Eindeutige Werbeaktionskennung innerhalb des Projekts.

  - `items` (array)

  - `items.code` (string)
    Eindeutiger Code, es wird zwischen Groß- und Kleinschreibung unterschieden. Enthält Buchstaben und Ziffern.

  - `items.per_code` (object)

  - `items.per_code.total` (integer)
    Wie oft ein Promocode maximal eingelöst werden darf.

  - `items.per_code.available` (integer)
    Wie oft ein Promocode noch eingelöst werden kann.

  - `items.per_code.used` (integer)
    Wie oft ein Promocode eingelöst wurde.

  - `items.per_code.reserved` (integer)
    Wie oft ein Promocode reserviert ist.

  - `total_items_count` (number)
    Gesamtzahl der Codes.

  - `has_more` (boolean)
    Wenn eine andere Seite mit Codes existiert.

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