Skip to main content
GET
/
v1
/
phone-numbers
List Phone Numbers
curl --request GET \
  --url https://api.openmic.ai/v1/phone-numbers \
  --header 'Authorization: Bearer <token>'
{
  "phone_numbers": [
    {
      "phone_number_id": "ybhb8wzi487w02m2bc7dh0ev",
      "phone_number": "+15551112222",
      "name": "Main Support Line",
      "inbound_agent_id": "bvrg8wzi487w02m2bc7dh0ev",
      "outbound_agent_id": "bvrg8wzi487w02m2bc7dh0ev",
      "created_at": "2023-01-01T12:00:00Z",
      "updated_at": "2023-01-02T15:30:00Z"
    }
  ],
  "pagination": {
    "limit": 1,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Include your API key in the Authorization header as: Authorization: Bearer <your-api-key>

Query Parameters

​
limit
integer

Maximum number of phone numbers to return (1-100)

Required range: 1 <= x <= 100
​
offset
integer

Number of phone numbers to skip

Required range: x >= 0
​
phone_number
string

Filter by phone number (partial match)

​
name
string

Filter by name (partial match)

Response

List of phone numbers retrieved successfully

​
phone_numbers
object[]
required
​
pagination
object
required