# List domains

Launch stage: Beta

`GET /api/2.0/domains`

`GET /api/discover/v1/domains`

List domains in the account. Set `parent_domain_id` to return only the
 direct subdomains of a given domain.

 Authorization: external callers must have the `MANAGE DISCOVERY` permission;
 only domains the caller is authorized to read are returned.

API scopes: domains

## Query parameters

- `page_size` (int32, optional)
- `page_token` (string, optional)
- `parent_domain_id` (string, optional)
  Filter by parent domain.
   - Absent: return all domains regardless of hierarchy.
   - Present: return only direct children of the specified domain.

## Returns

Returns a list of Domain objects.

## Response

```json
{
  "domains": [
    {
      "domain_id": "string",
      "tag_key": "string",
      "effective_draft": true,
      "icon": {},
      "subtitle": "string",
      "description": "string",
      "create_time": "string",
      "technical_owner_ids": [
        0
      ],
      "business_owner_ids": [
        0
      ],
      "parent_domain_id": "string",
      "name": "string",
      "update_time": "string"
    }
  ],
  "next_page_token": "string"
}
```