---
search:
  tags:
    - Folders
    - GET
seo:
  description: >-
    Returns every attribute available on media within a… Reference for the GET
    /api/v1/{app_id}/folders/{id}/facets endpoint in the Digital Assets
    Management API.
sidebar:
  label: Get Folder Facets
  badge: GET
title: Get Folder Facets
type: openapi-operation
---
Returns every attribute available on media within a folder, with distinct-item counts. The returned filter_key on each facet can be passed back to Get Folder Contents as part of `attributes=` to filter the listing. Per-template exclusion: when computing counts for a facet, filters on that same template_key are ignored; filters on other templates still apply. This matches the OR-within-template / AND-across-template filter semantics so users can multi-select within a template and still see realistic counts for the other values.

`GET /api/v1/{app_id}/folders/{id}/facets`

**Responses**

- `200` — Folder facets
- `400` — Invalid request
- `404` — Folder not found
- `500` — Internal server error

Response example, 200:

```json
{
  "data": [
    {
      "active": true,
      "count": 0,
      "description": "string",
      "filter_key": "string",
      "key": "string",
      "name": "string",
      "template_key": "string",
      "values": [
        {
          "count": 0,
          "type": "string",
          "value": "string"
        }
      ]
    }
  ],
  "success": true
}
```