Skip to main content
GET
https://allomia.com
/
api
/
organization
List Organizations
curl --request GET \
  --url https://allomia.com/api/organization \
  --header 'Authorization: <authorization>'
{
  "organizations": [
    {
      "id": "<string>",
      "name": "<string>",
      "email": "<string>",
      "address": "<string>",
      "city": "<string>",
      "stateProvince": "<string>",
      "postalCode": "<string>",
      "country": "<string>",
      "phoneNumber": "<string>",
      "tenantId": "<string>",
      "timezone": "<string>",
      "createdAt": "<string>",
      "createdBy": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "totalPages": 123,
    "hasNextPage": true,
    "hasPreviousPage": true
  }
}

​
List Organizations

Retrieves a paginated list of organizations for the authenticated tenant. This endpoint requires a valid tenant API key for authentication.

​
Headers

​
Authorization
string
required
API key is required. Enter your tenant-specific API key in the format ‘Bearer YOUR-API-KEY’

​
Query Parameters

​
page
integer
default:"1"
Page number for pagination (1-based indexing)
​
limit
integer
default:"10"
Number of items per page (default 10, max 100)
​
sort
string
default:"createdAt"
Field to sort by (prefix with - for descending order, e.g. -createdAt)
​
search
string
Search term to filter organizations by name

​
Response

​
organizations
array
Array of organization objects
​
pagination
object
Pagination information

​
Example Request

curl -X GET "https://allomia.com/api/organization?page=1&limit=10&sort=name&search=health" \
  -H "Authorization: Bearer YOUR-API-KEY"

​
Example Response

{
  "organizations": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-123456789012",
      "name": "Valley Health Clinic",
      "email": "[email protected]",
      "address": "123 Main Street",
      "city": "San Francisco",
      "stateProvince": "CA",
      "postalCode": "94105",
      "country": "USA",
      "phoneNumber": "+14155551234",
      "tenantId": "tenant_123",
      "timezone": "America/Los_Angeles",
      "createdAt": "2025-06-01T12:34:56Z",
      "createdBy": "b2c3d4e5-f6a7-8901-bcde-234567890123"
    },
    {
      "id": "d4e5f6a7-b8c9-0123-defa-456789012345",
      "name": "Mountain Health Partners",
      "email": "[email protected]",
      "address": "456 Oak Avenue",
      "city": "Denver",
      "stateProvince": "CO",
      "postalCode": "80202",
      "country": "USA",
      "phoneNumber": "+13035557890",
      "tenantId": "tenant_123",
      "timezone": "America/Denver",
      "createdAt": "2025-05-15T09:22:33Z",
      "createdBy": "e5f6a7b8-c9d0-1234-efab-567890123456"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  }
}