Skip to main content
GET
/
v1
/
phone-numbers
/
{phoneNumberId}
Get a phone number by ID
curl --request GET \
  --url https://dev-public-api.openphone.dev/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": "jsmith@example.com",
        "firstName": "John",
        "lastName": "Doe",
        "id": "<string>",
        "groupId": "<string>"
      }
    ],
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "restrictions": {
      "calling": {},
      "messaging": {}
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://openphone-dev.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Path Parameters

​
phoneNumberId
string
required

Unique identifier of the phone number.

Pattern: ^PN(.*)$
Example:

"PNlja6rrtI"

Response

Success

​
data
object
required