Get a stored image
FurniOps' stored copy of an image a product or variant names (its media[].id; media[].stored_url points here): the copy's size and a download link signed for 15 minutes, so a reader can keep its own copy without fetching from the vendor. Readable when the organisation can see a product or variant that names the image, else 404. Until the copy is stored, status is pending or failed and download_url is null.
- Scopes
products:read - Rate classread
/v1/media/{id}FurniOps' stored copy of an image a product or variant names (its media[].id; media[].stored_url points here): the copy's size and a download link signed for 15 minutes, so a reader can keep its own copy without fetching from the vendor. Readable when the organisation can see a product or variant that names the image, else 404. Until the copy is stored, status is pending or failed and download_url is null.
Authorization
apiKey An API key (fo_live_… / fo_test_…) as a bearer token
In: header
Path Parameters
Image (one image URL a catalogue's records name, and what FurniOps kept of it) ID
^img_[0-9A-Za-z]{22}$Header Parameters
Dated API version; pinned per organisation on first use and overridable per request
Value in
- "2026-10-01"
- "2026-10-04"
The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused
Value in
- "live"
- "test"
ETag of a cached representation; a match returns 304
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/media/string"{ "id": "string", "url": "string", "status": "pending", "width": 1, "height": 1, "bytes": 1, "object": "media_file", "content_type": "image/webp", "download_url": "http://example.com", "download_expires_at": "2019-08-24T14:15:22Z"}