Retrieve a Verified Caller ID
GET/verified_caller_ids/:id
To retrieve an existing Verified Caller ID, you send a GET
request
to the Verified Caller ID resource. Use the unique ID that was
returned from your previous request to identify the specific Verified
Caller ID.
Permissions
The API token must include the following scopes: Voice.
Request
Path Parameters
Unique unique identifier of the Verified Caller ID on SignalWire
Responses
- 200
OK
- application/json
- Schema
- Example (from schema)
Schema
The type
of the returned object, this should be verified_caller_id
.
The unique identifier of the Verified Caller ID on SignalWire.
String representing the name portion of the caller ID. If not provided, the default will be the formatted number that has been provided.
String representing the extension of the phone number for the caller ID. This is only used when placing the verification call.
String representing the phone number for the caller ID. This must be a valid, routeable phone number in E.164 format that is able to receive a voice phone call for verification.
A boolean representing whether the number has been verified or not.
Nullable DateTime fields representing the date and time that the number was verified. If the number has not been verified, it will be null
.
String representing the verification status for the caller ID. Current values are "Verified" and "Awaiting Verification"
{
"type": "verified_caller_id",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "C-3P0",
"extension": "1234",
"number": "+15551234567",
"verified": false,
"verified_at": null,
"status": "Awaiting Verification"
}