v1Resources/Data/getList folders

List folders

Returns every folder in this agency, with its item count and source mix.

get/api/v1/folders

media:read

Query parameters

scopeTypestring (account | client | location | brand)optional

Narrow to folders scoped to this type: account, client, location, or brand.

scopeIdstringoptional

Narrow to folders scoped to this id. Requires scopeType.

Response

dataobjectoptional

itemsarray of objectoptional

idstringoptional

Unique identifier for the folder.

namestringoptional

The folder's name.

descriptionstringoptional

The folder's description, or null.

itemCountnumberoptional

Number of assets currently in the folder.

sourceMixarray of stringoptional

The distinct asset sources present in the folder.

scopeobjectoptional

The folder's scope, or null when it's agency-wide.

typestring (account | client | location | brand)optional

idstringoptional

sharingobjectoptional

The folder's public-sharing state.

accessstring (restricted | link)optional

urlstringoptional

createdAtstringoptional

When the folder was created, as an ISO 8601 timestamp.

Errors

401Missing, invalid, expired, or revoked API key.

403The key lacks the required scope, or isn't authorized for this client/location.

429Too many requests. Retry after the number of seconds in the Retry-After header.

get/api/v1/folders

Your API key

scopeType

scopeId

{
  "data": {
    "items": [
      {
        "id": "folder_1",
        "name": "Storefront Photos",
        "description": null,
        "itemCount": 12,
        "sourceMix": [
          "upload",
          "gmb"
        ],
        "scope": {
          "type": "client",
          "id": "cli_123"
        },
        "sharing": {
          "access": "restricted",
          "url": null
        },
        "createdAt": "2026-01-15T10:00:00.000Z"
      }
    ]
  }
}