List contact views

GET

contacts

views

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

{
  "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"
    }
  ]
}

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

string

required

The workspace. Required.

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

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

Errors

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

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

{
  "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"
    }
  ]
}

API Reference

Workspaces

Agents

Phone Numbers

Contacts

Knowledge

Templates

Campaigns

Workflows

Conversations

List contact views

Query Parameters

Errors