curl "https://app.talkover.ai/api/v1/phone-numbers/release-requests" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": [
{
"id": "request-uuid-1",
"phone_number_id": "phone-uuid-1",
"phone_number": "+15551234567",
"reason": "Number is no longer in use after migration",
"status": "pending",
"requested_at": "2024-01-10T14:30:00Z"
},
{
"id": "request-uuid-2",
"phone_number_id": "phone-uuid-2",
"phone_number": "+15559876543",
"reason": "Replaced by new toll-free number",
"status": "approved",
"requested_at": "2024-01-05T10:00:00Z",
"resolved_at": "2024-01-08T16:20:00Z"
}
]
}
Voice Templates & Phone Numbers
List Release Requests
List pending and historical phone number release requests
GET
/
api
/
v1
/
phone-numbers
/
release-requests
curl "https://app.talkover.ai/api/v1/phone-numbers/release-requests" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": [
{
"id": "request-uuid-1",
"phone_number_id": "phone-uuid-1",
"phone_number": "+15551234567",
"reason": "Number is no longer in use after migration",
"status": "pending",
"requested_at": "2024-01-10T14:30:00Z"
},
{
"id": "request-uuid-2",
"phone_number_id": "phone-uuid-2",
"phone_number": "+15559876543",
"reason": "Replaced by new toll-free number",
"status": "approved",
"requested_at": "2024-01-05T10:00:00Z",
"resolved_at": "2024-01-08T16:20:00Z"
}
]
}
List Release Requests
List release requests submitted for phone numbers in your environment. Release requests are used to return a phone number you no longer need.Endpoint
GET /api/v1/phone-numbers/release-requests
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_hereExamples
curl "https://app.talkover.ai/api/v1/phone-numbers/release-requests" \
-H "Authorization: Bearer talq_your_environment_token_here"
Response
{
"success": true,
"data": [
{
"id": "request-uuid-1",
"phone_number_id": "phone-uuid-1",
"phone_number": "+15551234567",
"reason": "Number is no longer in use after migration",
"status": "pending",
"requested_at": "2024-01-10T14:30:00Z"
},
{
"id": "request-uuid-2",
"phone_number_id": "phone-uuid-2",
"phone_number": "+15559876543",
"reason": "Replaced by new toll-free number",
"status": "approved",
"requested_at": "2024-01-05T10:00:00Z",
"resolved_at": "2024-01-08T16:20:00Z"
}
]
}
Status Values
pending— submitted, awaiting reviewapproved— approved and the number has been (or will be) releasedrejected— request denied (reason returned inrejection_reasonfield)cancelled— user cancelled before resolution
Notes
- To submit a new release request, use Request Phone Release.
- Pending requests can be cancelled with Cancel Release Request.
Was this page helpful?