Documentation

Trustify API

Free, public REST API for querying real-time reputation data — vouch counts, seller profiles, staff info, and scammer lookups. No authentication required for most endpoints.

Base URL https://trustify.fun

Authentication

All endpoints are public except one protected route.

Public routes — No key required. Call the URL directly.
Protected routes — Send Authorization: Bearer <secret>

Example — Authenticated

GET /vouch/12345
Authorization: Bearer your_secret

Global Stats

Platform-wide vouch and user statistics in real time.

GET /api/stats Public ▾

Response

{
  "vouches": {
    "total":    71415, "accepted": 68200,
    "pending":  91,    "denied":   3124,
    "positive": 67800, "negative": 400
  },
  "scammers": 312, "blacklisted": 47, "users_with_vouches": 9841
}

User Stats

Vouch counts and safety flags for a single Discord user.

GET /api/user/{discord_id} Public ▾

Param	Type	Description
discord_idrequired	string	Discord user ID (snowflake)

Response

{
  "user_id": "1284613557148717066",
  "vouches": { "total": 312, "positive": 305, "negative": 2, "pending": 3 },
  "flags": { "is_scammer": false, "is_blacklisted": false, "is_dwc": false }
}

Full Profile

Complete seller profile — badges, shop, recent vouches, avatar URL.

GET /api/user/{discord_id}/profile Public ▾

Param	Type	Description
discord_idrequired	string	Discord user ID

Response

{
  "user_id": "1284613557148717066", "username": "zen",
  "avatar_url": "https://cdn.discordapp.com/avatars/...",
  "shop": "https://shopmy.us/...", "forum": null,
  "badges": ["Staff", "Top-10 Vouches"],
  "vouches": { "positive": 305, "negative": 2, "total": 312 },
  "recent_vouches": [{ "type": "Positive", "comment": "Fast!", "date": "28/03/2026" }],
  "flags": { "is_scammer": false, "is_blacklisted": false },
  "chain_tx": null,
  "profile_url": "https://trustify.fun/u/1284613557148717066"
}

Staff List

All current staff members with their review stats.

GET /api/staff Public ▾

Response

{
  "total": 12,
  "staff": [{
    "user_id": "123456", "username": "mod", "display_name": "Mod",
    "avatar_url": "https://cdn.discordapp.com/...",
    "staff_since": 1709251200,
    "stats": { "reviewed": 1420, "accepted": 1380, "denied": 40 }
  }]
}

Scammer Lookup

Search the flagged user database by Discord ID or keyword.

GET /api/scammers Public ▾

Param	Type	Description
qoptional	string	Discord ID or keyword. Leave empty for full list.

Example

GET /api/scammers?q=123456789

Response

{
  "total": 1,
  "scammers": [{ "user_id": "123456789", "reason": "Exit scam" }]
}

Get Vouch

Retrieve a specific vouch by ID. Requires authentication.

GET /vouch/{vouch_id} Auth Required ▾

Requires Authorization: Bearer <secret>

Param	Type	Description
vouch_idrequired	integer	Numeric vouch ID

Response

{
  "id": 42301, "type": "Positive",
  "giver_id": "111222", "recipient_id": "444555",
  "comment": "Smooth transaction!",
  "date": "28/03/2026 21:30", "status": "accepted"
}

Web Pages

Human-readable pages served directly by the bot.

/	Landing page with live stats
/stats	Full platform statistics
/staff	Staff directory with performance data
/scammers	Searchable scammer database
/u/{discord_id}	Public seller profile page
/docs	This documentation

All data is served in real time from the bot's JSON files. No caching — avoid hammering more than a few requests per second.