Available Items

GET /api/v1/merchant/purchase/available

Returns available items with purchase prices for a given game.

Request

Headers

Header	Required	Description
X-Api-Key	✅	Your merchant API key
Accept	—	application/json

Query Parameters

Parameter	Type	Required	Description
game	string	✅	Game code: csgo, rust, dota2, tf2
full	boolean	—	When true, returns individual items with full details. Default (omitted or false) returns items grouped by name
extended	boolean	—	When true, includes class_id, instance_id, float, inspect_url, phase fields in each item (full format only)

Response

Grouped format (default)

{
  "success": true,
  "message": "Successfully retrieved purchase prices",
  "data": {
    "game": "csgo",
    "total": 542,
    "items": [
      {
        "name": "AK-47 | Redline",
        "count": 3,
        "price": 11.20,
        "game": "csgo",
        "image_url": "https://steamcommunity-a.akamaihd.net/economy/image/class/730/..."
      }
    ]
  }
}

Full format (full=true)

{
  "success": true,
  "message": "Successfully retrieved purchase prices",
  "data": {
    "game": "csgo",
    "total": 1847,
    "items": [
      {
        "id": "38029384123",
        "name": "AK-47 | Redline (Field-Tested)",
        "price": 12.45,
        "image_url": "https://steamcommunity-a.akamaihd.net/economy/image/class/730/...",
        "exterior": "Field-Tested",
        "rarity": "Classified",
        "rarity_color": "#8650AC"
      }
    ]
  }
}

Response Fields (grouped)

Field	Type	Description
game	string	Game code
total	integer	Number of unique item names
items	array	List of items grouped by name
items[].name	string	Item name
items[].count	integer	Number of items available with this name
items[].price	number	Minimum price among items with this name (USD)
items[].game	string	Game code
items[].image_url	string	Steam CDN image URL

Response Fields (full)

Field	Type	Description
game	string	Game code
total	integer	Total number of available items
items	array	List of available items with prices
items[].id	string	ID — use this in Create Purchase
items[].name	string	Item market name
items[].price	number	Purchase price (USD)
items[].image_url	string	Steam CDN image URL
items[].exterior	string | null	Item exterior condition (e.g. "Field-Tested", "Minimal Wear"). Omitted if unavailable
items[].rarity	string | null	Item rarity name. Omitted if unavailable
items[].rarity_color	string | null	Rarity color hex code. Omitted if unavailable
items[].class_id	integer | null	Steam class ID. Only present when extended=true
items[].instance_id	integer | null	Steam instance ID. Only present when extended=true
items[].float	number | null	Item float value. Only present when extended=true
items[].inspect_url	string | null	Steam inspect link. Only present when extended=true
items[].phase	string | null	Item phase (e.g. "Ruby", "Sapphire"). Only present when extended=true

Example

Get all available CS2 items

curl "https://api.skinslink.com/api/v1/merchant/purchase/available?game=csgo" \
  -H "X-Api-Key: your-api-key" \
  -H "Accept: application/json"

Get full item details

curl "https://api.skinslink.com/api/v1/merchant/purchase/available?game=csgo&full=true" \
  -H "X-Api-Key: your-api-key" \
  -H "Accept: application/json"

Get full item details with extended info (float, class_id, etc.)

curl "https://api.skinslink.com/api/v1/merchant/purchase/available?game=csgo&full=true&extended=true" \
  -H "X-Api-Key: your-api-key" \
  -H "Accept: application/json"

WARNING

Prices and availability are point-in-time and may change between lookup and purchase creation. Items are re-priced at purchase time.

Errors

Status	Message	Cause
400	invalid game code	Invalid or missing game parameter
400	validation error	Missing or invalid fields
401	missing authorization header	X-Api-Key header not provided
401	invalid API key	API key not found or inactive
403	merchant account is disabled	Merchant account deactivated
403	invalid IP: <ip>	Request IP not in whitelist
503	internal error	Pricing service temporarily unavailable — retry