Skip to main content
GET
/
v1
/
medias
/
{id}
Retrieve
curl --request GET \
  --url https://{defaultHost}/v1/medias/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "688b2cb8-3a0b-413d-9b96-b5728f3f7e11",
  "object": "media",
  "alt": null,
  "byte_size": 12254,
  "content_type": "image/png",
  "extension": "png",
  "filename": "test.png",
  "height": null,
  "public_access": false,
  "release_json": null,
  "title": null,
  "url": null,
  "width": null,
  "url_expires_at": null,
  "created_at": 1767909724,
  "updated_at": 1767909724
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Query Parameters

​
expose_for
integer

Sets how long a private media URL should be valid for, in seconds. The max value allowed is 86400 or 24 hours. When exposing a media through a purchase or license the default value is 900 or 15 minutes.

Response

200 - application/json

Success

​
id
string | null

The UUID of the specific object.

​
object
string

A string describing the object type returned.

​
byte_size
integer

The size of the media in bytes.

​
content_type
string

The content type (i.e. image/png, image/jpg, application/pdf).

​
extension
string

The extension (i.e. png, jpg, pdf).

​
filename
string

The full filename with extension.

​
height
string | null

If the media is an image, this will be the height in pixels.

​
public_access
boolean

Whether or not this media is publicly accessible.

​
release_json
object

The JSON that was extracted from the release.json file within the ZIP file.

​
url
string | null

The URL for accessing this media. If the media is public, this will be a permanent URL. If the media is private, this will be a short-lived URL if the media has been exposed.

​
url_expires_at
integer | null

The time at which the URL expires. This will only be present if the media is private and has been exposed.

​
width
string | null

If the media is an image, this will be the width in pixels.

​
created_at
integer | null

Time at which the object was created. Measured in seconds since the Unix epoch.

​
updated_at
integer | null

Time at which the object was last updated. Measured in seconds since the Unix epoch.