> ## 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 contacts

> Retrieve all contacts in a workspace via the Nedzo REST API. Filter by workspace ID with account keys, or list contacts scoped to a workspace key.

<Tip>
  `workspaceId` is required for **account-scoped** API keys and inferred from the key for **workspace-scoped** keys. See [Workspace ID and Request Scope](/authentication#workspace-id-and-request-scope).
</Tip>

<ParamField query="workspaceId" type="string">
  Workspace UUID (required for account API keys, optional for workspace API keys)
</ParamField>

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

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "workspaceId": "789e4567-e89b-12d3-a456-426614174000",
      "firstName": "John",
      "lastName": "Doe",
      "email": "john@example.com",
      "phone": "+14155551234",
      "timezone": "America/Los_Angeles",
      "tags": ["newsletter", "vip"],
      "customFields": {
        "Lead Source": "Website",
        "MRR": "250"
      },
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ]
  ```
</ResponseExample>