{"uid":"cap__QN0Bmmh69xdHLxNza9iy","slug":"agents-vimmerse-net-get-media-by-id-5d9b0ec8","name":"Get Media by ID","description":"Retrieves a single media object by ID. Response is **application/json** with the same fields shown in the example above.\n\nUse the optional `fields` query parameter to request only specific keys (allowed keys are those in the media response body). When omitted, the full media object is returned.","url":"https://agents.vimmerse.net/v2/media/{media_id}?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["media_id"],"properties":{"fields":{"type":"string","title":"Field Selection","default":"","description":"Comma-separated list of specific fields to retrieve from the media object. Example: 'title,description,processing_status,progress_percentage'. If not provided, all fields are returned. Useful for reducing response size when only specific information is needed."},"media_id":{"type":"string","title":"Media ID","examples":["abc123-def456-ghi789"],"description":"Unique identifier of the media"}}},"responseSchema":{},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_wyu3OhRMCFAtSWvhlOQSq","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.vimmerse.net","brandSlug":"agents-vimmerse-net-x402","brandBaseUrl":"https://agents.vimmerse.net","brandDocsUrl":null,"whatItDoes":"Retrieves a single media object by its unique ID, optionally filtered to specific fields.","exampleAgentPrompt":"Check the current processing status and progress percentage of my Vimmerse media job with ID abc123-def456-ghi789.","exampleUseCases":[{"title":"Poll video generation until complete","prompt":"Keep checking on my Vimmerse media job abc123-def456-ghi789 and let me know when processing_status changes to done — also show me the progress_percentage each time."},{"title":"Retrieve full media object details","prompt":"Fetch all the details for Vimmerse media ID xyz789-abc123-lmn456, including its title, description, and any result URLs."},{"title":"Lightweight status check for a submitted job","prompt":"Just grab the processing_status and progress_percentage from media job def456-ghi789-jkl012 on Vimmerse — I don't need any other fields right now."}],"resultDescription":"A JSON object representing the media record, including fields such as title, description, processing_status, progress_percentage, and result URLs. When the `fields` parameter is specified, only the requested subset of keys is returned; otherwise the full media object is returned.","failureModes":["Invalid or unknown media_id returns a 404 not found error","Requesting an invalid field name in `fields` may return an error or be silently ignored","Authentication or payment failure returns 402 or 401","Network timeout if the service is under load","Empty response if media was deleted or expired"],"whenToPreferThis":"Use this endpoint when you need to check the status or details of a previously submitted media job on Vimmerse — especially for polling async jobs (video, audio, story, workflow) to see if they have completed. Prefer it over listing endpoints when you already have the media_id and want targeted, lightweight lookups using the `fields` parameter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:30:19.250Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-get-media-by-id-5d9b0ec8"}