Loot boxes

Endpoint to fetch all loot boxes for a program

get

Authorizations

Query parameters

limitanyoptional

Amount of loot boxes to return (max 100).

offsetanyoptional

Index to start at.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v2/admin/loot-boxes' \
  --header 'X-API-Key: YOUR_API_KEY'

200

200

{
  "loot_boxes": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "sponsor_name": "text",
      "sponsor_description": "text",
      "recurring_interval_minutes": 1,
      "image_box_together_url": "text",
      "background_gradient_start_color": "text",
      "background_gradient_stop_color": "text",
      "reward_sequence_animation_type": "SHUFFLE",
      "is_sign_up_reward": true,
      "partner_metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "created_at": 1,
      "updated_at": 1,
      "loot_box_reward_choices": [
        {
          "id": "text",
          "title": "text",
          "subtitle": "text",
          "category": "text",
          "point_reward_value": 1,
          "reward_uuids": [
            "text"
          ],
          "quantity": 1,
          "image": "text",
          "video": "text",
          "probability": 1,
          "current_tier_id": "text",
          "rewards": [
            {
              "uuid": "text",
              "name": "text",
              "description": "text",
              "image_url": "text",
              "terms_and_conditions": "text",
              "metadata": {
                "ANY_ADDITIONAL_PROPERTY": "anything"
              }
            }
          ]
        }
      ]
    }
  ],
  "total_records": 1
}

Successful response

Endpoint to create a loot box

post

Authorizations

Body

descriptionstringrequired

Description of the Lootbox object.

namestringrequired

Name/title of the Lootbox object.

sponsor_namestringoptional

Lootbox sponsor name.

sponsor_descriptionstringoptional

Lootbox sponsor description.

recurring_interval_minutesnumberoptional

Interval indicating how often a Lootbox can be granted.

image_box_together_b64stringoptional

Base 64 string of the combined Lootbox image.

image_box_together_urlstringoptional

URL of the combined Lootbox image.

background_gradient_start_colorstringoptional

Hexadecimal color value for the start of the gradient.

background_gradient_stop_colorstringoptional

Hexadecimal color value for the end of the gradient.

reward_sequence_animation_typestringoptional

Animation type dictating how a rewarded Lootbox is presented.

is_sign_up_rewardbooleanoptional

Boolean flag indicating if the Lootbox should be rewarded at signup.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v2/admin/loot-boxes' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'description=text&name=text&sponsor_name=text&sponsor_description=text&recurring_interval_minutes=1&image_box_together_b64=text&image_box_together_url=text&background_gradient_start_color=text&background_gradient_stop_color=text&reward_sequence_animation_type=text&is_sign_up_reward=true'

200

200

{
  "loot_box": {
    "id": "text",
    "name": "text",
    "description": "text",
    "sponsor_name": "text",
    "sponsor_description": "text",
    "recurring_interval_minutes": 1,
    "image_box_together_url": "text",
    "background_gradient_start_color": "text",
    "background_gradient_stop_color": "text",
    "reward_sequence_animation_type": "SHUFFLE",
    "is_sign_up_reward": true,
    "partner_metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "created_at": 1,
    "updated_at": 1,
    "loot_box_reward_choices": [
      {
        "id": "text",
        "title": "text",
        "subtitle": "text",
        "category": "text",
        "point_reward_value": 1,
        "reward_uuids": [
          "text"
        ],
        "quantity": 1,
        "image": "text",
        "video": "text",
        "probability": 1,
        "current_tier_id": "text",
        "rewards": [
          {
            "uuid": "text",
            "name": "text",
            "description": "text",
            "image_url": "text",
            "terms_and_conditions": "text",
            "metadata": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          }
        ]
      }
    ]
  }
}

Successful response

Get the Loot Box with the given ID.

get

Authorizations

Path parameters

loot_box_idanyrequired

the ID of the Loot Box

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v2/admin/loot-boxes/{loot_box_id}' \
  --header 'X-API-Key: YOUR_API_KEY'

200

200

{
  "loot_box": {
    "id": "text",
    "name": "text",
    "description": "text",
    "sponsor_name": "text",
    "sponsor_description": "text",
    "recurring_interval_minutes": 1,
    "image_box_together_url": "text",
    "background_gradient_start_color": "text",
    "background_gradient_stop_color": "text",
    "reward_sequence_animation_type": "SHUFFLE",
    "is_sign_up_reward": true,
    "partner_metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "created_at": 1,
    "updated_at": 1,
    "loot_box_reward_choices": [
      {
        "id": "text",
        "title": "text",
        "subtitle": "text",
        "category": "text",
        "point_reward_value": 1,
        "reward_uuids": [
          "text"
        ],
        "quantity": 1,
        "image": "text",
        "video": "text",
        "probability": 1,
        "current_tier_id": "text",
        "rewards": [
          {
            "uuid": "text",
            "name": "text",
            "description": "text",
            "image_url": "text",
            "terms_and_conditions": "text",
            "metadata": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          }
        ]
      }
    ]
  }
}

Successful response

Updates the lootbox with the provided fields.

patch

Authorizations

Path parameters

loot_box_idanyrequired

Body

descriptionstringrequired

Description of the Lootbox object.

namestringrequired

Name/title of the Lootbox object.

sponsor_namestringoptional

Lootbox sponsor name.

sponsor_descriptionstringoptional

Lootbox sponsor description.

recurring_interval_minutesnumberoptional

Interval indicating how often a Lootbox can be granted.

image_box_together_b64stringoptional

Base 64 string of the combined Lootbox image.

image_box_together_urlstringoptional

URL of the combined Lootbox image.

background_gradient_start_colorstringoptional

Hexadecimal color value for the start of the gradient.

background_gradient_stop_colorstringoptional

Hexadecimal color value for the end of the gradient.

reward_sequence_animation_typestringoptional

Animation type dictating how a rewarded Lootbox is presented.

is_sign_up_rewardbooleanoptional

Boolean flag indicating if the Lootbox should be rewarded at signup.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url '/v2/admin/loot-boxes/{loot_box_id}' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'description=text&name=text&sponsor_name=text&sponsor_description=text&recurring_interval_minutes=1&image_box_together_b64=text&image_box_together_url=text&background_gradient_start_color=text&background_gradient_stop_color=text&reward_sequence_animation_type=text&is_sign_up_reward=true'

200

200

{
  "loot_box": {
    "id": "text",
    "name": "text",
    "description": "text",
    "sponsor_name": "text",
    "sponsor_description": "text",
    "recurring_interval_minutes": 1,
    "image_box_together_url": "text",
    "background_gradient_start_color": "text",
    "background_gradient_stop_color": "text",
    "reward_sequence_animation_type": "SHUFFLE",
    "is_sign_up_reward": true,
    "partner_metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "created_at": 1,
    "updated_at": 1,
    "loot_box_reward_choices": [
      {
        "id": "text",
        "title": "text",
        "subtitle": "text",
        "category": "text",
        "point_reward_value": 1,
        "reward_uuids": [
          "text"
        ],
        "quantity": 1,
        "image": "text",
        "video": "text",
        "probability": 1,
        "current_tier_id": "text",
        "rewards": [
          {
            "uuid": "text",
            "name": "text",
            "description": "text",
            "image_url": "text",
            "terms_and_conditions": "text",
            "metadata": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          }
        ]
      }
    ]
  }
}

Successful response