> 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 a filter

GET https://v1.api.partnerpage.io/api/directory/private/v1alpha/filters/{filterId}/

Retrieve details of a single filter within a directory

Reference: https://docs.partnerpage.io/api-reference/directory/filters/get-a-filter

## Authentication

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

## Request

### Path parameters

- `filterId` (string, required) — ID of the filter to retrieve

## Response

### 200

Details of the filter

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

## Errors

### 404 Not Found Error

- `map from string to any`

## Types

### 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
{
  "href": "/api/directory/private/v1alpha/directories/969d9b77-c063-4101-b534-63071317ddbd/filters/006059d7-4d1e-4ace-b816-32fa9a9659ac/",
  "id": "006059d7-4d1e-4ace-b816-32fa9a9659ac",
  "type": "user",
  "name": "Filter 1",
  "slug": "filter-1",
  "order": 0,
  "parentFilterId": "string",
  "parentFilterSlug": "string",
  "filterOptions": "string",
  "multipleSelectFromDashboard": false,
  "multipleSelectFromDirectory": false,
  "userAssignable": true,
  "displayInDirectory": true,
  "displayInInternalDirectory": false,
  "displayInEntryProfile": true,
  "displayInInternalEntryProfile": true,
  "displayInEntryProfileMainArea": true,
  "required": false,
  "overrides": {
    "attributes": [
      {
        "attribute": "string",
        "value": true
      }
    ],
    "conditions": [
      {
        "key": "string",
        "operator": "equals",
        "value": "string"
      }
    ]
  },
  "assignmentDescription": "Assignment description",
  "multipleLimit": null,
  "genericDirectory": "969d9b77-c063-4101-b534-63071317ddbd",
  "userEnabled": true
}
```

**SDK Code**

```python application/json example
import requests

url = "https://v1.api.partnerpage.io/api/directory/private/v1alpha/filters/filterId/"

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/filters/filterId/';
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);
}
```