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

# List your managed organizations

`GET /api/v2/org`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/org`
- 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: `org_management`, `org_connections_write`

Returns the current organization and its managed organizations in JSON:API format.

## Query parameters

- `filter[name]` string

## Response `200`

OK

- ManagedOrgsResponse: Response containing the current organization and its managed organizations.
  - `data` ManagedOrgsData, required: The managed organizations resource.
    - `id` string, uuid, required: The UUID of the current organization.
    - `relationships` ManagedOrgsRelationships, required: Relationships of the managed organizations resource.
      - `current_org` ManagedOrgsRelationshipToOrg, required: Relationship to the current organization.
        - `data` OrgRelationshipData, required: Reference to an organization resource.
          - `id` string, uuid, required: The UUID of the organization.
          - `type` 'orgs', required: The resource type for organizations.
      - `managed_orgs` ManagedOrgsRelationshipToOrgs, required: Relationship to the managed organizations.
        - `data` OrgRelationshipData[], required: List of managed organization references.
          - `id` string, uuid, required: The UUID of the organization.
          - `type` 'orgs', required: The resource type for organizations.
    - `type` 'managed_orgs', required: The resource type for managed organizations.
  - `included` OrgData[], required: Included organization resources.
    - `attributes` OrgAttributes, required: Attributes of an organization.
      - `created_at` string, date-time, required: The creation timestamp of the organization.
      - `description` string, required: A description of the organization.
      - `disabled` boolean, required: Whether the organization is disabled.
      - `modified_at` string, date-time, required: The last modification timestamp of the organization.
      - `name` string, required: The name of the organization.
      - `public_id` string, required: The public identifier of the organization.
      - `sharing` string, required: The sharing setting of the organization.
      - `url` string, required: The URL of the organization.
    - `id` string, uuid, required: The UUID of the organization.
    - `type` 'orgs', required: The resource type for organizations.

## Other responses

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