Phone numbers

The numbers on your account and their routing settings.

List phone numbers

GET /v1/phone-numbers — scope phone-numbers:read

Lists every phone number on your organization, with its settings.

curl https://dashboard.limephone.io/api/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_..."

Get a phone number

GET /v1/phone-numbers/{id} — scope phone-numbers:read

Fetches one phone number by id.

Update a phone number

PATCH /v1/phone-numbers/{id} — scope phone-numbers:write

Field	Type	Notes
friendlyName	string	Display label for the number
callForwarding	string	Number to forward incoming calls to
voicemailEnabled	boolean	Whether unanswered calls go to voicemail

curl -X PATCH https://dashboard.limephone.io/api/v1/phone-numbers/pn_31xk \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "friendlyName": "Support line", "voicemailEnabled": true }'