> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enad.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Folder Facets

> 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.



## OpenAPI

````yaml /swagger/dam-api.json get /api/v1/{app_id}/folders/{id}/facets
openapi: 3.0.0
info:
  contact:
    email: support@enad.io
    name: API Support
  description: This is the swagger for Enads Digital Assets Management service
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: http://enad.io/terms
  title: Digital Assets Management
  version: '1.0'
servers:
  - url: //dam.enad.io
security: []
paths:
  /api/v1/{app_id}/folders/{id}/facets:
    get:
      tags:
        - Folders
      summary: Get Folder Facets
      description: >-
        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.
      parameters:
        - description: App ID
          in: path
          name: app_id
          required: true
          schema:
            type: string
        - description: Folder ID
          in: path
          name: id
          required: true
          schema:
            type: string
        - description: 'Filter by type: image, video, file, all (default: all)'
          in: query
          name: type
          schema:
            type: string
        - description: >-
            Filter by attribute(s). Same syntax as Get Folder Contents: repeat
            the query parameter once per filter, each in the form
            template_key/attribute_key. Per-template exclusion applies when
            computing counts (filters on the same template_key are ignored).
          in: query
          name: attributes
          explode: true
          schema:
            items:
              type: string
            type: array
      responses:
        '200':
          description: Folder facets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OkResponseFolderFacets'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Folder not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    OkResponseFolderFacets:
      properties:
        data:
          items:
            $ref: '#/components/schemas/FolderFacetResponse'
          type: array
        success:
          type: boolean
      type: object
    ErrorResponse:
      properties:
        details:
          items:
            type: string
          type: array
        error:
          type: string
      type: object
    FolderFacetResponse:
      properties:
        active:
          type: boolean
        count:
          type: integer
        description:
          type: string
        filter_key:
          type: string
        key:
          type: string
        name:
          type: string
        template_key:
          type: string
        values:
          items:
            $ref: '#/components/schemas/FolderFacetValueResponse'
          type: array
      type: object
    FolderFacetValueResponse:
      properties:
        count:
          type: integer
        type:
          type: string
        value:
          type: string
      type: object

````