---
title: "List user's organizations"
method: GET
path: "/organizations"
tags: ["Organization Management"]
---

# List user's organizations

`GET /organizations`

Lists all organizations the user is a member of, optionally filtered to show only owned organizations when `owned=true`.

**Sorting:**
Results are sorted alphabetically by organization name.

**Information included:**
Each organization includes:
- Basic metadata
- A flag indicating if it's in a warning group (quota breach or payment issue)

**Returns:**
An empty list if the user is not a member of any organizations.

## Query parameters

- `owned` boolean

## Response `200`

Success

- object
  - `object` 'Organization', required
  - `items` Organization[], required
    - `id` string, required — Unique identifier for the organization
    - `name` string, required — Name of the organization
    - `description` string — Description of the organization
    - `owner_id` string, required — ID of the user who owns the organization
    - `total_storage` integer, required — Total storage allocated to the organization
    - `members` OrganizationMember[] — List of members in the organization
      - `id` string, required — Unique identifier for the organization member
      - `user_id` string, required — ID of the user who is a member of the organization
      - `organization_id` string, required — ID of the organization
      - `role` 'READ' | 'WRITE' | 'ADMIN' | 'OWNER', required
    - `invites` OrganizationInvite[] — List of invites sent by the organization
      - `id` integer — Unique identifier for the organization invite
      - `organization_id` string — ID of the organization
      - `organization_name` string — Name of the organization
      - `inviting_user_id` string — ID of the user who is inviting to the organization
      - `inviting_user_name` string — Name of the user who is inviting to the organization
      - `invited_email` string, email — Email of the user who is invited to the organization
      - `role` 'READ' | 'WRITE' | 'ADMIN' | 'OWNER'
      - `status` 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'CANCELED'
      - `created` string, date-time — Date and time when the invite was created
      - `expires` string, date-time — Date and time when the invite expires
    - `in_warning_group` boolean — Whether the organization is in the warning group

## Other responses

- `default` — An error occurred

---

[API](https://skmtc.net/diversion/apis/diversion-core-api.md) · [All operations](https://skmtc.net/diversion/apis/diversion-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/diversion/diversion-core-api/revisions/38a18aba804b/schema)