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

Fetch a post by its share code.

## Behavior

* Albums (posts with more than one file) include `urls` and `isAlbum: true`.
* Video posts include `thumbnailUrl`, a generated still frame. For private posts it is a signed URL with the same 24-hour expiry as the file URL.
* The `author` object describes the post's uploader. `author` is `null` if the user has been deleted.
* Use `fileName` from the `files` array when calling [`/deleteUpload`](/relay-reference/endpoint/delete) to address a specific file. On albums, `/deleteUpload` removes just that file; on single-file posts it deletes the post.
* Hits to this endpoint count a view toward the post. Views are deduplicated per IP and post: up to 3 counted views per IP per post per hour. Views are only counted on public, non-moderated posts.
* Private posts are only visible to the owner. Requests for another user's private post return `404`.
* URLs for private posts are returned as signed URLs with a 24-hour expiry. After that, request the endpoint again for a fresh signed URL.
* Moderated posts are only fully returned to their owner, with `moderated: true` on the post. Requests by anyone else return `403` with `moderated: true`.
* Restricted posts carry `restricted: true` on the post when returned to their owner. A restricted post is forced to `unlisted` and cannot be set back to public; see [Edit Upload](/relay-reference/endpoint/edit).
* `priority` is `true` when the post's video is served over priority delivery, and `false` for standard delivery.

## Examples

Fetch a post by code:

```bash theme={null}
curl -X GET "https://relay.snipp.gg/posts/AbCd1234" \
  -H "relay-key: YOUR_RELAY_KEY"
```

## Responses

Single-file post:

```json theme={null}
{
  "post": {
    "code": "AbCd1234",
    "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
    "files": [
      {
        "index": 0,
        "fileName": "a1b2c3d4e5f6789012345678abcdef01.png",
        "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
        "width": 1920,
        "height": 1080,
        "mime_type": "image/png",
        "size": 2487312,
        "size_formatted": "2.37 MB"
      }
    ],
    "title": "Nice shot",
    "description": null,
    "postPrivacy": "public",
    "created": "2026-05-03T12:00:00Z",
    "views": 128,
    "likeCount": 42,
    "liked": false,
    "commentCount": 3,
    "author": {
      "id": "123456789012345678",
      "username": "playerone",
      "nickname": "Player One",
      "avatar": "https://cdn.snipp.gg/avatars/123456789012345678/avatar.png",
      "verified": false,
      "plus": true
    },
    "priority": false,
    "file": {
      "size": 2487312,
      "size_formatted": "2.37 MB",
      "mime_type": "image/png",
      "dimensions": { "width": 1920, "height": 1080 }
    }
  }
}
```

Album post (includes `urls` and `isAlbum`):

```json theme={null}
{
  "post": {
    "code": "AbCd1234",
    "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
    "urls": [
      "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
      "https://i.snipp.gg/123456789012345678/b2c3d4e5f6789012345678abcdef0102.png"
    ],
    "isAlbum": true,
    "files": [
      {
        "index": 0,
        "fileName": "a1b2c3d4e5f6789012345678abcdef01.png",
        "url": "https://i.snipp.gg/123456789012345678/a1b2c3d4e5f6789012345678abcdef01.png",
        "width": 1920,
        "height": 1080,
        "mime_type": "image/png",
        "size": 2487312,
        "size_formatted": "2.37 MB"
      },
      {
        "index": 1,
        "fileName": "b2c3d4e5f6789012345678abcdef0102.png",
        "url": "https://i.snipp.gg/123456789012345678/b2c3d4e5f6789012345678abcdef0102.png",
        "width": 1280,
        "height": 720,
        "mime_type": "image/png",
        "size": 1843210,
        "size_formatted": "1.76 MB"
      }
    ],
    "title": "Match highlights",
    "description": null,
    "postPrivacy": "public",
    "created": "2026-05-03T12:00:00Z",
    "views": 128,
    "likeCount": 42,
    "liked": false,
    "commentCount": 3,
    "author": {
      "id": "123456789012345678",
      "username": "playerone",
      "nickname": "Player One",
      "avatar": "https://cdn.snipp.gg/avatars/123456789012345678/avatar.png",
      "verified": false,
      "plus": true
    },
    "file": {
      "size": 2487312,
      "size_formatted": "2.37 MB",
      "mime_type": "image/png",
      "dimensions": { "width": 1920, "height": 1080 }
    }
  }
}
```