List owned phone numbers

GET

https://api.talkif.ai/api/v1/phone/numbers/owned

GET

/api/v1/phone/numbers/owned

curl https://api.talkif.ai/api/v1/phone/numbers/owned \
     -H "Authorization: Bearer <token>"

{
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 142
  },
  "phoneNumbers": [
    {
      "accountId": "550e8400-e29b-41d4-a716-446655440000",
      "billingStatus": "active",
      "canInitiateCalls": true,
      "capabilities": [
        "SMS"
      ],
      "channelType": "pstn",
      "createdAt": "2026-01-15T10:30:00Z",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "isVerified": true,
      "monthlyCost": "1.00",
      "phoneNumber": "+15551234567",
      "providerId": "550e8400-e29b-41d4-a716-446655440000",
      "providerPhoneId": "PN1234567890abcdef1234567890abcdef",
      "purchasedAt": "2026-01-15T10:30:00Z",
      "recordingOverride": "do-not-record",
      "status": "ACTIVE",
      "twilioEdge": "ashburn",
      "twilioRegion": "us1",
      "updatedAt": "2026-01-15T10:30:00Z",
      "connectedAt": "2024-01-15T09:30:00Z",
      "connectedFlow": null,
      "friendlyName": "string",
      "nextBillingDate": "2024-01-15T09:30:00Z",
      "releasedAt": "2024-01-15T09:30:00Z",
      "verifiedAt": "2024-01-15T09:30:00Z"
    }
  ]
}

Returns the account’s active and pending phone numbers (released numbers are excluded), with their connected flows.

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Query parameters

limitlongOptional

Max items to return

offsetlongOptionalDefaults to 0

Items to skip

Response

List of owned phone numbers

metaobject

Pagination metadata

phoneNumberslist of objects

Items on this page

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error