---
title: "Get Cost Assets"
method: GET
path: "/api/v2/usage/assets"
tags: ["Assets"]
---

# Get Cost Assets

`GET /api/v2/usage/assets`

## Request

- Base URL: `https://api.umbrellacost.io`
- URL: `https://api.umbrellacost.io/api/v2/usage/assets`
- Auth: none declared. Required headers: `Authorization`, `apikey`

Retrieve the list of assets defined in the account

## Query parameters

- `startDate` string, date, required
- `endDate` string, date, required
- `granLevel` string, required
- `columns` string, required
- `filters` object
  - `dim` string: All the filtering options can be found here: https://docs.umbrellacost.io/reference/groupby-and-filtering-options
- `excludeFilters` object
  - `dim` string: All the filtering options can be found here: https://docs.umbrellacost.io/reference/groupby-and-filtering-options
- `likeFilters` object
  - `dim` string: All the filtering options can be found here: https://docs.umbrellacost.io/reference/groupby-and-filtering-options
- `excludeLikeFilters` object
  - `dim` string: All the filtering options can be found here: https://docs.umbrellacost.io/reference/groupby-and-filtering-options
- `isK8S` boolean
- `costType` string
- `k8sCostType` string
- `measurements` string
- `isUnblended` boolean, required
- `conjunction` string
- `includeCustomerCost` boolean
- `token` string

## Headers

- `Authorization` string, required
- `apikey` string, required

## Response `200`

- object
  - `usageDate` string
  - `payeraccount` string
  - `service` string
  - `totalcost` integer
  - `totalUsageQuantity` integer

---

[API](https://skmtc.dev/umbrellacost/apis/cost-usage.md) - [All operations](https://skmtc.dev/umbrellacost/apis/cost-usage/llms.txt) - [OpenAPI document](https://skmtc.dev/umbrellacost/apis/cost-usage/revisions/c5ae311d18ae?raw)