# Organizations

> The organization the API key belongs to. Part of the HireHappy API reference (https://hirehappy.io/docs/api).

Base URL: `https://api.hirehappy.io/v1`. Authenticate with `Authorization: Bearer <API key>`.

### Retrieve your organization

`GET https://api.hirehappy.io/v1/organizations/self`

Any API key.

The organization the API key belongs to. Any key may read it: a quick way to check a key works.

**Example request**

```bash
curl "https://api.hirehappy.io/v1/organizations/self" \
  -H "Authorization: Bearer $HIREHAPPY_API_KEY"
```

**Response** `200`

| Name | Type | Description |
| --- | --- | --- |
| `id` | uuid |  |
| `name` | string |  |
| `slug` | string | Where its job board is: {jobs site}/{slug}. |
| `website` | string | nullable |
| `timezone` | string | IANA name, e.g. Europe/Berlin. |

```json
{
  "id": "0b6f3c2e-8a41-4d7e-9c55-3e2f1a7b9d10",
  "name": "Acme",
  "slug": "acme",
  "website": "https://acme.com",
  "timezone": "Europe/Berlin"
}
```

**Errors**: `401` the key is wrong, expired or revoked (api_key_required when missing).
