Skip to main content
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

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here

​
Examples

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 review
  • approved — approved and the number has been (or will be) released
  • rejected — request denied (reason returned in rejection_reason field)
  • cancelled — user cancelled before resolution

​
Notes