# List phonebook contacts alphabetically (CTI + centralized)

**GET /phonebook/getall/{term}**

Legacy-compatible alphabetical listing across the authenticated user's
CTI phonebook and the centralized phonebook. Requires the `phonebook`
capability. Same `{count, rows, last_sync_at}` envelope and same query
parameters as `/phonebook/search`.

Ordering (issue #7124): with no `sort` the computed display key
(`sort_name`) is used, matching the pre-existing default.



## Servers
- Local development server: http://localhost:8080 (Local development server)
- Production server: https://middleware.example.com/api (Production server)


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **term** (string)
  Optional free-text filter.


### Query parameters

- **view** (string)

- **sort** (string)
  Sort key (issue #7124). `surname` aliases `lastname`; `name` aliases `displayname`. Any other/absent value keeps the default ordering.

- **visibility** (string)
  Visibility filter. Alias: `sharing`.

- **sharing** (string)
  Alias of `visibility`.

- **limit** (integer)

- **offset** (integer)



## Responses
### 200
Alphabetical listing

#### Body: application/json (object)
- **count** (integer)
  Total number of matching rows (ignores pagination).

- **rows** (array[object])
  A phonebook contact from either the per-user CTI phonebook (source "cti") or the centralized phonebook (source "centralized"). Fields firstname..otheremail were added by issue #7124 and exist only on CTI contacts; centralized contacts always return them empty.

- **last_sync_at** (string(date-time) | null)
  Last centralized-phonebook sync timestamp (RFC3339), or null.


### 400
Invalid pagination parameters

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** ()

- **error** (string)


### 401
Unauthorized

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** ()

- **error** (string)



[Powered by Bump.sh](https://bump.sh)