# Obter códigos de promoção de código promocional

Obtém códigos de uma promoção de código promocional.

A resposta inclui a quantidade total de códigos na promoção (total_count) e os códigos para a página atual (codes). Para recuperar a próxima página, aumente offset pelo valor de limit (ex.:, “offset”: 100, depois “offset”: 200) até você recuperar todos os códigos.

Na maioria dos casos, “limit”: 100 ou “limit”: 1000 é suficiente. Reserve valores maiores tais como“limit”: 10000 para exportações em massa únicas, e evite usar “limit”: 50000 a não ser que seja necessário.

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

## Path parameters:

  - `project_id` (integer, required)
    ID de projeto. Você pode encontrar esse parâmetro na sua Conta de Distribuidor, próximo ao nome do projeto e na barra de endereços do navegador ao trabalhar com um projeto. O URL tem o seguinte formato: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `external_id` (integer, required)
    ID externo de promoção. Identificador exclusivo da promoção dentro do projeto.
    Example: "coupon_44056_1"

## Query parameters:

  - `limit` (integer)
    Limite da quantidade de elementos na página.
    Example: 50

  - `offset` (integer)
    Número do elemento a partir do qual a lista é gerada (a quantidade começa a partir de 0).

## Response 200 fields (application/json):

  - `codes` (array)

  - `codes.code` (string)
    Código exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números.

  - `total_count` (number)
    Número total de códigos para um código promocional.

## 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)
    Example: 404

  - `errorCode` (integer)
    Example: 4001

  - `errorMessage` (string)
    Example: "[0401-9802]: Promocode not found"

  - `transactionId` (string)
    Example: "x-x-x-x-transactionId-mock-x-x-x"