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

# List Uploads

Fetch your uploads. Returns all of them by default. Pass `?limit=N` to cap the response (max 1000).

## Behavior

* Returns uploads newest first.
* Each upload includes `code` for the associated post when one exists.
* `isAlbum` is `true` when that upload belongs to an album post.
* `title` is the post's title, or `null` when none is set.
* `priority` is `true` when the post's video is served over priority delivery, and `false` for standard delivery.
* URLs for private uploads are returned as signed URLs with a 24-hour expiry. After that, request the endpoint again for a fresh signed URL.

## Examples

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

## Responses

```json theme={null}
{
  "uploads": [
    {
      "code": "AbCd1234",
      "isAlbum": true,
      "url": "https://i.snipp.gg/364836696149458944/16483ec5681c5fc2b5cc08dd49b7dbae",
      "title": "Nice shot",
      "size": 2487312,
      "size_formatted": "2.37 MB",
      "uploaded": "2026-03-27T11:42:18.000Z",
      "priority": false
    }
  ]
}
```