Skip to main content

Get User Information

GET /user/infos

Retrieves comprehensive user profile information. Admin users can query other users by providing a user ID.
GET /user/infos
GET /user/infos/{userid}   (admin)
Authentication: connected (admin for other users) Response
{
  "status": "success",
  "data": {
    "informations": {
      "steamId": "76561198000000000",
      "balance": 15000,
      "skrill": "",
      "tradeurl": "https://steamcommunity.com/tradeoffer/new/?partner=...",
      "since": 1609459200,
      "image": "https://avatars.steamstatic.com/...",
      "2fa": "true",
      "name": "PlayerName",
      "lastactivity": 1706745600,
      "discordtag": "Player#1234",
      "discord": "123456789",
      "shorturl": "player",
      "message": 0,
      "notification": 1
    }
  }
}

User Object

FieldTypeDescription
steamIdstringUser’s Steam 64-bit ID
balanceintegerAccount balance in cents
skrillstringSkrill email (if configured)
tradeurlstringSteam trade URL
sinceintegerAccount creation timestamp
imagestringSteam avatar URL
2fastring"true" if 2FA is enabled, "false" otherwise
namestringDisplay name
lastactivityintegerLast activity timestamp
discordtagstringDiscord tag
discordstringDiscord user ID
shorturlstringCustom profile short URL
messageintegerUnread message count
notificationintegerEmail notification preference (1 = enabled)

Get Balance

GET /user/balance

Retrieves only the user’s current balance. Admin users can query other users.
GET /user/balance
GET /user/balance/{userid}   (admin)
Authentication: connected (admin for other users) Response
{
  "status": "success",
  "data": {
    "balance": 15000
  }
}
data.balance
integer
The user’s balance in cents. Divide by 100 to get the dollar amount.

Get Sales Info

GET /user/getSalesInfos

Retrieves summary information about the user’s items currently on sale.
GET /user/getSalesInfos
GET /user/getSalesInfos/{userid}   (admin)
Authentication: connected (admin for other users) Response
{
  "status": "success",
  "data": {
    "informations": {
      "nb": 42,
      "price": 125000,
      "user": "76561198000000000"
    }
  }
}
FieldTypeDescription
nbintegerNumber of items currently on sale
priceintegerTotal value of items on sale (in cents)
userstringSteam ID of the user

Get Sales Chart Info

GET /user/getSalesChartInfos

Retrieves sales statistics and graph data for a specified period.
GET /user/getSalesChartInfos
GET /user/getSalesChartInfos/{userid}   (admin)
Authentication: connected (admin for other users) Query Parameters
period
string
default:"1M"
Time period for the chart. Values: 1W (week), 1M (month), 1Y (year), All.
chart_only
boolean
If present, returns only graph data without summary statistics.
Response (full)
{
  "status": "success",
  "data": {
    "informations": {
      "week": 5000,
      "month": 25000,
      "global": 150000,
      "previousWeek": 4500,
      "previousMonth": 22000,
      "currentYear": 80000,
      "graph": [
        { "date": "2025-01-01", "buy": 1000, "sale": 2000 }
      ]
    }
  }
}
Response (chart_only)
{
  "status": "success",
  "data": {
    "informations": {
      "graph": [
        { "date": "2025-01-01", "buy": 1000, "sale": 2000 }
      ]
    }
  }
}

Get Notifications

GET /user/notifications

Retrieves the count of unread notifications and payment reviews.
GET /user/notifications
Authentication: connected Response
{
  "status": "success",
  "data": {
    "count": 3,
    "paymentReviews": 1
  }
}
FieldTypeDescription
countintegerNumber of unread payment alerts
paymentReviewsintegerNumber of unread payment reviews

Close Payment Alert

POST /user/closePaymentAlert

Marks a specific payment alert as read/closed.
POST /user/closePaymentAlert
Authentication: connected Body Parameters
id
string
required
The ID of the payment alert to close.
Response
{
  "status": "success",
  "data": {
    "message": "Alert closed successfully"
  }
}

Close Payment Reviews

POST /user/closePaymentReviews

Marks all payment reviews as read for the current user.
POST /user/closePaymentReviews
Authentication: connected Response
{
  "status": "success",
  "data": {
    "message": "Payment reviews marked as read successfully"
  }
}

Get Contact Email

GET /user/getContactMail

Retrieves the user’s contact email address.
GET /user/getContactMail
GET /user/getContactMail/{userid}   (admin)
Authentication: connected (admin for other users) Response
{
  "status": "success",
  "data": {
    "address": "[email protected]"
  }
}

Generate CSV Token

GET /user/generateCSVToken

Generates a SHA-512 token for CSV export authentication.
GET /user/generateCSVToken
GET /user/generateCSVToken/{userid}   (admin)
Authentication: connected (admin for other users) Response
{
  "status": "success",
  "data": {
    "token": "a1b2c3d4e5f6..."
  }
}

Set Affiliates

POST /user/setAffiliates

Registers an affiliate click via Tapfiliate. Works for both connected and anonymous users.
POST /user/setAffiliates
Authentication: None Body Parameters
ref
string
required
The referral code from the affiliate link.
Response
{
  "status": "success",
  "data": {
    "affiliate_id": "click_abc123"
  }
}

Get User Buy Order for Item

GET /user/buyorder/:item

Retrieves the current user’s buy order for a specific item.
GET /user/buyorder/{item}
Authentication: connected Path Parameters
item
integer
required
The item ID to check buy order for.
Response
{
  "status": "success",
  "data": {
    "informations": {
      "id": 1234,
      "user": "76561198000000000",
      "item_id": 5678,
      "amount": 5,
      "value": 1500
    }
  }
}