# Organisations and access

> Find your organisation id and send it with every request.

Canonical page: https://aozo.in/docs/api/organisations-and-access
Last updated: 2026-11-12
Product: Open API
Section: Getting started

A person can belong to more than one organisation. Every call that touches workspace data must say which one.

![Your token plus the X-Organization-Id header gives your view of one workspace. Owners and admins see everything and other members see their own leads and tickets. A missing header returns a 400 error](https://aozo.in/images/docs/api-org-scope.webp)

## Find your organisation id

- The sign-in response includes an organizations list. Use the id value.
- GET /api/auth/me returns your profile and your organisations too.

## Send it

**Request**

```bash
curl https://api.aozo.in/api/crm/leads \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Organization-Id: ORG_ID"
```

## What can go wrong

| Status | Message | Meaning |
| --- | --- | --- |
| 400 | X-Organization-Id header is required | You did not send the organisation header. |
| 403 | Access to the organisation is not allowed | You are not an active member of that organisation. |
| 404 | Organization not found | The id does not exist. |

> **Note:** Use the same organisation id for the whole session unless you deliberately switch workspace.