Skip to main content
GET
/
v1
/
organizations
List Organizations
curl --request GET \
  --url https://api.example.com/v1/organizations \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "count": 123,
  "organizations": [
    {
      "unique_id": "<string>",
      "id": "<string>",
      "name": "<string>",
      "organization_name": "<string>",
      "tenant_id": "<string>",
      "status": "<string>",
      "contact_email": "<string>",
      "sms_active": true,
      "teli_sms_number": "<string>",
      "sms_phone_number": "<string>",
      "business_registration_id": "<string>",
      "sms_registration_id": "<string>",
      "sms_registration_uuid": "<string>",
      "sms_registration_status": "<string>",
      "registration_submitted_at": {},
      "registration_approved_at": {},
      "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 a list of all organizations in your Teli account with their registration status, usage metrics, and SMS settings.

​
Authentication

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

​
Response Fields

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

​
Example Request

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

​
Example Response

200
{
  "success": true,
  "count": 2,
  "organizations": [
    {
      "unique_id": "1762896364768x389173798861431550",
      "id": "4d051118-c116-4923-8ff4-1a9761115fec",
      "name": "test org",
      "organization_name": "test org",
      "tenant_id": "your_tenant",
      "status": "active",
      "contact_email": null,
      "sms_active": false,
      "teli_sms_number": null,
      "business_registration_id": null,
      "sms_registration_id": null,
      "sms_registration_uuid": null,
      "sms_registration_status": "not_started",
      "registration_submitted_at": null,
      "registration_approved_at": null,
      "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:05.028562",
      "modified_at": "2025-11-11T21:26:05.028562",
      "updated_at": "2025-11-20T19:45:24.927039+00:00"
    }
  ],
  "powered_by": "Teli"
}
500 (Server Error)
{
  "error": "Failed to list organizations",
  "success": false,
  "powered_by": "Teli"
}

​
Notes

  • Organizations are the top-level entity in Teli
  • Each organization can have multiple users
  • SMS registration status determines messaging capabilities
  • Usage metrics are updated in real-time
  • Phone numbers are assigned after SMS registration approval