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

# Search Organizations

`GET /api/v2/organizations/search`

Returns an array of organizations matching the criteria. You may search by an organization's `external_id` or `name`, but not both:

#### Searching by `external_id`

If you set the `external_id` value of an organization to associate it to an external record, you can use it to search for the organization.

For an organization to be returned, its `external_id` must exactly match the value provided (case insensitive).

#### Searching by `name`

For an organization to be returned, its `name` must exactly match the value provided (case insensitive).

#### Allowed For:

* Admins
* Agents assigned to a custom role with permissions to add or modify organizations (Enterprise only)

See [Creating custom agent roles](https://support.zendesk.com/hc/en-us/articles/203662026#topic_cxn_hig_bd) in the Support Help Center.

## 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

---

[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)