> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snipp.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

```bash theme={null}
curl -X GET "https://api.snipp.gg/users/@me" \
  -H "api-key: YOUR_API_KEY"
```

Fetch another profile with a smaller public uploads payload:

```bash theme={null}
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`.

```json theme={null}
{
  "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`.

```json theme={null}
{
  "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
      }
    ]
  }
}
```