# Caller ID list

`GET /api/v1/callerid`

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).

## Query parameters

| Field | Type | Description |
|---|---|---|
| `v` | string | Version of the list on the phone (list omitted when unchanged). |