---
title: "Find contacts by number or name across every list (bounded page)"
method: GET
path: "/v1/contacts"
---

# Find contacts by number or name across every list (bounded page)

`GET /v1/contacts`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/contacts`
- Auth: none declared

A search that starts with + matches the start of the number; other digits match anywhere in the number; text matches anywhere in the name, first name or external reference, ignoring case. Results come in a stable order (number, list, contact) with has_more. An empty search returns no results.

## Query parameters

- `search` string, required
- `project_id` string
- `limit` integer
- `offset` integer

## Response `200`

Matching contacts, each with its list, and pagination

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/95b8c66f99aa?raw)