Skip to main content
GET
/
v1
/
organizations
/
{org_id}
/
users
List Users
curl --request GET \
  --url https://api.example.com/v1/organizations/{org_id}/users \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "count": 123,
  "users": [
    {
      "unique_id": "<string>",
      "id": "<string>",
      "name": "<string>",
      "email": "<string>",
      "permission": "<string>",
      "organization_id": "<string>",
      "tenant_id": "<string>",
      "status": "<string>",
      "is_teli_admin": true,
      "mobile_app_enabled": true,
      "phone": "<string>",
      "profile_image": "<string>",
      "total_agents": 123,
      "total_campaigns": 123,
      "total_leads": 123,
      "total_sms_outbound": 123,
      "total_sms_inbound": 123,
      "total_mms_outbound": 123,
      "total_mms_inbound": 123,
      "total_voice_seconds": 123,
      "created_at": {},
      "modified_at": {},
      "updated_at": {}
    }
  ],
  "powered_by": "<string>"
}

​
Description

Returns all users belonging to an organization with their permissions, usage statistics, and account details.

​
Authentication

​
X-API-Key
string
required
Your Teli API key

​
Path Parameters

​
org_id
string
required
Organization unique_id

​
Response Fields

​
success
boolean
Whether the request was successful
​
count
integer
Total number of users
​
users
array
Array of user objects
​
powered_by
string
Always returns “Teli”

​
Example Request

cURL
curl -X GET "https://api.teli.ai/v1/organizations/1762896364768x389173798861431550/users" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

200
{
  "success": true,
  "count": 2,
  "users": [
    {
      "unique_id": "1763661807373x532913854895880007",
      "id": "e4de5844-5b7b-45bb-8717-2c6f1f3f52ca",
      "name": "John Smith",
      "email": "pnb@msu.edu",
      "permission": "user",
      "organization_id": "4d051118-c116-4923-8ff4-1a9761115fec",
      "tenant_id": "your_tenant",
      "status": "active",
      "is_teli_admin": false,
      "mobile_app_enabled": false,
      "phone": null,
      "profile_image": null,
      "total_agents": 0,
      "total_campaigns": 0,
      "total_leads": 0,
      "total_sms_outbound": 0,
      "total_sms_inbound": 0,
      "total_mms_outbound": 0,
      "total_mms_inbound": 0,
      "total_voice_seconds": 0,
      "created_at": "2025-11-20T18:03:27.506251",
      "modified_at": "2025-11-20T18:03:27.506251",
      "updated_at": "2025-11-20T18:03:27.506251+00:00"
    },
    {
      "unique_id": "1762896366429x599348279945132448",
      "id": "0cf76f73-a751-4f65-b7bf-37f6cd5fdced",
      "name": "Admin User",
      "email": "admin@msu.edu",
      "permission": "admin",
      "organization_id": "4d051118-c116-4923-8ff4-1a9761115fec",
      "tenant_id": "your_tenant",
      "status": "active",
      "is_teli_admin": false,
      "mobile_app_enabled": false,
      "phone": null,
      "profile_image": null,
      "total_agents": 8,
      "total_campaigns": 14,
      "total_leads": 1,
      "total_sms_outbound": 45,
      "total_sms_inbound": 38,
      "total_mms_outbound": 0,
      "total_mms_inbound": 2,
      "total_voice_seconds": 942,
      "created_at": "2025-11-11T21:26:06.511984",
      "modified_at": "2025-11-11T21:26:06.511984",
      "updated_at": "2025-11-20T19:45:25.079258+00:00"
    }
  ],
  "powered_by": "Teli"
}
500 (Server Error)
{
  "error": "Failed to list users",
  "success": false,
  "powered_by": "Teli"
}

​
Permission Levels

​
Admin

  • Can view all organization resources
  • Can create/modify all campaigns and agents
  • Can see all users’ data
  • Can manage organization settings

​
User

  • Can only view their own resources
  • Can create campaigns and agents (visible only to them)
  • Cannot see other users’ data
  • Cannot manage organization settings

​
Notes

  • Each user record is scoped to a single organization
  • The same email can exist across multiple organizations, each with its own unique_id and permissions
  • Usage metrics are tracked per user for billing
  • Admin permission grants organization-wide visibility
  • When referencing a user in API calls, always use the unique_id, not the email address