Get Media Item by ID

Retrieves a media item (image, video, or file) by its ID

GET/api/v1/{app_id}/folders/{folder_id}/media/{media_id}

API: DAM
OpenAPI: dam-api
Updated: Apr 26, 2026

dam-api:GET:/api/v1/{app_id}/folders/{folder_id}/media/{media_id}

Retrieves a media item (image, video, or file) by its ID

API ownership

API family: DAM public reads
Best for: Public asset-library folder, media, facet, and shareable-link reads. Use Management API DAM routes for authenticated administration.
Guide route: /media/dam/latest

The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.

Operation

Method: GET
Path: /api/v1/\{app_id\}/folders/\{folder_id\}/media/\{media_id\}
Summary: Get Media Item by ID
Description: Retrieves a media item (image, video, or file) by its ID
OpenAPI contract: dam-api
Operation ID: Not documented in the OpenAPI contract.

Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.

Parameters3 parameters

Name	In	Required	Type	Description
app_id	path	Yes	string	App ID
folder_id	path	Yes	string	Folder ID
media_id	path	Yes	string	Media ID

Request bodyNo documented body

Not documented in the OpenAPI contract.

Responses6 statuses

Status	Description	Content
200	Media item retrieved successfully	application/json (object)
400	Invalid request	application/json (object)
401	Unauthorized access	application/json (object)
403	Forbidden: Folder is not public	application/json (object)
404	Media item not found	application/json (object)
500	Internal server error	application/json (object)

200 - object

Media Item Response

Property	Type	Required	Details
`data`	object	No	-
`success`	boolean	No	-

Media Item

Property	Type	Required	Details
`alt_text`	string	No	-
`attributes`	object[]	No	-
`blurhash`	string	No	-
`copyright`	string	No	-
`created_at`	string	No	-
`custom`	integer[]	No	-
`description`	string	No	-
`file_type`	string	No	-
`folder`	object	No	-
`id`	string	No	-
`status`	string	No	-
`title`	string	No	-
`translations`	object	No	-
`type`	string	No	-
`updated_at`	string	No	-
`url`	string	No	-
`variants`	object[]	No	-

Attribute

Property	Type	Required	Details
`description`	string	No	-
`id`	string	No	-
`key`	string	No	-
`name`	string	No	-
`values`	object	No	-

Folder Ref

Property	Type	Required	Details
`id`	string	No	-
`name`	string	No	-
`public`	boolean	No	-
`slug`	string	No	-

Video Variant

Property	Type	Required	Details
`created_at`	string	No	-
`format`	string	No	-
`height`	integer	No	-
`id`	string	No	-
`updated_at`	string	No	-
`url`	string	No	-
`width`	integer	No	-

{
  "data": {
    "alt_text": "string",
    "attributes": [
      {
        "description": "string",
        "id": "string",
        "key": "string",
        "name": "string",
        "values": {}
      }
    ],
    "blurhash": "string",
    "copyright": "string",
    "created_at": "string",
    "custom": [
      0
    ],
    "description": "string",
    "file_type": "string",
    "folder": {
      "id": "string",
      "name": "string",
      "public": false,
      "slug": "string"
    },
    "id": "string",
    "status": "string",
    "title": "string",
    "translations": {},
    "type": "string",
    "updated_at": "string",
    "url": "string",
    "variants": [
      {
        "created_at": "string",
        "format": "string",
        "height": 0,
        "id": "string",
        "updated_at": "string",
        "url": "string",
        "width": 0
      }
    ]
  },
  "success": false
}