Appearance
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 |
Response
Grouped format (default)
json
{
"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)
json
{
"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/..."
}
]
}
}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 |
Example
Get all available CS2 items
bash
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
bash
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"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 |
