# Obter lista de pacotes de moedas virtuais

Obtém uma lista de pacotes de moedas virtuais para criar um catálogo.

Atenção. Todos os projetos têm uma limitação no número de itens que você pode obter na resposta. O valor padrão e máximo é de 50 itens por resposta. Para obter mais dados página por página, use os campos limit e offset.

Endpoint: GET /v2/project/{project_id}/items/virtual_currency/package
Version: 1.0.0
Security: AuthForClient

## Path parameters:

  - `project_id` (integer, required)
    ID do Projeto.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Limite para o número de elementos na página.
    Example: 50

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

  - `locale` (string)
    Idioma de resposta. Código de idioma minúsculo de duas letras de acordo com o padrão ISO 639-1.

  - `additional_fields[]` (array)
    A lista de campos adicionais. Esses campos estarão na resposta se você enviá-los em sua solicitação. Campos disponíveis media_list, order, long_description.

  - `country` (string)
    País para calcular preços regionais e restrições de catálogos. Código de país maiúsculo de duas letras de acordo com o padrão ISO 3166-1 alpha-2. Se você não especificar o país explicitamente, ele será calculado com base no endereço IP do usuário.

## Response 200 fields (application/json):

  - `items` (array)
    Example: [{"attributes":[],"bundle_type":"virtual_currency_package","content":[{"description":"Big Rocket - short description","image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","inventory_options":{"consumable":{"usages_count":1}},"name":"Big Rocket","quantity":100,"sku":"big_rocket","type":"virtual_currency"}],"description":"VC Short Package Description","groups":[],"image_url":"http://vc_package_image.png","is_free":false,"name":"VC Name first package","price":{"amount":"2.0000","amount_without_discount":"2.0000","currency":"USD"},"sku":"vc_package_1","type":"bundle","virtual_prices":[]},{"attributes":[],"bundle_type":"virtual_currency_package","content":[{"description":"description","image_url":"http://image.png","inventory_options":{"consumable":{"usages_count":1}},"name":"SHOTGUN FOR TRUE RAIDERS","quantity":200,"sku":"shotgun_raider","type":"virtual_currency"}],"description":"VC Short Package Description","groups":[],"image_url":"http://vc_package_image.png","is_free":false,"name":"VC Name third package","price":{"amount":"4.0000","amount_without_discount":"4.0000","currency":"USD"},"sku":"vc_package_3","type":"bundle","virtual_prices":[]}]

  - `items.attributes` (array)
    Lista de atributos e seus valores correspondentes ao Jogo.

Atenção. Essa parte da resposta estará disponível somente se você enviar o parâmetro de consulta  additional_fields[]=attributes.

  - `items.attributes.external_id` (string)
    ID de atributo exclusivo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.
    Example: "attribute_1"

  - `items.attributes.name` (string)
    Nome do atributo.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.
    Example: "attribute_value"

  - `items.attributes.values.value` (string)
    Valor do atributo.
    Example: "Strategy"

  - `items.bundle_type` (string)
    Tipo de conjunto: standard/virtual_currency_package.
    Example: "virtual_currency_package"

  - `items.content` (array)
    Conteúdo do pacote de moedas virtuais.
    Example: [{"description":"Big Rocket - short description","image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","inventory_options":{"consumable":{"usages_count":1}},"name":"Big Rocket","quantity":100,"sku":"big_rocket","type":"virtual_currency"}]

  - `items.content.description` (string)
    Descrição do item.
    Example: "Big Rocket - description"

  - `items.content.image_url` (string)
    URL da imagem.
    Example: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png"

  - `items.content.inventory_options` (object)
    Define as opções de item de inventário.

  - `items.content.inventory_options.consumable` (object,null)
    Define as propriedades consumíveis se este for um item consumível ou null se este for um item não consumível.

  - `items.content.inventory_options.consumable.usages_count` (integer,null)
    Número total de utilizações restantes se este for um item consumível ou null se este for um item não consumível.
    Example: 1

  - `items.content.inventory_options.expiration_period` (object,null)
    Define as propriedades de expiração se este for um item expirado ou null se este for um item não expirado.

  - `items.content.inventory_options.expiration_period.type` (string)
    Define o tipo de validade de um item.
    Enum: "minute", "hour", "day", "week", "month", "year"

  - `items.content.inventory_options.expiration_period.value` (integer)
    Define o valor para o período de validade.
    Example: 1

  - `items.content.name` (string)
    Nome do item.
    Example: "Big Rocket"

  - `items.content.quantity` (integer)
    Quantia de moedas virtuais em um pacote.
    Example: 250

  - `items.content.sku` (string)
    ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos, traços e sublinhados.
    Example: "big_rocket"

  - `items.content.type` (string)
    Tipo de item: virtual_good/virtual_currency/bundle.
    Example: "virtual_currency"

  - `items.groups` (array)
    Grupos aos quais o item pertence.
    Example: [{"external_id":"accessory","name":"Accessory"}]

  - `items.groups.external_id` (string)
    Example: "accessory"

  - `items.groups.name` (string)
    Example: "Accessory"

  - `items.is_free` (string)
    Se true, o item é gratuito.
    Example: "false"

  - `items.price` (object)
    Preços dos itens.

  - `items.price.amount` (string)
    Preço do item com desconto.
    Example: "100.99"

  - `items.price.amount_without_discount` (string)
    Preço do item.
    Example: "100.99"

  - `items.price.currency` (string)
    Moeda de compra padrão. Código de três letras de acordo com o padrão [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `items.sku` (string)
    ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos, pontos, traços e sublinhados.
    Example: "big_rocket"

  - `items.virtual_prices` (array)
    Preços virtuais.

  - `items.virtual_prices.amount` (integer)
    Preço do item com desconto em moedas virtuais.
    Example: 100

  - `items.virtual_prices.description` (string)
    Descrição da moeda virtual.
    Example: "Big Rocket - description"

  - `items.virtual_prices.image_url` (string)
    Imagem da moeda virtual.
    Example: "http://image.png"

  - `items.virtual_prices.is_default` (boolean)
    Se o preço é padrão para o item ou não.
    Example: true

  - `items.virtual_prices.name` (string)
    Nome da moeda virtual.
    Example: "SHOTGUN FOR TRUE RAIDERS"

  - `items.virtual_prices.sku` (string)
    SKU do item de moeda virtual.
    Example: "vc_test"

  - `items.virtual_prices.type` (string)
    Tipo de moeda virtual.
    Example: "virtual_currency"