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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

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

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