Skip to main content
GET
/
api
/
phone-number
List Phone Numbers
curl --request GET \
  --url https://api.getello.ai/api/phone-number \
  --header 'X-API-Key: <api-key>'
{
  "status": 200,
  "message": "Phone numbers fetched successfully",
  "data": {
    "total": 3,
    "page": 1,
    "size": 10,
    "phone_numbers": [
      {
        "_id": "6901a88b23bc1023d88134fa",
        "number": "+14155552671",
        "status": "active",
        "type": "inbound",
        "created_at": "2025-10-10T09:30:00Z"
      },
      {
        "_id": "6901a88b23bc1023d88134fb",
        "number": "+14155559876",
        "status": "inactive",
        "type": "outbound",
        "created_at": "2025-09-20T11:45:00Z"
      }
    ]
  }
}

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
page
integer

Page number for pagination.

Example:

1

​
size
integer

Number of phone numbers to return per page.

Example:

10

Response

Phone numbers fetched successfully

​
status
integer
Example:

200

​
message
string
Example:

"Phone numbers fetched successfully"

​
data
object
Example:
{
  "total": 3,
  "page": 1,
  "size": 10,
  "phone_numbers": [
    {
      "_id": "6901a88b23bc1023d88134fa",
      "number": "+14155552671",
      "status": "active",
      "type": "inbound",
      "created_at": "2025-10-10T09:30:00Z"
    },
    {
      "_id": "6901a88b23bc1023d88134fb",
      "number": "+14155559876",
      "status": "inactive",
      "type": "outbound",
      "created_at": "2025-09-20T11:45:00Z"
    }
  ]
}