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

# List contact views

> Saved contact filters. A view is the audience of a campaign.

Every plan can use this endpoint. A view is the same saved filter the Contacts page uses, so it shows up in the dashboard too.

The list is not paged. It returns `{ items }` with up to 1,000 views, oldest first. `creatorName` is the name of the person who made the view, or `null` when that person is gone.

## Query Parameters

**workspaceId** `string` *required*

The workspace. Required.

```bash cURL theme={null}
curl -X GET "https://api.nedzo.ai/v1/contacts/views?workspaceId=789e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json Response theme={null}
{
  "items": [
    {
      "id": "4d3c2b1a-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "workspaceId": "789e4567-e89b-12d3-a456-426614174000",
      "name": "VIP leads",
      "filters": [{ "id": "flt_1", "fieldKey": "tags", "operator": "all_of", "value": "vip" }],
      "sort": { "key": "created_at", "direction": "desc" },
      "creatorName": "Jane Smith",
      "createdAt": "2026-10-11T12:00:00Z",
      "updatedAt": "2026-10-11T12:00:00Z"
    }
  ]
}
```

`sort` is `null` when the view uses the default order. For the filter fields, see [Filters](https://docs.nedzo.ai/api-reference/contacts/views/create.md#filters).

## Errors

| Status | When |
| - | - |
| `400` | `workspaceId` is not a UUID, or `workspaceId` is missing. |
| `404` | The workspace is not in this key's scope. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.