Skip to main content
POST
/
v2
/
item-offers
Create an item offer
curl --request POST \
  --url https://api.gameboost.com/v2/item-offers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "game_id": 123,
  "game": "<string>",
  "title": "<string>",
  "slug": "<string>",
  "description": "<string>",
  "price": 9.99,
  "stock": 50,
  "min_quantity": 1,
  "delivery_instructions": "<string>",
  "delivery_time": {
    "duration": 24,
    "unit": "hours"
  },
  "image_urls": [
    "https://example.com/item1.jpg"
  ],
  "item_data": {
    "rarity": "legendary",
    "type": "skin"
  }
}'
{
  "data": {
    "id": 123,
    "game": {
      "id": 123,
      "name": "<string>",
      "slug": "<string>"
    },
    "title": "<string>",
    "slug": "<string>",
    "description": "<string>",
    "parameters": {},
    "status": "draft",
    "delivery_time": {
      "duration": 123,
      "unit": "minutes",
      "format": "<string>",
      "format_long": "<string>",
      "seconds": 123
    },
    "delivery_instructions": "<string>",
    "stock": 123,
    "min_quantity": 123,
    "price_eur": "<string>",
    "price_usd": "<string>",
    "views": 123,
    "image_urls": [
      "<string>"
    ],
    "created_at": 123,
    "updated_at": 123,
    "listed_at": 123
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
game_id
integer
required

Unique identifier for the game (required if game slug not provided)

​
title
string
required

Display title for the item offer

Maximum length: 255
​
description
string
required

Detailed description of the items and what is included

Maximum length: 2048
​
price
number
required

Price per unit in EUR currency, up to 2 decimal places

Required range: x >= 0.01
Example:

9.99

​
stock
integer
required

Available quantity of items in stock

Required range: 0 <= x <= 1000000000
Example:

50

​
min_quantity
integer
default:1
required

Minimum quantity that can be purchased in a single order

Required range: 1 <= x <= 1000000000
Example:

1

​
delivery_time
object
required

Expected delivery time object

Example:
{ "duration": 24, "unit": "hours" }
​
image_urls
string[]
required

Array of image URLs showcasing the items. Only one image is required. Recommended: transparent square images for best display. Note: Imgur URLs are not supported

Minimum length: 1

Image URL

Example:
["https://example.com/item1.jpg"]
​
game
string

Slug of the game (required if game_id not provided)

​
slug
string

Custom URL-friendly identifier (auto-generated if not provided)

Maximum length: 255
​
delivery_instructions
string

Special instructions for item delivery, provided to buyer after purchase

​
item_data
object

Specifics available via the template endpoint. Game-specific item attributes such as rarity, type, or category

Example:
{ "rarity": "legendary", "type": "skin" }

Response

A single item offer

​
data
object

Item offer object representing in-game items for sale