---
title: "List and search contacts"
method: GET
path: "/contacts"
tags: ["Contacts"]
---

# List and search contacts

`GET /contacts`

## Request

- Base URL: `https://teleboost.app/api/v1`
- URL: `https://teleboost.app/api/v1/contacts`
- Auth: none declared

## Query parameters

- `search` string, nullable: Search username / first name / last name
- `engagement` string, nullable: not_contacted | contacted | replied
- `engagement_tier` string, nullable: hot | warm | cold | unresponsive
- `group_name` string, nullable: Source group filter
- `list_id` string, nullable
- `has_replied` boolean, nullable
- `limit` integer
- `cursor` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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