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

# Get cloud assets

`GET /clouds/assets`

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.net/aikido/apis/authorization.md) · [All operations](https://skmtc.net/aikido/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aikido/authorization/versions/5445e7c21137/schema)