/
SU
surgeapi
Search skmtc…
⌘K
Docs
Sign in
Docs
History
Schema
Generate
Filter operations
Accounts
6
Audiences
3
Blasts
1
Campaigns
5
Contacts
4
Messages
4
Phone numbers
6
get
/accounts/{account_id}/available_phone_numbers
List available phone numbers
get
/accounts/{account_id}/phone_numbers
List phone numbers
post
/accounts/{account_id}/phone_numbers
Purchase a phone number
get
/phone_numbers/{id}
Retrieve a phone number
delete
/phone_numbers/{id}
Release a phone number
patch
/phone_numbers/{id}
Update a phone number
Recordings
4
Tokens
1
Toll-Free Campaigns
4
Users
5
Verifications
2
Webhooks
post
callEnded
post
callFlowEventCreated
post
campaignApproved
post
campaignRejected
post
campaignSubmitted
post
campaignWarning
post
contactOptedIn
post
contactOptedOut
post
conversationCreated
post
linkFollowed
post
messageDelivered
post
messageFailed
post
messageReceived
post
messageSent
post
phoneNumberAttachedToCampaign
post
phoneNumberImported
post
recordingCompleted
post
voicemailReceived
Phone numbers
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to Retrieve a phone number
get
/phone_numbers/{id}
Oct 16, 2026
912b2a3101fc
Revision changes
info
added the required property
metadata
to the response with the
200
status
Jul 14, 2026
9cef51e0865f
Revision changes
info
endpoint added