---
title: "Get caller ID settings"
method: GET
path: "/caller-id"
tags: ["numbers"]
---

# Get caller ID settings

`GET /caller-id`

## Request

- Base URL: `https://api.voixcall.com/v1`
- URL: `https://api.voixcall.com/v1/caller-id`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://api.voixcall.com/oauth/authorize`, token URL `https://api.voixcall.com/oauth/token`, scopes: `numbers:read`)
  - HTTP bearer

The caller ID currently presented on outbound calls, every option the account may select, and the account's verified personal numbers. Personal context only. Test keys see no numbers. Requires numbers:read.

## Response `200`

OK

- CallerID
  - `current` string, nullable, required: The selected caller ID, E.164, when it is usable on the personal account; null when the platform default is used.
  - `livemode` boolean, required
  - `object` 'caller_id', required: Always "caller_id".
  - `options` CallerIDOption[], nullable, required: Every number the account may present as caller ID.
    - `country_code` string, nullable, required: Virtual numbers only.
    - `display_name` string, required
    - `is_active` boolean, required: Whether it can be used right now.
    - `phone_number` string, required: E.164.
    - `status` string, required: verified, pending_validation, validation_check_failed, or the number's status for virtual numbers.
    - `type` 'verified' | 'virtual', required
  - `verified_numbers` VerifiedNumber[], nullable, required: The account's verified personal numbers.
    - `phone_number` string, required: E.164.
    - `verified_at` string, date-time, nullable, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/voixcall/apis/voixcall-api.md) · [All operations](https://skmtc.dev/voixcall/apis/voixcall-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voixcall/apis/voixcall-api/revisions/9aac329ff0f5?raw)