# API: Organisations

Who a token acts as, and the organisations it reaches.

Part of the API reference: requests carry a personal access token as `Authorization: Bearer <token>`, and bodies and answers are JSON.

- [API reference](https://typefuse.dev/guides/api-reference)
- [Try it in the API console](https://api.typefuse.dev/docs)

## Organisations

### GET /v1/whoami

**Who the token acts as.**

**Answer (200)**

| Name | Type | Description |
| --- | --- | --- |
| `person` | `object or null` |  |
| `person.id` | `integer` |  |
| `person.name` | `string` |  |
| `person.email` | `string or null` |  |
| `via` | `string`, one of `session`, `token`, `app` |  |
| `app` | `string or null` | The connected app's name when an app is calling. |
| `scope` | `string`, one of `full`, `run`, `read` |  |
| `organisation` | `string or null` | The one organisation a connected app is limited to; null for all. |

```sh
curl "https://api.typefuse.dev/v1/whoami" \
  -H "Authorization: Bearer $TYPEFUSE_TOKEN"
```

### GET /v1/organisations

**List your organisations.**

**Answer (200)**

| Name | Type | Description |
| --- | --- | --- |
| `organisations` | `array` |  |

```sh
curl "https://api.typefuse.dev/v1/organisations" \
  -H "Authorization: Bearer $TYPEFUSE_TOKEN"
```
