---
title: "Find contacts by email, phone, or a field and its value"
method: GET
path: "/api/v1/contacts"
---

# Find contacts by email, phone, or a field and its value

`GET /api/v1/contacts`

## Request

- Base URL: `https://hivepublish.com`
- URL: `https://hivepublish.com/api/v1/contacts`
- Auth: HTTP bearer

Runs read_contacts with the same scope, permission and approval rules.

## Query parameters

- `segmentId` string
- `search` string
- `accountId` string
- `email` string
- `phone` string
- `fieldId` string
- `fieldName` string
- `fieldValue` string
- `limit` integer

## Response `200`

Tool result

- ToolResult
  - `data` unknown, required
  - `meta` object, required
    - `tool` string
    - `workspaceId` string, uuid

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid credential
- `403`: Missing workspace scope, role permission, or plan entitlement

---

[API](https://skmtc.dev/hivepublish/apis/hive-developer-api.md) · [All operations](https://skmtc.dev/hivepublish/apis/hive-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hivepublish/apis/hive-developer-api/revisions/b440c763583e?raw)