> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allomia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Organization

> Retrieves a specific organization by ID

## Get Organization

Retrieves a specific organization by ID. This endpoint requires a valid tenant API key for authentication.

### Headers

<ParamField header="Authorization" type="string" required>
  API key is required. Enter your tenant-specific API key in the format 'Bearer
  YOUR-API-KEY'
</ParamField>

### Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the organization to retrieve
</ParamField>

### Response

<ResponseField name="currentOrg" type="object">
  The requested organization details

  <Expandable title="Organization properties">
    <ResponseField name="id" type="string">
      The unique identifier for the organization
    </ResponseField>

    <ResponseField name="tenantId" type="string">
      The tenant ID that the organization belongs to
    </ResponseField>

    <ResponseField name="name" type="string">
      The name of the organization
    </ResponseField>

    <ResponseField name="email" type="string">
      The email address for the organization
    </ResponseField>

    <ResponseField name="image" type="string" nullable>
      The organization's image/logo URL (if set)
    </ResponseField>

    <ResponseField name="ownerId" type="string">
      The unique identifier of the organization owner
    </ResponseField>

    <ResponseField name="address" type="string">
      The street address of the organization
    </ResponseField>

    <ResponseField name="city" type="string">
      The city where the organization is located
    </ResponseField>

    <ResponseField name="stateProvince" type="string">
      The state or province where the organization is located
    </ResponseField>

    <ResponseField name="postalCode" type="string">
      The postal code or ZIP code for the organization
    </ResponseField>

    <ResponseField name="country" type="string">
      The country where the organization is located
    </ResponseField>

    <ResponseField name="phoneNumber" type="string">
      The contact phone number for the organization
    </ResponseField>

    <ResponseField name="timezone" type="string">
      The timezone for the organization
    </ResponseField>

    <ResponseField name="isActive" type="boolean">
      Whether the organization is active
    </ResponseField>

    <ResponseField name="createdBy" type="string">
      The ID of the user who created the organization
    </ResponseField>

    <ResponseField name="lastModifiedBy" type="string" nullable>
      The ID of the user who last modified the organization
    </ResponseField>

    <ResponseField name="createdAt" type="string" format="date-time">
      The timestamp when the organization was created (ISO 8601 format: "2025-06-01T12:34:56Z")
    </ResponseField>

    <ResponseField name="updatedAt" type="string" format="date-time">
      The timestamp when the organization was last updated (ISO 8601 format: "2025-06-01T12:34:56Z")
    </ResponseField>

    <ResponseField name="deletedAt" type="string" format="date-time" nullable>
      The timestamp when the organization was deleted (if soft deleted)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="userOrgs" type="array">
  Array of organizations the authenticated user has access to

  <Expandable title="Organization properties">
    <ResponseField name="id" type="string">
      The unique identifier for the organization
    </ResponseField>

    <ResponseField name="tenantId" type="string">
      The tenant ID that the organization belongs to
    </ResponseField>

    <ResponseField name="name" type="string">
      The name of the organization
    </ResponseField>

    <ResponseField name="email" type="string">
      The email address for the organization
    </ResponseField>

    <ResponseField name="image" type="string" nullable>
      The organization's image/logo URL (if set)
    </ResponseField>

    <ResponseField name="ownerId" type="string">
      The unique identifier of the organization owner
    </ResponseField>

    <ResponseField name="address" type="string">
      The street address of the organization
    </ResponseField>

    <ResponseField name="city" type="string">
      The city where the organization is located
    </ResponseField>

    <ResponseField name="stateProvince" type="string">
      The state or province where the organization is located
    </ResponseField>

    <ResponseField name="postalCode" type="string">
      The postal code or ZIP code for the organization
    </ResponseField>

    <ResponseField name="country" type="string">
      The country where the organization is located
    </ResponseField>

    <ResponseField name="phoneNumber" type="string">
      The contact phone number for the organization
    </ResponseField>

    <ResponseField name="timezone" type="string">
      The timezone for the organization
    </ResponseField>

    <ResponseField name="isActive" type="boolean">
      Whether the organization is active
    </ResponseField>

    <ResponseField name="createdBy" type="string">
      The ID of the user who created the organization
    </ResponseField>

    <ResponseField name="lastModifiedBy" type="string" nullable>
      The ID of the user who last modified the organization
    </ResponseField>

    <ResponseField name="createdAt" type="string" format="date-time">
      The timestamp when the organization was created (ISO 8601 format: "2025-06-01T12:34:56Z")
    </ResponseField>

    <ResponseField name="updatedAt" type="string" format="date-time">
      The timestamp when the organization was last updated (ISO 8601 format: "2025-06-01T12:34:56Z")
    </ResponseField>

    <ResponseField name="deletedAt" type="string" format="date-time" nullable>
      The timestamp when the organization was deleted (if soft deleted)
    </ResponseField>
  </Expandable>
</ResponseField>

### Example Request

```bash theme={null}
curl -X GET https://allomia.com/api/organization/a1b2c3d4-e5f6-7890-abcd-123456789012 \
  -H "Authorization: Bearer YOUR-API-KEY"
```

### Example Response

```json theme={null}
{
  "currentOrg": {
    "id": "a1b2c3d4-e5f6-7890-abcd-123456789012",
    "tenantId": "tenant_123",
    "name": "Valley Health Clinic",
    "email": "info@valleyhealthclinic.com",
    "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": "contact@mountainhealth.org",
      "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
    }
  ]
}
```