{"uid":"cap_-qu2HHpzOwAHQ0iwkzalD","slug":"stableupload-uploadid-b7422954","name":"StableUpload Get Upload Details","description":"Get upload details by ID","url":"https://stableupload.dev/api/download/:uploadId?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["upload","files","hosting","static-site","cdn","storage"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"unknown","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"StableUpload","brandSlug":"stableupload","brandBaseUrl":"https://stableupload.dev","brandDocsUrl":"https://stableupload.dev","whatItDoes":"Retrieve metadata for a specific upload by its ID, without returning the actual file bytes","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Verify uploaded file before sharing","prompt":"I need to check if my upload is still active and get the hosting URL so I can share it with my team. Can you look up the details for upload ID xyz789?"},{"title":"Monitor upload expiration and TTL status","prompt":"Pull up the metadata for my recent upload with ID def456. I want to make sure it hasn't expired yet and see how much time is left before the TTL runs out."},{"title":"Confirm file details after bulk import","prompt":"I just uploaded a large dataset with ID ghi012. Can you retrieve the upload record to verify the file size, status, and any hosting information so I know it processed correctly?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:34:29.052Z","isFirstParty":false,"canonicalSlug":"stableupload-uploadid-b7422954"}