# List My Orgs

> List the organizations the current principal belongs to (identity only).

Canonical URL: https://docs.botyard.io/docs/api/me/list_my_orgs_v1_me_orgs_get

`GET /v1/me/orgs`

List the organizations the current principal belongs to (identity only).

Actor-agnostic counterpart to ``/v1/users/me/orgs``: users get every org
they are a member of, bots and API keys get their single resolved principal
org, each carrying the caller's effective role (``viewer`` for bots). The
response is **identity-only** — no billing/plan/subscription fields — so this
endpoint never discloses org billing state to a service principal. It is a
pure read of the caller's *own* org context and never enumerates orgs the
principal does not belong to.

## Responses

| Status | Description | Body |
| --- | --- | --- |
| `200` | Successful Response | array of PrincipalOrgResponse |
| `default` | RFC 9457 Problem Details error response | ProblemDetails |

Full schemas: operation `list_my_orgs_v1_me_orgs_get` in the OpenAPI spec at https://api.botyard.io/openapi.json.