Organizations
Organizations represent healthcare systems, clinics, payers, or developer tenants. Every API call is scoped to an organization.
The Organization Object
| Field | Type | Description |
|---|---|---|
| id | string | Unique org ID with prefix org_ (e.g. org_01hx4f8gj3kqm9n) |
| name | string | Human-readable organization name |
| type | string | One of: health_system, clinic, payer, developer, research |
| fhirBasenullable | string | Base URL for the organization's FHIR R4 server |
| hipaaCompliant | boolean | Whether a signed BAA is on file with HealthCloud |
| plan | string | Subscription plan: starter | growth | enterprise |
| createdAt | datetime | ISO 8601 UTC timestamp of organization creation |
Endpoints
Returns all organizations accessible by the authenticated API key.
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| limite.g. 20 | query | integer | optional | Max records to return (1–100) |
| cursor | query | string | optional | Pagination cursor from previous response |
Request
curl -X GET "https://api.healthcloud.ai/v1/organizations" \ -H "Authorization: Bearer hc_test_sk_demo_live_xxxxxx"
Response
Response200
{ "data": [ { "id": "org_01hx4f8gj3kqm9n", "name": "St. Mercy Health System", "type": "health_system", "fhirBase": "https://fhir.stmercy.org/R4", "hipaaCompliant": true, "createdAt": "2025-01-15T08:00:00Z" } ], "meta": { "total": 3, "cursor": null } }