# List your organizations (/api/identity/list-orgs)

`GET /api/orgs`

Every org you belong to that the control plane has claimed, with the billing gate's verdict for each.

Base URL: `https://runners.starsling.dev`

## Authentication

Requires a bearer token (`Authorization: Bearer`).

## Responses

| Status | Description |
| --- | --- |
| `200` | Every org you belong to that the control plane has claimed, each with the billing gate's verdict. |
| `401` | No credential, or a GitHub grant that predates `read:org` — re-run `sling login`. |
| `403` | An API key without the `orgs:read` scope. Session callers are unscoped and never see this. |
| `500` | The request was valid; the control plane or a dependency it calls failed. |

### `200` body

- `orgs` — array<object>, required
  - array of object
    - `slug` — string, required. e.g. `acme`
    - `name` — string, required. e.g. `Acme, Inc.`
    - `role` — string. e.g. `admin`
    - `plan` — string, required. `paid`, `free`, `blocked`
    - `blocked_because` — string. `lapsed`, `grant_exhausted`

### Example

```json
{
  "orgs": [
    {
      "slug": "acme",
      "name": "Acme, Inc.",
      "plan": "free"
    }
  ]
}
```