---
title: "Search contacts"
method: GET
path: "/contacts"
tags: ["Contacts"]
---

# Search contacts

`GET /contacts`

## Request

- Base URL: `https://rcs-templates-api-dot-msg2ai-server.ue.r.appspot.com/api/agent`
- URL: `https://rcs-templates-api-dot-msg2ai-server.ue.r.appspot.com/api/agent/contacts`
- Auth: HTTP bearer

Search the org's contact records — one person per number, across every audience. Returns consent, opt-out, the number verdict, marketing status, merge fields and tags.

## Query parameters

- `q` string
- `status` 'SUBSCRIBED' | 'UNSUBSCRIBED' | 'UNDELIVERABLE' | 'UNKNOWN'
- `tag` string
- `audienceId` string
- `page` number
- `pageSize` number

## Response `200`

Success.

- object

## Other responses

- `400`: Arguments failed validation.
- `401`: Missing or invalid agent key.
- `403`: Key does not hold the contacts:read scope.
- `429`: Rate limited.

---

[API](https://skmtc.dev/rcs-campaigns/apis/rcs-campaigns-agent-gateway.md) · [All operations](https://skmtc.dev/rcs-campaigns/apis/rcs-campaigns-agent-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/rcs-campaigns/apis/rcs-campaigns-agent-gateway/revisions/acdbf292d9d6?raw)