Skip to content
Esc
↑↓navigate↵open⌘Jpreview

Get Folder Contents

Retrieves paginated, filtered, and sorted media items in a folder

GET/api/v1/{app_id}/folders/{id}/contents
Authorization
AuthorizationAPI key · headerrequired

Bearer token (format: "Bearer {token}")

Path parameters
app_idstringrequired

App ID

idstringrequired

Folder ID

Query parameters
pageinteger

Page number (default: 1)

per_pageinteger

Items per page (default: 20, max: 100)

typestring

Filter by type: image, video, file, all (default: all)

sort_bystring

Sort field: name, created_at, updated_at, type (default: created_at)

sort_orderstring

Sort order: asc, desc (default: desc)

attributesstring[]

Filter by attribute(s). Repeat the query parameter once per filter, each in the form template_key/attribute_key. Filters sharing the same template_key combine with OR; distinct template_keys combine with AND. Example: ?attributes=color/red&attributes=color/blue&attributes=size/large

Responses
200

Folder contents

datainternal_pkg_webserver_public-webserver_v1.MediaItemResponse[] | null
Show properties
Array of internal_pkg_webserver_public-webserver_v1.MediaItemResponse
alt_textstring | null
attributesAttributeResponse[] | null
Show properties
Array of AttributeResponse
descriptionstring
idstring
keystring
namestring
valuesobject | null
blurhashstring | null
copyrightstring | null
created_atstring
custominteger[] | null
descriptionstring | null
file_typestring | null
folderFolderRef | null
Show properties
Any of:
FolderRef
idstring
namestring
publicboolean
slugstring
null
null
idstring
statusstring | null
titlestring | null
translationsMediaItemTranslations
Show properties
altTranslation[] | null
Show properties
Array of Translation
idstring
localestring
valuestring
descriptionTranslation[] | null
titleTranslation[] | null
typeTranslation[] | null
typestring
updated_atstring | null
urlstring
variantsVideoVariantResponse[] | null
Show properties
Array of VideoVariantResponse
created_atstring
formatstring
heightinteger
idstring
updated_atstring
urlstring
widthinteger
paginationinternal_pkg_webserver_public-webserver_v1.PageInfo
Show properties
pageinteger
per_pageinteger
total_itemsinteger
total_pagesinteger
successboolean
400

Invalid request

detailsstring[] | null
errorstring
404

Folder not found

detailsstring[] | null
errorstring
500

Internal server error

detailsstring[] | null
errorstring
Try it
Server
Authorization
Parameters
Request
curl -X GET '//dam.enad.io/api/v1/string/folders/string/contents' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "data": [
    {
      "alt_text": "string",
      "attributes": [
        {
          "description": "string",
          "id": "string",
          "key": "string",
          "name": "string",
          "values": {
            "property1": [
              {
                "type": "string",
                "value": "string"
              }
            ],
            "property2": [
              {
                "type": "string",
                "value": "string"
              }
            ]
          }
        }
      ],
      "blurhash": "string",
      "copyright": "string",
      "created_at": "string",
      "custom": [
        0
      ],
      "description": "string",
      "file_type": "string",
      "folder": {
        "id": "string",
        "name": "string",
        "public": true,
        "slug": "string"
      },
      "id": "string",
      "status": "string",
      "title": "string",
      "translations": {
        "alt": [
          {
            "id": "string",
            "locale": "string",
            "value": "string"
          }
        ],
        "description": [
          {
            "id": "string",
            "locale": "string",
            "value": "string"
          }
        ],
        "title": [
          {
            "id": "string",
            "locale": "string",
            "value": "string"
          }
        ],
        "type": [
          {
            "id": "string",
            "locale": "string",
            "value": "string"
          }
        ]
      },
      "type": "string",
      "updated_at": "string",
      "url": "string",
      "variants": [
        {
          "created_at": "string",
          "format": "string",
          "height": 0,
          "id": "string",
          "updated_at": "string",
          "url": "string",
          "width": 0
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "per_page": 0,
    "total_items": 0,
    "total_pages": 0
  },
  "success": true
}