# Organization API

The Organization API returns the organization permanently bound to the API Client. An API Client cannot select, enumerate, or switch to another organization.

## Roles

All active API Client Roles may read the organization summary. Sensitive billing, subscription, license, security, and internal configuration are excluded.

## Get the organization

`GET /v1/organization`

Operation ID: `getOrganization`

```bash
curl https://api.eoshq.com/v1/organization \
  -H 'Authorization: Bearer ACCESS_TOKEN'
```

```json
{
  "object": "organization",
  "id": "org_01J8Q4VYG8QF9MR6X2F3XVBJPQ",
  "name": "Acme Services",
  "status": "active",
  "timezone": "America/Chicago",
  "currency": "USD",
  "locale": "en-US",
  "created_at": "2025-11-03T14:20:00Z",
  "links": {
    "web": "https://app.eoshq.com/settings"
  }
}
```

### Response fields

| Field | Type | Description |
|---|---|---|
| `id` | string | Stable opaque organization ID |
| `name` | string | Display name |
| `status` | enum | `active`, `restricted`, or `suspended` |
| `timezone` | string | IANA time-zone identifier |
| `currency` | string | ISO 4217 default currency |
| `locale` | string | BCP 47 locale |
| `created_at` | timestamp | Organization creation time |
| `links.web` | URI | Named-user Eos interface; not an API endpoint |

## Not supported

The v1 API does not permit API Clients to update organization settings, billing, licenses, ownership, plans, security, or integration policy.

Next: [Members API](members.html).