Skip to main content
GET
/
users
/
{id}
Get user
curl --request GET \
  --url https://api.snipp.gg/users/{id} \
  --header 'api-key: <api-key>'
{
  "user": {
    "id": "123456789012345678",
    "username": "snipp",
    "avatar": "https://cdn.snipp.gg/avatar.png",
    "banner": null,
    "nickname": "Snipp",
    "bio": null,
    "socials": null,
    "key": "snp_xxx",
    "keyHasUploadsAccess": true,
    "plus": true,
    "enterprise": false,
    "verified": true,
    "staff": false,
    "partner": false,
    "translator": false,
    "bugHunterTier": 0,
    "suspended": false,
    "created": "2025-01-01T00:00:00.000Z",
    "embed_settings": null,
    "badges": {
      "verified": true,
      "staff": false,
      "partner": false,
      "bugHunterTier": 0,
      "translator": false,
      "plus": true
    },
    "uploads": 42
  }
}
Use this endpoint to fetch either your own profile (@me) or another user’s public profile.

​
Behavior

  • id=@me returns your full account profile, including key, keyHasUploadsAccess, and uploads.
  • id=<userId> returns a public-safe profile for that user.
  • badges is always included and follows this order: verified, staff, partner, bugHunterTier, translator, plus.
  • includePosts controls publicUploads.
  • includePosts defaults to false for @me and true for non-self requests.
  • postsLimit limits publicUploads to 1-50 (default 50).
  • Non-self profiles include a blockedByYou boolean indicating whether you have blocked that user.
  • If the target user has blocked you, the endpoint returns 403 with "You have been blocked by this user.". Staff accounts are exempt.

​
Examples

Fetch your own profile: 
curl -X GET "https://api.snipp.gg/users/@me" \
  -H "api-key: YOUR_API_KEY"
Fetch another profile with a smaller public uploads payload: 
curl -X GET "https://api.snipp.gg/users/USER_ID?includePosts=true&postsLimit=10" \
  -H "api-key: YOUR_API_KEY"

Authorizations

​
api-key
string
header
required

Your API key from Snipp.gg

Path Parameters

​
id
string
required

User ID or @me for the authenticated user

Query Parameters

​
includePosts
boolean

Include publicUploads in the response. Defaults to true for non-self requests and false for @me.

​
postsLimit
integer

Maximum number of publicUploads to return (1-50, default 50).

Required range: 1 <= x <= 50

Response

User data

​
user
object
required