Get User

Fetch either your own profile (@me) or another user’s public profile.

Behavior

id=@me returns your full account profile, including apiKey, keyHasUploadsAccess, limits, 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.
bugHunterTier is an integer from 0 to 2: 0 is no badge, 1 is Bug Hunter, 2 is Elite Bug Hunter.
includePosts controls publicUploads.
includePosts defaults to false for @me and true for non-self requests.
postsLimit limits publicUploads to 1 to 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.".

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"

Responses

@me returns your full account profile, including apiKey, keyHasUploadsAccess, and limits.

{
  "user": {
    "id": "123456789012345678",
    "username": "playerone",
    "avatar": "https://i.snipp.gg/avatars/123456789012345678/avatar.png",
    "banner": "https://i.snipp.gg/banners/123456789012345678/banner.png",
    "nickname": "Player One",
    "bio": "Building things at Snipp",
    "socials": { "github": "https://github.com/playerone" },
    "plus": true,
    "enterprise": false,
    "verified": false,
    "staff": false,
    "partner": false,
    "bugHunterTier": 0,
    "translator": false,
    "suspended": false,
    "created": "2026-01-04T09:30:00Z",
    "customEmbed": null,
    "apiKey": "aB3xK9mP2qR7sT1vW4yZ6cD8fG0hJ5kL",
    "keyHasUploadsAccess": true,
    "uploads": 42,
    "badges": {
      "verified": false,
      "staff": false,
      "partner": false,
      "bugHunterTier": 0,
      "translator": false,
      "plus": true
    },
    "limits": {
      "plan": "plus",
      "maxFileSize": null,
      "usage": {
        "used": 5242880,
        "limit": 21474836480,
        "usedPercent": 0,
        "windowStart": "2026-05-12T00:00:00Z",
        "windowEnd": "2026-05-19T00:00:00Z",
        "resetsInSeconds": 345600
      }
    }
  }
}

A non-self request returns a public-safe profile with blockedByYou and (by default) publicUploads.

{
  "user": {
    "id": "987654321098765432",
    "username": "playertwo",
    "avatar": "https://i.snipp.gg/avatars/987654321098765432/avatar.png",
    "banner": null,
    "nickname": "Player Two",
    "bio": null,
    "socials": null,
    "plus": false,
    "enterprise": false,
    "verified": false,
    "staff": false,
    "partner": false,
    "bugHunterTier": 1,
    "translator": false,
    "created": "2026-02-18T14:00:00Z",
    "suspended": false,
    "customEmbed": null,
    "badges": {
      "verified": false,
      "staff": false,
      "partner": false,
      "bugHunterTier": 1,
      "translator": false,
      "plus": false
    },
    "blockedByYou": false,
    "publicUploads": [
      {
        "url": "https://i.snipp.gg/987654321098765432/a1b2c3d4e5f6789012345678abcdef01.png",
        "code": "AbCd1234",
        "title": "Launch teaser",
        "description": null,
        "created": "2026-02-19T10:00:00Z",
        "public": true,
        "isAlbum": false
      }
    ]
  }
}

Overview

Uploads

Posts

Users

Meta

Behavior

Examples

Responses

​Behavior

​Examples

​Responses

Behavior

Examples

Responses