# StableUpload Get Upload Details

> StableUpload Get Upload Details is a free API for AI agents from StableUpload at stableupload.dev, Free, status unknown (last checked 2026-10-10).

Retrieve metadata for a specific upload by its ID, without returning the actual file bytes

## Facts

- Endpoint: GET https://stableupload.dev/api/download/:uploadId?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Provider: StableUpload
- Docs: https://stableupload.dev
- Website: https://stableupload.dev
- Tags: upload, files, hosting, static-site, cdn, storage
- Canonical page: https://www.zero.xyz/c/stableupload-uploadid-b7422954
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-qu2HHpzOwAHQ0iwkzalD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stableupload-uploadid-b7422954
```

Example prompt: Can you pull up the details for my StableUpload file with upload ID abc123? I want to see its metadata like status, TTL, and any associated URLs.

## When to prefer this

Use this endpoint when you already have a specific uploadId and need to inspect its metadata, status, or hosting details — not when listing all uploads (use the Uploads list endpoint) or when downloading file contents. Ideal for verifying an upload exists, checking its TTL, or confirming hosting URLs before linking to it.

## Known failure modes

- Upload ID not found — 404 if the uploadId does not exist or has expired
- Invalid upload ID format — 400 if the ID is malformed
- Unauthorized — 401 if the wallet authentication is missing or invalid
- Upload TTL expired — the upload may no longer exist after the 6-month TTL
- Network or service error — 500 if StableUpload is temporarily unavailable

## How this service works

Get upload details by ID

## Output

Returns metadata about the specified upload — including its ID, status, file details, TTL expiry, hosting URLs, and other associated properties — but does not return the raw file bytes themselves.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 50,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum uploads to return, 1-100. Default 50."
  },
  "cursor": {
   "type": "string",
   "description": "Pagination cursor from the previous nextCursor."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stableupload-uploadid-b7422954/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stableupload.dev](https://www.zero.xyz/host/stableupload.dev/llms.txt)