---
title: "List Organizations"
method: GET
path: "/api/v2/organizations"
tags: ["Organizations"]
---

# List Organizations

`GET /api/v2/organizations`

#### Pagination

* Cursor pagination (recommended)
* Offset pagination

See [Pagination](/api-reference/introduction/pagination/).

Returns a maximum of 100 records per page.

#### Allowed For

* Agents, with certain restrictions

If the agent has a custom agent role that restricts their access to only users in their own organization, a 403 Forbidden error is returned. See [Creating custom agent roles](https://support.zendesk.com/hc/en-us/articles/203662026-Creating-custom-roles-and-assigning-agents#topic_cxn_hig_bd) in Zendesk help.

## Query parameters

- `page[before]` string
- `page[after]` string
- `page[size]` integer

## Response `200`

Success response

- OrganizationsResponse
  - `count` integer
  - `next_page` string, nullable
  - `organizations` OrganizationObject[]
    - `created_at` string — The time the organization was created
    - `details` string, nullable — Any details obout the organization, such as the address
    - `domain_names` string[] — An array of domain names associated with this organization
    - `external_id` string, nullable — A unique external id to associate organizations to an external record. The id is case-insensitive. For example, "company1" and "Company1" are considered the same
    - `group_id` integer, nullable — New tickets from users in this organization are automatically put in this group
    - `id` integer — Automatically assigned when the organization is created
    - `name` string, required — A unique name for the organization
    - `notes` string, nullable — Any notes you have about the organization
    - `organization_fields` object, nullable — Custom fields for this organization. See [Custom organization fields](/api-reference/ticketing/organizations/organizations/#custom-organization-fields)
    - `shared_comments` boolean — End users in this organization are able to comment on each other's tickets
    - `shared_tickets` boolean — End users in this organization are able to see each other's tickets
    - `tags` string[] — The tags of the organization
    - `updated_at` string — The time of the last update of the organization
    - `url` string — The API url of this organization
  - `previous_page` string, nullable

## Changes

> 29 revisions in range; 1 not diffed, 1 could not be searched.

- **2025-06-12** `edbf399da815` — 1 info
  - added the new optional `query` request parameter `page[before]`

[Change history](https://skmtc.dev/botbrains-io/apis/support-api/changes/api/v2/organizations/get.md)

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)