Skip to main content
GET
https://allomia.com
/
api
/
organization
/
{id}
Get Organization
curl --request GET \
  --url https://allomia.com/api/organization/{id} \
  --header 'Authorization: <authorization>'
{
  "currentOrg": {
    "id": "<string>",
    "tenantId": "<string>",
    "name": "<string>",
    "email": "<string>",
    "image": "<string>",
    "ownerId": "<string>",
    "address": "<string>",
    "city": "<string>",
    "stateProvince": "<string>",
    "postalCode": "<string>",
    "country": "<string>",
    "phoneNumber": "<string>",
    "timezone": "<string>",
    "isActive": true,
    "createdBy": "<string>",
    "lastModifiedBy": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "deletedAt": "<string>"
  },
  "userOrgs": [
    {
      "id": "<string>",
      "tenantId": "<string>",
      "name": "<string>",
      "email": "<string>",
      "image": "<string>",
      "ownerId": "<string>",
      "address": "<string>",
      "city": "<string>",
      "stateProvince": "<string>",
      "postalCode": "<string>",
      "country": "<string>",
      "phoneNumber": "<string>",
      "timezone": "<string>",
      "isActive": true,
      "createdBy": "<string>",
      "lastModifiedBy": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "deletedAt": "<string>"
    }
  ]
}

Get Organization

Retrieves a specific organization by ID. 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’

Path Parameters

id
string
required
The unique identifier of the organization to retrieve

Response

currentOrg
object
The requested organization details
userOrgs
array
Array of organizations the authenticated user has access to

Example Request

curl -X GET https://allomia.com/api/organization/a1b2c3d4-e5f6-7890-abcd-123456789012 \
  -H "Authorization: Bearer YOUR-API-KEY"

Example Response

{
  "currentOrg": {
    "id": "a1b2c3d4-e5f6-7890-abcd-123456789012",
    "tenantId": "tenant_123",
    "name": "Valley Health Clinic",
    "email": "[email protected]",
    "image": null,
    "ownerId": "b2c3d4e5-f6a7-8901-bcde-234567890123",
    "address": "123 Main Street",
    "city": "San Francisco",
    "stateProvince": "CA",
    "postalCode": "94105",
    "country": "USA",
    "phoneNumber": "+14155551234",
    "timezone": "America/Los_Angeles",
    "isActive": true,
    "createdBy": "b2c3d4e5-f6a7-8901-bcde-234567890123",
    "lastModifiedBy": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "createdAt": "2025-06-23T18:15:10.685Z",
    "updatedAt": "2025-06-23T18:15:10.685Z",
    "deletedAt": null
  },
  "userOrgs": [
    {
      "id": "d4e5f6a7-b8c9-0123-defa-456789012345",
      "tenantId": "tenant_123",
      "name": "Mountain Health Partners",
      "email": "[email protected]",
      "image": null,
      "ownerId": "e5f6a7b8-c9d0-1234-efab-567890123456",
      "address": "456 Oak Avenue",
      "city": "Denver",
      "stateProvince": "CO",
      "postalCode": "80202",
      "country": "USA",
      "phoneNumber": "+13035557890",
      "timezone": "America/Denver",
      "isActive": true,
      "createdBy": "e5f6a7b8-c9d0-1234-efab-567890123456",
      "lastModifiedBy": "f6a7b8c9-d0e1-2345-fabc-678901234567",
      "createdAt": "2025-04-24T18:54:08.365Z",
      "updatedAt": "2025-05-15T09:22:33.142Z",
      "deletedAt": null
    }
  ]
}