Organizations

List the organization phone numbers

GET
/api/organizations/{organizationId}/phone-numbers

Every PhoneNumber resource in the organization, newest first, joined with the linked user's or group's identity, plus a coverage summary (how many users have a directly linked number, which providers have a usable org default line, how many unlinked numbers auto-assignment could hand out). Each row carries its access grants; the field is omitted for a number that predates grants. Admin or SuperAdmin; an Admin may only list their own organization.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

organizationId*string

The organization that owns the phone numbers.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/organizations/string/phone-numbers"
{  "assignments": [    {      "phoneNumberId": "6650a1b2c3d4e5f6a7b8c9d1",      "provider": "twilio",      "phoneNumber": "+14165550102",      "label": "Leasing team line",      "capabilities": [        "sms",        "voice"      ],      "status": "active",      "isOrgDefault": false,      "linkedType": "group",      "linkedUserId": null,      "linkedGroupId": "6650a1b2c3d4e5f6a7b8c9d2",      "groupName": "Leasing",      "grants": [        {          "principalType": "group",          "principalId": "6650a1b2c3d4e5f6a7b8c9d2",          "key": "group:6650a1b2c3d4e5f6a7b8c9d2",          "verbs": [            "send",            "read"          ],          "grantedBy": {            "type": "user",            "userId": "6650a1b2c3d4e5f6a7b8c9d0"          },          "grantedAt": "2026-09-30T12:00:00.000Z"        }      ],      "userId": null,      "userName": "",      "userEmail": ""    }  ],  "coverage": {    "orgUserCount": 0,    "usersWithNumberCount": 0,    "usersWithoutNumberCount": 0,    "orgDefaultProviders": [      "string"    ],    "hasOrgDefault": true,    "claimableCount": 0,    "activeSmsProvider": "string"  }}