---
title: "List Organizations"
method: GET
path: "/organizations"
tags: ["Users", "Organizations"]
---

# List Organizations

`GET /organizations`

Browse through all the organizations (companies, teams, etc.) in your workspace. Search for specific organizations or paginate through the full list. Perfect for building admin dashboards or organization management interfaces.

The response includes a `Link` header with URLs for next/previous pages, making pagination straightforward.

## Query parameters

- `limit` number — Maximum number of results to return.
- `offset` number — Offset for pagination.
- `page` number — Page number (used to derive offset = (page-1)*limit).

## Response `200`

Organizations retrieved successfully

- TenantOrganization[] — Array of organizations.
  - `id` string, required — The Greenflash organization ID.
  - `externalId` string — Your external organization ID.
  - `name` string — The organization name.
  - `properties` object, required — Custom organization properties.
  - `createdAt` string, date-time — When the organization was first created.
  - `updatedAt` string, date-time — When the organization was last updated.

## Other responses

- `400` — Bad request - invalid parameters
- `500` — Server error

## Changes

- **2025-11-24** `c1998d918478` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/changes/organizations/get.md)

---

[API](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference.md) · [All operations](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenflash-ai/greenflash-api-reference/revisions/c566e560677d/schema)