---
title: "List your organizations."
method: GET
path: "/v1/org/memberships"
tags: ["org"]
---

# List your organizations.

`GET /v1/org/memberships`

## Request

- Base URL: `https://api.smolmachines.com`
- URL: `https://api.smolmachines.com/v1/org/memberships`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/smolmachines/apis/smolfleet-api/docs/v1/org/memberships/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns every organization the logged-in person belongs to, for switching accounts. Requires a user login, not an API key.

## Response `200`

Every organization the caller belongs to, most recently used first, with their role and the account's status; empty for a person on none.

- OrgMembership[]
  - `displayName` string, nullable: The human readable name the console shows.
  - `lastUsedAt` string, nullable: When the caller last acted here, or null if never; the list orders by it, latest first.
  - `name` string, required: The slug, unique across the fleet and final once chosen.
  - `role` string, required: The role the caller holds here: `owner`, `admin` or `member`.
  - `status` string, required: The account's state: `active`, `suspended`, `waitlisted` or `deleted`.
  - `tenantId` string, required: The organization's tenant id used in `Smol-Tenant` to act in this account.

## Other responses

- `401`: Missing or invalid API key
- `403`: The caller authenticated with an API key rather than a user login
- `429`: Rate limited; retry after the Retry-After header
- `500`: Internal error

## Changes

- **2026-10-16** `bc31fc04a568`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smolmachines/apis/smolfleet-api/changes/v1/org/memberships/get.md)

---

[API](https://skmtc.dev/smolmachines/apis/smolfleet-api.md) - [All operations](https://skmtc.dev/smolmachines/apis/smolfleet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smolmachines/apis/smolfleet-api/revisions/bc31fc04a568?raw)