---
title: "List global orgs"
method: GET
path: "/api/v2/global_orgs"
tags: ["Organizations"]
---

# List global orgs

`GET /api/v2/global_orgs`

Returns organizations across regions for the authenticated user. The `user_handle` query parameter must match the authenticated user's handle.

## Query parameters

- `user_handle` string, required
- `page[limit]` integer
- `page[cursor]` string

## Response `200`

OK

- GlobalOrgsResponse — Response containing organizations across regions for the authenticated user.
  - `data` GlobalOrgData[], required — Organizations across regions for the authenticated user.
    - `attributes` GlobalOrgAttributes, required — Attributes of an organization associated with the authenticated user.
      - `org` GlobalOrg, required — Organization information for a global organization association.
        - `name` string, required — The name of the organization.
        - `public_id` string, nullable — The public identifier of the organization.
        - `subdomain` string, nullable — The subdomain used to access the organization, if configured.
        - `uuid` string, uuid, required — The UUID of the organization.
      - `redirect_url` string, nullable — The login URL used to switch into the organization, if available.
      - `source_region` string, required — The source region of the organization.
      - `user` GlobalOrgUser, required — User information for a global organization association.
        - `handle` string, required — The handle of the user.
        - `uuid` string, uuid, required — The UUID of the user.
    - `type` 'global_user_orgs', required — The resource type for global user organizations.
  - `links` GlobalOrgsLinks — Pagination links.
    - `next` string, nullable — Link to the next page.
    - `prev` string, nullable — Link to the previous page.
    - `self` string — Link to the current page.
  - `meta` GlobalOrgsMeta — Response metadata object.
    - `page` GlobalOrgsMetaPage — Paging attributes.
      - `cursor` string — The cursor used to get the current results, if any.
      - `limit` integer — Number of results returned.
      - `next_cursor` string, nullable — The cursor used to get the next results, if any.
      - `prev_cursor` string, nullable — The cursor used to get the previous results, if any.
      - `type` 'cursor' — Type of global orgs pagination.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)