---
title: "GET /assets/{asset_pk}/usage/aggregates"
method: GET
path: "/assets/{asset_pk}/usage/aggregates"
tags: ["Usage Reporting"]
---

# GET /assets/{asset_pk}/usage/aggregates

`GET /assets/{asset_pk}/usage/aggregates`

View class for Usage Aggregate API

## Path parameters

- `asset_pk` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `asset.external_uid` string
- `asset.id` string
- `item.id` string
- `item.local_id` string
- `item.type` 'Reservation' | 'PPU'

## Headers

- `Content-Range` ContentRange — unresolved $ref

## Response `200`

- UsageUsageRecordAggregate[]
  - `item` UsageReferenceItem, required — Serialize reference item object
    - `id` string, required
    - `local_id` string, nullable
    - `name` string, required
    - `unit` string, nullable
    - `mpn` string, nullable
    - `precision` string
    - `type` string
  - `asset` UsageReferenceAsset, required — Serialize reference asset object
    - `id` string, required
    - `external_id` string, nullable
    - `external_uid` string, nullable
  - `amount` number, nullable
  - `currency` string, nullable
  - `consumed` integer
  - `accepted` integer
  - `events` object
    - `last_reported` UsageUsageEvents
      - `at` string, date-time, required
      - `by` UsageReferenceUser
        - `id` string, required
        - `name` string, required

## Other responses

- `400`

---

[API](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api.md) · [All operations](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudblue/cloudblue-connect-api/revisions/0421d2a97c52/schema)