# List purposes

Source: https://immiscible.fly.dev/docs/api/get-v1-platform-purposes

`GET /v1/platform/purposes`

## Authentication

Workspace key. A gateway key (`ask_...`) issued under Keys in the console, sent as `Authorization: Bearer` or `x-api-key`. It binds traffic to a person or service, a team and optionally a task class.

## Request

curl:

```bash
curl "https://immiscible.fly.dev/v1/platform/purposes" \
  -H "authorization: Bearer $IMMISCIBLE_KEY"
```

Node:

```ts
const res = await fetch('https://immiscible.fly.dev/v1/platform/purposes', {
  headers: {
    authorization: `Bearer ${process.env.IMMISCIBLE_KEY}`,
  },
});
const data = await res.json();
console.log(res.status, data);
```

Python:

```python
import os
import requests

res = requests.get(
    "https://immiscible.fly.dev/v1/platform/purposes",
    headers={
        "authorization": f"Bearer {os.environ['IMMISCIBLE_KEY']}",
    },
)
print(res.status_code, res.json())
```