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

# List global orgs

`GET /api/v2/global_orgs`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/global_orgs`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `user_access_read`

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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)