Get skin purchase information

General

General Information Generate a signature

Deposits

Getting started Create a deposit Create a deposit without redirection (iframe) Deposit notification (webhook) Check an deposit status Get a list of deposits Deposits without 8-day waiting period (Steam Trade Protection) Deposit approval with 8-day hold Get failed webhook notifications

Deposits without SkinsBack UI

Create a deposit without SkinsBack UI (API) Get user's inventory

Skins Withdraw

Skins price list Skins search Buy skin Bulk buy skins Get skin purchase info Skin purchase history

Other

Get the project balance Get the history of withdrawals and deposits of money Get currencies and rates Server status Events real-time: websockets Events real-time: webhooks

Get skin purchase information

Information on the purchased skin. The method allows you to find out the Steam Trade Offer ID, as well as whether the item is accepted by the user (or rejected).

The required parameters are highlighted in blue.

Send a POST request to API Endpoint with the following parameters:

method

string

market_getinfo

buy_id

int

'buy_id' of purchase (from method market_buy)

— OR —

custom_ids

array

'custom_id's in your system. If this parameter is specified, the response will contain an items array containing information on each purchase.

— OR —

buy_ids

array

'buy_id's of purchases. If this parameter is specified, the response will contain an items array containing information on each purchase.

Response from the server:

If successful, a JSON object with the following contents will be sent in response:

item

object

An object containing information about the purchased skin

— item.id

int

Skin ID

— item.name

string

Skin name

— item.price

float

Skin price in USD

— item.classid

string

Class ID of skin

buy_id

int

Skin purchase ID

offer_status

string

Skin purchase status:
1. 'creating_trade' — trade in the process of creation
2. 'waiting_accept' — waiting for trade accept
3. 'accepted' — trade accepted
4. 'canceled' — the trade was rejected by the user
5. 'timeout' — timeout (10 minutes)
6. 'invalid_trade_token' — invalid trade token
7. 'user_not_tradable' — the user has trade restrictions
8. 'trade_create_error' — error of creating a trade (try again)
9. 'rollback_user' — skin has been returned by user (Steam Trade Protection)
10. 'rollback_supplier' — skin has been returned by supplier (Steam Trade Protection)

in_hold

bool

Is the skin in hold or not

in_hold_until

string (datetime)

The date until which the skin will be on hold (a rollback may be made)

error_reason

string

Reason (if present):
1. 'user_cant_trade' - user has a restriction on trading in Steam
2. 'private_inventory' - user needs to open inventory
3. 'user_trade_ban' - user has Trade Ban
4. 'user_inventory_is_full' - user's inventory is full
5. 'too_many_failed_attempts' - too many failed withdrawal attempts for user
6. 'skin_unavailable' - skin unavailable for purchase (or sold)

steamid

string

Steam ID of user

date

int

Purchase date (UNIX time)

balance_debited_sum

float

The amount debited from the project's balance (USD)

tradeofferid

string

Trade Offer ID on Steam (only available if the trade was created)

custom_id

string

'custom_id' in your system

Successful response example:

{
    "status": "success",
    "item": {
        "id": "1280",
        "name": "Taunt: RazorFlip!",
        "price": "0.16",
        "classid": "1723112726"
    },
    "buy_id": "9",
    "offer_status": "trade_create_error",
    "error_reason": null,
    "steamid": "76561198050648523",
    "date": "1596999226",
    "balance_debited_sum": "11.73"
}

List of possible errors:

missing_one_of_required_params

Missing required parameter (buy_id, buy_ids, or custom_ids)

offer_not_found

Skin purchase not found

-6

market_disabled

Market is off

standard errors:

-1

please_use_post_method

Need to use the POST method

-2

invalid_shopid

Project Client ID not found in the system

-3

invalid_signature

Invalid signature

-4

shop_not_active

Project inactive

-5

invalid_method

Invalid API method

-7

request_limit_reached

API requests limit reached (500/per minute)

-8

invalid_ip_address

Specify IP address in merchant panel

-9

under_maintenance

Site under maintenance

-10

invalid_client_secret

Invalid X-CLIENT-SECRET header