---
title: "List your organizations"
method: GET
path: "/organizations"
tags: ["Identity"]
---

# List your organizations

`GET /organizations`

## Request

- Base URL: `https://arena-predictions.com/api/v1`
- URL: `https://arena-predictions.com/api/v1/organizations`
- Auth: HTTP bearer

The organizations this personal API key belongs to. Any valid key, no particular scope. Forwarded to the organizations edge function: the anon key is only the gateway bearer, and the caller's key goes in X-Arena-Key. The function's JSON is returned. A 2xx object has mode paper (set here when the function left it out). Each organization's id is what X-Arena-Org takes on GET /portfolio, GET /portfolio/trades, POST /portfolio/orders and DELETE /portfolio/orders/{orderId}. This route ignores X-Arena-Org and does not select a sandbox or a Combine evaluation account. GET takes no query parameters. POST and every other method answer 405 method_not_allowed and are not forwarded. Paper only. Not cached.

## Response `200`

The organizations this key belongs to. mode is paper.

- OrganizationList
  - `organizations` Organization[], required: The organizations this personal key belongs to. Empty when it belongs to none.
    - `id` string, uuid, required
    - `slug` string, nullable
    - `name` string, nullable
    - `role` string, nullable: The key owner's membership, such as member.
  - `mode` 'paper', required

## Other responses

- `400`: invalid_request: GET /organizations takes no query parameters.
- `401`: Missing, malformed, unknown, revoked or expired key. Carries a WWW-Authenticate: Bearer challenge.
- `429`: rate_limited (over the plan's minute limit) or quota_exceeded (over the month). Only while the limits are enforced; until then requests are counted and the headers set, and nothing is refused. error.retryAfterSeconds equals Retry-After.
- `503`: The key could not be verified, or the organizations could not be listed, right now. Retry after the Retry-After seconds.

---

[API](https://skmtc.dev/arena-predictions/apis/arena-api.md) · [All operations](https://skmtc.dev/arena-predictions/apis/arena-api/llms.txt) · [OpenAPI document](https://skmtc.dev/arena-predictions/apis/arena-api/revisions/9d89d166dae6?raw)