Workspace

Caller ID list

Company and contact numbers the user can see (international digits, ascending): entries = [number, label, company_id, contact_id] — label Company · Contact (company only for a number shared by several contacts, e.g. a switchboard), contact 0 for a company number. Up to 20,000 numbers (CALLERID_MAX); above the limit your own companies come first, then active customers (truncated). When v equals the last version and nothing changed, same: true is returned without the list. One audit entry per day. Advanced / Enterprise plans only (403 plan); 403 disabled when an admin turned it off in Settings › Security (the app then deletes the list from the phone).

GET/api/v1/callerid

Authorization

Authorizationheaderrequired

Bearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).

Module: CustomersScope: crm.read

Query parameters

vstringoptional

Version of the list on the phone (list omitted when unchanged).

Errors

HTTP	error	Meaning
`403`	`plan`	plan
`403`	`disabled`	disabled

Request

curl https://ornek.solk.app/api/v1/callerid \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/callerid", {
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://ornek.solk.app/api/v1/callerid",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())

Response