For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDashboard
DocsAPI ReferenceWebhooksMethodsUI ComponentsMCP ServerChangelog
  • API Reference
      • POSTList Contacts
      • GETGet Contact
      • POSTCreate New Contact
      • PUTUpdate Contact
LogoLogo
SupportDashboard
API ReferenceContacts

List Contacts

POST
https://api.pinnacle.sh/contacts/list
POST
/contacts/list
1import { PinnacleClient } from "rcs-js";
2
3async function main() {
4 const client = new PinnacleClient({
5 apiKey: "YOUR_API_KEY_HERE",
6 });
7 await client.contacts.list({});
8}
9main();
1{
2 "data": [
3 {
4 "id": "co_abc123",
5 "phoneNumber": "+12125551234",
6 "email": "john@example.com",
7 "name": "John Doe",
8 "tags": [
9 "vip",
10 "beta"
11 ]
12 },
13 {
14 "id": "co_def456",
15 "phoneNumber": "+14155556789",
16 "name": "Jane Smith"
17 }
18 ],
19 "hasMore": true,
20 "count": 48
21}
List all contacts with optional filtering and pagination. Results are sorted by creation date, newest first.
Was this page helpful?
Previous

Get Contact

Next
Built with

Authentication

PINNACLE-API-KEYstring
API Key authentication via header

Request

This endpoint expects an object.
pageIndexintegerOptional>=0Defaults to 0
pageSizeintegerOptional1-100Defaults to 20
phoneNumberstringOptional

Filter contacts by phone number (E.164 format).

namestringOptional

Filter contacts by name (partial match).

tagslist of stringsOptional
Filter contacts by tags.
isArchivedbooleanOptional
Filter contacts by archived status.

Response

Returns paginated list of contacts.
datalist of objects
hasMoreboolean
countinteger

Errors

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error