Users and numbers API
List your organization's team members and phone numbers through the Dialstitch API.
Both endpoints need the users:read scope. Use them to find the user_id and from_number_id values other endpoints take.
List users
GET /usersReturns your organization's members, newest first, with pagination.
{
"data": [
{
"id": 42,
"name": "Sam Lee",
"email": "sam@example.com",
"role": "member",
"joined_at": "2026-09-14T17:30:00.000Z"
}
],
"next_cursor": null
}role is owner, admin or member. See Team, roles and invitations.
List phone numbers
GET /numbers{
"data": [
{
"id": "b8e2f7c4-1d3a-4e5b-8c9d-0a1b2c3d4e5f",
"e164": "+16045550188",
"label": "Main line",
"assignment_type": "user",
"assigned_user_id": 42,
"capabilities": { "voice": true, "sms": true, "mms": true },
"a2p_registered": true,
"created_at": "2026-09-14T17:35:00.000Z"
}
],
"next_cursor": null
}assignment_type is user for a number assigned to one person and team for a shared number. assigned_user_id is the person, for a user number. a2p_registered tells you whether the number can text US numbers.