---
title: "Retrieve smartfilters"
url: "https://earlyaccess.developers.bynder.com/apis/smartfilters-api-1/versions/8a39e90d-a32e-40a5-9c34-f33eff838f14/paths/api-v4-smartfilters/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/smartfilters-api-1/versions/8a39e90d-a32e-40a5-9c34-f33eff838f14.md

# Retrieve smartfilters

`GET` `/api/v4/smartfilters`

Retrieve a list of smartfilters.

## Responses

- `200` - A list of smartfilters.

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Smartfilters API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/v4/smartfilters:
    get:
      description: Retrieve a list of smartfilters.
      responses:
        "200":
          content:
            application/json:
              examples:
                example1:
                  value:
                    - icon: fa fa-group
                      id: 00000000-0000-0000-0000000000000000
                      labels:
                        de_DE: Destinations
                        en_US: Destinations
                        fr_FR: Destinations
                        nl_NL: Destinations
                      metaproperties:
                        - 00000000-0000-0000-0000000000000000
                        - 00000000-0000-0000-0000000000000000
                      zindex: 0
                    - icon: fa fa-tag
                      id: 00000000-0000-0000-0000000000000000
                      labels:
                        de_DE: Holiday
                        en_US: Holiday
                        fr_FR: Holiday
                        nl_NL: Holiday
                      metaproperties:
                        - 00000000-0000-0000-0000000000000000
                        - 00000000-0000-0000-0000000000000000
                        - 00000000-0000-0000-0000000000000000
                      zindex: 1
              schema:
                items:
                  properties:
                    icon:
                      example: fa fa-group
                      type: string
                    id:
                      example: 00000000-0000-0000-0000000000000000
                      type: string
                    labels:
                      properties:
                        de_DE:
                          example: Destinations
                          type: string
                        en_US:
                          example: Destinations
                          type: string
                        fr_FR:
                          example: Destinations
                          type: string
                        nl_NL:
                          example: Destinations
                          type: string
                      type: object
                    metaproperties:
                      items:
                        example: 00000000-0000-0000-0000000000000000
                        type: string
                      type: array
                    zindex:
                      example: 0
                      type: integer
                  type: object
                type: array
          description: A list of smartfilters.
      summary: Retrieve smartfilters
      tags:
        - Smartfilters
security:
  - OAuth2: []
  - permanentToken: []
components:
  securitySchemes:
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes: {}
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes: {}
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```