---
title: "List verified caller IDs"
method: GET
path: "/api/relay/rest/verified_caller_ids"
tags: ["Verified Caller ID"]
---

# List verified caller IDs

`GET /api/relay/rest/verified_caller_ids`

Lists external phone numbers your SignalWire project has submitted for outbound caller-ID verification. Verified Caller IDs let calls present a number the project does not own; project-owned numbers are managed through [Phone Numbers](/docs/apis/rest/phone-numbers/list-phone-numbers) and do not need this verification flow. Results are sorted by creation date, most recent first.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Query parameters

- `filter_name` string
- `filter_number` string

## Response `200`

The request has succeeded.

- VerifiedCallerIDListResponse — Response containing a list of verified caller IDs.
  - `links` PaginationLinks — Pagination links for list responses.
    - `self` string, required — Link to the current page.
    - `first` string, required — Link to the first page.
    - `next` string — Link to the next page. Only present when there are more results.
    - `prev` string — Link to the previous page. Only present when not on the first page.
  - `data` VerifiedCallerID[] — List of verified caller IDs.
    - `type` string — The type of the returned object, this should be verified_caller_id.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `number` string, required — String representing the phone number for the caller ID. This must be a valid, routeable phone number in E.164 format.
    - `name` string — String representing the name portion of the caller ID. If not provided, the default will be the formatted number that has been provided.
    - `extension` string — String representing the extension of the phone number for the caller ID. This is only used when placing the verification call.
    - `verified` boolean, required — A boolean representing whether the number has been verified or not.
    - `verified_at` string, date-time — Nullable DateTime field representing the date and time that the number was verified. If the number has not been verified, it will be null.
    - `status` 'Verified' | 'Awaiting Verification' — The verification status for the caller ID.

## Other responses

- `401` — Access is unauthorized.
- `500` — An internal server error occurred.

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/revisions/40cdd103d4fb/schema)