v1

latestOpenAPI 3.0.02026-07-14416.5 KB

Retrieve a media item

Retrieve information about a single media item

get/:id/info

Response

Successfully retrieved

account_idstring

The ID of your Nexmo account. This is the same as your API key.

etagstring

An identifier for the content. This will change if the content of the file has been changed (i.e. if you upload a new version of the file). For more information see Wikipedia: HTTP ETag

idstring

A UUID representing the object.

max_downloads_allowedinteger

The maximum number of times the file may be downloaded.

media_sizeinteger

The size of the file in bytes

metadata_primarystring

A user set string containing metadata about the media file.

metadata_secondarystring

A user set string containing further metadata about the media file.

mime_typestring

The IETF MIME type of the file.

original_file_namestring

The filename of the object as it was originally uploaded.

publicboolean

Whether the item is available for download without authentication.

store_idstring

An internal identifier of how the file is stored.

time_createdstring

A timestamp for the time that the file was created

time_last_updatedstring

A timestamp for the time that the file was last modified

times_downloadedinteger

The number of times the file has been downloaded.

Example response

{
  "account_id": "abcd1234",
  "etag": "aaaaaaaabbbbccccdddd0123456789ab",
  "id": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
  "media_size": 1234567,
  "mime_type": "audio/vnd.wave",
  "original_file_name": "test.wav",
  "store_id": "s3",
  "time_created": "2020-01-01T14:00:00.000Z",
  "time_last_updated": "2020-01-01T14:00:00.000Z",
  "times_downloaded": 1
}