---
title: "Lists the caller's organizations, cursor-paginated."
method: GET
path: "/api/v1/orgs"
tags: ["Organizations"]
---

# Lists the caller's organizations, cursor-paginated.

`GET /api/v1/orgs`

## Request

- Base URL: `https://api.featureflip.io`
- URL: `https://api.featureflip.io/api/v1/orgs`
- Auth: API key in header `Authorization`

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

OK

- OrganizationResponsePagedResult: A page of results plus an opaque cursor for the next page, or null when this is the last page. Wire keys are frozen: `items` (already lowercase under the camelCase policy) and `next_cursor` (pinned explicitly — the policy alone would emit `nextCursor`).
  - `items` OrganizationResponse[], nullable, required
    - `id` string, uuid, required
    - `name` string, nullable, required
    - `slug` string, nullable, required
    - `plan` 'Solo' | 'Team' | 'Pro' | 'Business' | 'Enterprise', nullable, required: Allowed values: Solo, Team, Pro, Business, Enterprise.
    - `isActive` boolean, required
    - `createdAt` string, date-time, required
  - `next_cursor` string, nullable
  - `_actions` object: Capability hints: which operations the authenticated caller may perform on this resource, each with allowed + optional reason. Computed from the caller's role and the resource's state. Injected at runtime; safe to ignore. Present only on top-level resource responses — nested occurrences (e.g. a rule inside a targeting-config response) do not carry it.

## Other responses

- `401`: Authentication is required, or the supplied API token is invalid or expired.
- `429`: Rate limit exceeded. Retry after the interval indicated by the Retry-After header.

---

[API](https://skmtc.dev/featureflip/apis/management-api.md) · [All operations](https://skmtc.dev/featureflip/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/featureflip/apis/management-api/revisions/8a77e8581a45?raw)