List phone numbers

GET

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

GET

/api/v1/phone/numbers

curl https://api.talkif.ai/api/v1/phone/numbers \
     -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"
    }
  ]
}

GET /api/v1/phone/numbers

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 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