# Obtener la lista de paquetes de moneda virtual

Obtiene una lista de paquetes de moneda virtual para crear un catálogo.

Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset.

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

## Path parameters:

  - `project_id` (integer, required)
    ID del proyecto.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Límite para el número de elementos presentes en la página.
    Example: 50

  - `offset` (integer)
    Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0).

  - `locale` (string)
    Idioma de respuesta. Código de idioma de dos letras minúsculas según la norma ISO 639-1.

  - `additional_fields[]` (array)
    Lista de campos adicionales. Estos campos estarán en la respuesta si los envía en su solicitud. Campos disponibles media_list, order y long_description.

  - `country` (string)
    País para calcular los precios regionales y las restricciones del catálogo. Código de país de dos letras en mayúscula según la norma ISO 3166-1 alpha-2. Si no especifica el país explícitamente, se calculará en función de la dirección IP del usuario.

## 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 y sus valores correspondientes al juego.

Atención: esta parte de la respuesta solo está disponible si envía el parámetro de consulta additional_fields[]=attributes.

  - `items.attributes.external_id` (string)
    ID único del atributo. external_id solo puede contener caracteres alfanuméricos del alfabeto latino en minúsculas, guiones y guiones bajos.
    Example: "attribute_1"

  - `items.attributes.name` (string)
    Nombre del atributo.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    ID de valor único para un atributo. external_id solo puede contener caracteres alfanuméricos del alfabeto latino en minúsculas, guiones y guiones bajos.
    Example: "attribute_value"

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

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

  - `items.content` (array)
    Contenido del paquete de moneda virtual.
    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)
    Descripción del artículo.
    Example: "Big Rocket - description"

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

  - `items.content.inventory_options` (object)
    Define las opciones de artículo del inventario.

  - `items.content.inventory_options.consumable` (object,null)
    Define las propiedades consumibles si se trata de un artículo consumible, o null si se trata de un artículo no consumible.

  - `items.content.inventory_options.consumable.usages_count` (integer,null)
    Número total de usos restantes si se trata de un artículo consumible, o null si se trata de un artículo no consumible.
    Example: 1

  - `items.content.inventory_options.expiration_period` (object,null)
    Define las propiedades de expiración si se trata de un artículo expirado, o null si se trata de un artículo no expirado.

  - `items.content.inventory_options.expiration_period.type` (string)
    Define el tipo de expiración de un artículo.
    Enum: "minute", "hour", "day", "week", "month", "year"

  - `items.content.inventory_options.expiration_period.value` (integer)
    Define el valor del periodo de expiración.
    Example: 1

  - `items.content.name` (string)
    Nombre del artículo.
    Example: "Big Rocket"

  - `items.content.quantity` (integer)
    Cantidad de moneda virtual que hay en un paquete.
    Example: 250

  - `items.content.sku` (string)
    ID único del artículo. El código de artículo (SKU) solo puede contener caracteres alfanuméricos del alfabeto latino en minúsculas, guiones y guiones bajos.
    Example: "big_rocket"

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

  - `items.groups` (array)
    Grupos a los que pertenece el artículo.
    Example: [{"external_id":"accessory","name":"Accessory"}]

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

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

  - `items.is_free` (string)
    Si es true, el artículo es gratuito.
    Example: "false"

  - `items.price` (object)
    Precios de artículos.

  - `items.price.amount` (string)
    Precio del artículo con descuento.
    Example: "100.99"

  - `items.price.amount_without_discount` (string)
    Precio del artículo.
    Example: "100.99"

  - `items.price.currency` (string)
    Moneda de compra por defecto. Código de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `items.sku` (string)
    ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.
    Example: "big_rocket"

  - `items.virtual_prices` (array)
    Precios virtuales.

  - `items.virtual_prices.amount` (integer)
    Precio del artículo con descuento en moneda virtual.
    Example: 100

  - `items.virtual_prices.description` (string)
    Descripción de la moneda virtual.
    Example: "Big Rocket - description"

  - `items.virtual_prices.image_url` (string)
    Imagen de la moneda virtual.
    Example: "http://image.png"

  - `items.virtual_prices.is_default` (boolean)
    Si el precio está predeterminado o no para el artículo.
    Example: true

  - `items.virtual_prices.name` (string)
    Nombre de la moneda virtual.
    Example: "SHOTGUN FOR TRUE RAIDERS"

  - `items.virtual_prices.sku` (string)
    Código de artículo (SKU) de la moneda virtual.
    Example: "vc_test"

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