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

# List Contacts

> List contacts in a workspace

## Request

```bash theme={null}
curl "https://app.orova.ai/api/contacts?workspaceId=WORKSPACE_ID&page=1&limit=20" \
  -H "x-api-key: YOUR_API_KEY"
```

## Query parameters

| Parameter     | Type   | Default | Description             |
| ------------- | ------ | ------- | ----------------------- |
| `workspaceId` | string | —       | Filter by workspace     |
| `page`        | number | `1`     | Page number             |
| `limit`       | number | `10`    | Items per page          |
| `search`      | string | —       | Search by name or phone |

## Response

```json theme={null}
{
  "data": [
    {
      "_id": "contact_id",
      "contactName": "John Doe",
      "phoneNumber": "+1234567890",
      "region": "US East",
      "workspaceId": "WORKSPACE_ID"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10
}
```