> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.partnerpage.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.partnerpage.io/_mcp/server.

# Get all internal filters

GET https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/{directoryId}/internal_filters/

Retrieve a list of filters within a directory

Reference: https://docs.partnerpage.io/api-reference/directory/filters/get-all-internal-filters

## Authentication

- `Authorization` header (required) (prefixed with ` Token   `) — Your API key, sent as `Authorization: Token <your API key>`

## Request

### Path parameters

- `directoryId` (string, required) — ID of the directory containing the filters

## Response

### 200

List of filters in the directory

- `list of FilterSerializerReader`

## Errors

### 404 Not Found Error

- `map from string to any`

## Types

### FilterSerializerReader

All resources should return their href url

- `href` (string, required)
- `id` (string, required)
- `type` (string, required)
- `name` (string, required)
- `slug` (string, required)
- `order` (integer, required)
- `parentFilterId` (string, required)
- `parentFilterSlug` (string, required)
- `filterOptions` (string, required)
- `multipleSelectFromDashboard` (boolean, required)
- `multipleSelectFromDirectory` (boolean, required)
- `userAssignable` (boolean, required)
- `displayInDirectory` (boolean, required)
- `displayInInternalDirectory` (boolean, required)
- `displayInEntryProfile` (boolean, required)
- `displayInInternalEntryProfile` (boolean, required)
- `displayInEntryProfileMainArea` (boolean, required)
- `required` (boolean, required)
- `overrides` (FilterOverrides, required, nullable) — Visibility rule of the filter, or null when it has none.
- `assignmentDescription` (string, optional, nullable)
- `multipleLimit` (integer, optional, nullable)
- `isLocation` (boolean, optional, default: false) — Whether this is one of the Country, Region and City filters, which visitors pick from as one Location filter.

### FilterOverrides

A filter's visibility rule, in the same shape as a form field's overrides: when the conditions are met the filter takes the hidden value, otherwise the opposite one.

- `attributes` (list of FilterOverrideAttribute, required)
- `conditions` (list of FilterOverrideCondition, required)
- `conditionCombinator` (enum, optional, default: and) — * `and` - and * `or` - or
  - Allowed values: `and`, `or`

### FilterOverrideAttribute

- `attribute` (string, required)
- `value` (boolean, required)

### FilterOverrideCondition

- `key` (string, required) — Id of the filter the condition reads.
- `operator` (enum, required) — * `equals` - equals * `not_equals` - not_equals
  - Allowed values: `equals`, `not_equals`
- `value` (string, required) — Id of an option of that filter.

## Examples

**Response**

```json
[
  {
    "0": {
      "assignmentDescription": "Assignment description",
      "filterOptions": [
        {
          "href": "/api/directory/private/v1alpha/directories/969d9b77-c063-4101-b534-63071317ddbd/filters/006059d7-4d1e-4ace-b816-32fa9a9659ac/options/64f0fab6-32a4-4205-991b-d4eb87e82da2/",
          "id": "64f0fab6-32a4-4205-991b-d4eb87e82da2",
          "image": "https://image.domain.com/partner.png",
          "imageUrl": "https://image.domain.com/partner.png",
          "name": "First Option",
          "order": 0,
          "slug": "first-option"
        }
      ],
      "genericDirectory": "969d9b77-c063-4101-b534-63071317ddbd",
      "href": "/api/directory/private/v1alpha/directories/969d9b77-c063-4101-b534-63071317ddbd/filters/006059d7-4d1e-4ace-b816-32fa9a9659ac/",
      "id": "006059d7-4d1e-4ace-b816-32fa9a9659ac",
      "multipleLimit": null,
      "multipleSelectFromDashboard": false,
      "multipleSelectFromDirectory": false,
      "name": "Filter 1",
      "order": 0,
      "required": false,
      "slug": "filter-1",
      "type": "user",
      "userEnabled": true
    },
    "1": {
      "assignmentDescription": null,
      "displayInDirectory": true,
      "displayInInternalDirectory": false,
      "filterOptions": [
        {
          "href": "/api/directory/private/v1alpha/directories/969d9b77-c063-4101-b534-63071317ddbd/filters/032069d1-4a4e-7ace-b51-32fa9a9114dz/options/858e16bd-becd-4ccf-a07e-ef3917844bd9/",
          "id": "858e16bd-becd-4ccf-a07e-ef3917844bd9",
          "image": "https://image.domain.com/partner.png",
          "imageUrl": "https://image.domain.com/partner.png",
          "name": "Second Option",
          "order": 1,
          "slug": "second-option"
        }
      ],
      "genericDirectory": "969d9b77-c063-4101-b534-63071317ddbd",
      "href": "/api/directory/private/v1alpha/directories/969d9b77-c063-4101-b534-63071317ddbd/filters/032069d1-4a4e-7ace-b51-32fa9a9114dz/",
      "id": "032069d1-4a4e-7ace-b51-32fa9a9114dz",
      "multipleLimit": null,
      "multipleSelectFromDashboard": false,
      "multipleSelectFromDirectory": false,
      "name": "Filter 2",
      "order": 1,
      "required": false,
      "slug": "filter-1",
      "type": "user",
      "userEnabled": true
    },
    "href": "string",
    "id": "string",
    "type": "string",
    "name": "string",
    "slug": "string",
    "order": 1,
    "parentFilterId": "string",
    "parentFilterSlug": "string",
    "filterOptions": "string",
    "multipleSelectFromDashboard": true,
    "multipleSelectFromDirectory": true,
    "userAssignable": true,
    "displayInDirectory": true,
    "displayInInternalDirectory": true,
    "displayInEntryProfile": true,
    "displayInInternalEntryProfile": true,
    "displayInEntryProfileMainArea": true,
    "required": true,
    "overrides": {
      "attributes": [
        {
          "attribute": "string",
          "value": true
        }
      ],
      "conditions": [
        {
          "key": "string",
          "operator": "equals",
          "value": "string"
        }
      ]
    }
  }
]
```

**SDK Code**

```python application/json example
import requests

url = "https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/directoryId/internal_filters/"

headers = {"Authorization": "Token  <apiKey>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript application/json example
const url = 'https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/directoryId/internal_filters/';
const options = {method: 'GET', headers: {Authorization: 'Token  <apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```