List organizations with pagination

get/v1/orgs

Retrieves a paginated list of organizations with optional filtering by name. Returns up to 100 organizations per request.

Query ParametersExpand Collapse

cursor: optional string

Base64 encoded cursor from previous response

limit: optional number

Number of results to return (1-100)

minimum1

maximum100

ReturnsExpand Collapse

hasMore: boolean

organizations: array of object { createdAt, isActive, orgId, 6 more }

createdAt: string

Timestamp when the organization was created

formatdate-time

isActive: boolean

Whether the organization is currently active

orgId: string

Unique organization identifier. Format: org_{32-hex-chars}

orgName: string

Name of the organization

minLength1

updatedAt: string

Timestamp when the organization was last updated

formatdate-time

userCount: number

Number of users currently in this organization

minimum0

createdByApiKeyId: optional string

UUID of the API key used to create this organization, for audit tracking

formatuuid

createdByUserId: optional string

User ID who created this organization via dashboard, null if created via API key

metadata: optional map[string]

Custom key-value metadata for the organization. Maximum 50 pairs, keys up to 100 chars, values up to 1000 chars

cursor: optional string

List organizations with pagination

curl https://api.avarasoftware.com/v1/orgs \
    -H "Authorization: Bearer $AVARA_API_KEY"

{
  "hasMore": true,
  "organizations": [
    {
      "createdAt": "2024-01-15T09:00:00Z",
      "isActive": true,
      "orgId": "org_1234567890abcdef1234567890abcdef",
      "orgName": "City Medical Center - Radiology Department",
      "updatedAt": "2024-03-15T14:20:00Z",
      "userCount": 15,
      "createdByApiKeyId": "550e8400-e29b-41d4-a716-446655440000",
      "createdByUserId": "usr_1234567890abcdef1234567890abcdef",
      "metadata": {
        "department": "radiology",
        "region": "northeast"
      }
    }
  ],
  "cursor": "cursor"
}

Returns Examples

{
  "hasMore": true,
  "organizations": [
    {
      "createdAt": "2024-01-15T09:00:00Z",
      "isActive": true,
      "orgId": "org_1234567890abcdef1234567890abcdef",
      "orgName": "City Medical Center - Radiology Department",
      "updatedAt": "2024-03-15T14:20:00Z",
      "userCount": 15,
      "createdByApiKeyId": "550e8400-e29b-41d4-a716-446655440000",
      "createdByUserId": "usr_1234567890abcdef1234567890abcdef",
      "metadata": {
        "department": "radiology",
        "region": "northeast"
      }
    }
  ],
  "cursor": "cursor"
}