---
title: "List persisted account-scoped Telegram contacts"
method: GET
path: "/contacts"
---

# List persisted account-scoped Telegram contacts

`GET /contacts`

## Request

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

Requires the REST and CRM feature gates. No live Telegram lookup is performed.

## Query parameters

- `account_id` string
- `cursor` string
- `limit` integer
- `q` string

## Response `200`

Scoped persisted contact page

## Other responses

- `403`: Account is not owned or eligible
- `503`: CRM disabled or scoped schema unavailable

---

[API](https://skmtc.dev/gramclaw/apis/gramclaw-telegram-api.md) · [All operations](https://skmtc.dev/gramclaw/apis/gramclaw-telegram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gramclaw/apis/gramclaw-telegram-api/revisions/7506dc9c905a?raw)