---
title: "List My Organizations"
method: GET
path: "/v1/orgs"
tags: ["Organizations"]
---

# List My Organizations

`GET /v1/orgs`

## Request

- Base URL: `https://api.fettle.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fettle.sh/v1/orgs`
- Auth: API key in header `Authorization`

List the organizations you belong to, with your role in each.

## Response `200`

Successful Response

- OrganizationMembershipRead[]
  - `role` 'OWNER' | 'ADMIN' | 'MEMBER' | 'VIEWER', required: Membership role of a user within an organization. Distinct from the dormant global ``UserRole`` (account-level template seam). OWNER ⊇ ADMIN plus exclusive actions (delete org, transfer ownership); those exclusive endpoints are enforced in A2. MEMBER = operational CRUD; VIEWER = read-only. Member name == value (UPPER) to match the project enum convention and the persisted DB labels.
  - `organization` OrganizationRead, required: Public view of an organization. ``plan`` is here so the dashboard can badge every membership in the org switcher without a per-org subscription call. It is the tier and nothing else — billing identifiers and subscription state stay on ``GET /v1/users/me/subscription``.
    - `id` string, uuid, required
    - `name` string, required
    - `timezone` string, required
    - `plan` 'FREE' | 'PLUS' | 'PRO' | 'MAX' | 'ENTERPRISE', required: Subscription tier of an organization; gates feature/usage limits.

---

[API](https://skmtc.dev/fettle/apis/fettle-sh.md) · [All operations](https://skmtc.dev/fettle/apis/fettle-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/fettle/apis/fettle-sh/revisions/f32c8a18606f?raw)