---
title: "Get cloud assets"
method: GET
path: "/clouds/assets"
---

# Get cloud assets

`GET /clouds/assets`

## Request

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

Returns cloud assets for the connected clouds in your account. Supports pagination, filtering and search parameters similar to the cloud inventory UI. Array-valued filters are passed as comma-separated values. AI cloud search through this public endpoint expects prompts to be created in the Aikido app first and reused via `prompt_id`.

## Query parameters

- `page` integer
- `limit` integer
- `search` string
- `sort` string
- `prompt_id` integer
- `include_metadata` boolean
- `metadata_fields` string[]
- `asset_type` string[]
- `region` string[]
- `cloud_id` integer[]
- `provider` string[]
- `source_id` string[]

## Response `200`

A paginated list of cloud assets.

- object: A paginated cloud asset response.
  - `assets` object[]: The returned cloud assets.
    - `id` integer, required: The Aikido cloud asset id.
    - `asset_type` string, required: The provider specific type of the asset.
    - `asset_name` string, required: The display name of the asset.
    - `source_id` string: The provider specific identifier of the asset.
    - `region` string: The region where the asset is located.
    - `cloud_id` integer, required: The id of the connected cloud this asset belongs to.
    - `provider` string: The cloud provider for this asset.
    - `metadata` object: The full asset metadata resembling the output from cloud provider. Only returned when `include_metadata` is enabled.
    - `selected_metadata` object: Projected metadata values selected through `metadata_fields`.
  - `totalCount` integer: The total number of matching assets.
  - `hasMore` boolean: Whether more assets can be fetched on a next page.
  - `promptId` integer: Identifier of the prompt used for the search when applicable.

---

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