---
title: "List connected clouds"
method: GET
path: "/clouds"
---

# List connected clouds

`GET /clouds`

## Request

- Base URL: `https://app.aikido.dev/api/public/v1`
- URL: `https://app.aikido.dev/api/public/v1/clouds`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://app.aikido.io/api/oauth/token` scopes: `clouds:read`

Returns a list of all the active clouds connected in your account

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

A list of clouds connected to your account

- object[]
  - `id` integer, required: The ID of the connected cloud in Aikido.
  - `name` string, required: A name for this cloud environment.
  - `provider` 'aws' | 'gcp' | 'azure', required: The provider of the connected cloud environment.
  - `environment` 'production' | 'staging' | 'development' | 'mixed', required: Indicates for what environment this cloud is responsible.
  - `external_id` string, required: The ID of the connected environment for the respective provider.
  - `last_scanned_at` integer, required: Timestamp representing when the cloud was last scanned. -1 when no scan has happened yet.

---

[API](https://skmtc.dev/aikido/apis/aikido-security-api-documentation.md) - [All operations](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/revisions/da8691338133?raw)