Skip to main content
GET
/
v1
/
phone-numbers
/
{phoneNumberId}
Get a phone number by ID
curl --request GET \
  --url https://api.openphone.com/v1/phone-numbers/{phoneNumberId} \
  --header 'Authorization: <api-key>'
{
  "data": {
    "id": "<string>",
    "groupId": "<string>",
    "portRequestId": "123abc",
    "formattedNumber": "+15555555555",
    "forward": "+15555555555",
    "name": "<string>",
    "number": "<string>",
    "portingStatus": "completed",
    "symbol": "🏡",
    "users": [
      {
        "email": "[email protected]",
        "firstName": "John",
        "lastName": "Doe",
        "id": "<string>",
        "role": "owner",
        "groupId": "<string>"
      }
    ],
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "restrictions": {
      "calling": {
        "CA": "restricted",
        "Intl": "restricted",
        "US": "restricted"
      },
      "messaging": {
        "CA": "restricted",
        "Intl": "restricted",
        "US": "restricted"
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
phoneNumberId
string
required

Unique identifier of the phone number.

Example:

"PNlja6rrtI"

Response

Success

​
data
object
required