API Documentation

Explore the documentation and get started with Skinify
Skins Withdraw Buy and withdraw a skin

This method allows you to purchase a skin and send it to a Steam user.

HTTP Request

POST https://skinify.io/api/withdraw/buy

POST Parameters
Parameter
Required
Description
partner
'partner' parameter from user Trade URL
token
'token' parameter from user Trade URL
name + game
— Or —
id
Skin name + game (dota2, csgo, rust)
— Or —
Skin ID from search results
max_price
The maximum price of the skin to purchase (in USD). Used as a cost limiter.
custom_id
ID on your system. It can be used to prevent double purchases.
Response

The response will contain the following data:

Parameter
Description
skin
Object containing data about the purchased skin
purchase_id
Purchase ID, used later to track the status of the purchase
purchase_status
Purchase status. This method can only contain purchase_status=processing, but the following statuses are possible in other methods:
  • processing — trade is being processed
  • waiting_accept — waiting for the user to accept trade
  • accepted — trade was accepted by the user
  • canceled — trade was rejected by the user
  • timeout — waiting time for accepting trade has ended (5 minutes)
  • error_invalid_token — invalid 'token' parameter was passed
  • error_user_not_tradable — user has restrictions on accepting trades
  • error_create_failed — failed to create trade (try again)
date
Purchase date (unix timestamp)
balance_debited_amount
The amount debited from the balance
custom_id
The custom_id you passed
Response example
{ "status": "success", "skin": { "id": "11552", "name": "Crimson Pique", "price": 0.3, "properties": { "classid":"1723113626" } }, "purchase_id": 1, "purchase_status": "processing", "date": "1643714026", "balance_debited_amount": 0.3, "custom_id": "1234" }
Possible Errors
Error
Description
missing_skin_parameters
Required parameters are missing (name + game or id)
name_too_short
The minimum length of the skin name is 3 characters. Check the 'name' parameter and what data is passed to it
missing_partner_or_token
Missing 'token' or 'partner' paremeters
insufficient_funds
There are not enough funds on the project balance to purchase a skin
skin_unavailable
The skin is not available for purchase
skins_not_found_at_specified_price
There are no skins available, the cost of which is <= 'max_price'
custom_id_exists
A purchase has already been made with the specified custom_id
withdraw_unavailable
The withdraw is temporarily unavailable