---
title: "GET /usage/records"
method: GET
path: "/usage/records"
tags: ["Usage Reporting"]
---

# GET /usage/records

`GET /usage/records`

## Query parameters

- `limit` integer
- `offset` integer
- `asset.external_id` string
- `asset.external_uid` string
- `asset.id` string
- `asset_external_id` string
- `asset_external_uid` string
- `asset_id` string
- `created_time` string, date-time
- `end_date` string, date-time
- `hub.id` string
- `item.id` string
- `item_id` string
- `part_usage_file__hub__id` string
- `product.id` string
- `product_id` string
- `start_date` string, date-time
- `status` 'valid' | 'invalid' | 'approved' | 'rejected' | 'closed'
- `usage_file` string
- `usage_start_time` string, date-time
- `usagefile.id` string
- `usagefile.schema` 'tr' | 'pr' | 'qt' | 'cr'

## Headers

- `Content-Range` ContentRange — unresolved $ref

## Response `200`

- UsageUsageRecord[]
  - `id` string
  - `start_date` string, date-time
  - `end_date` string, date-time
  - `product_id` string, nullable
  - `external_billing_id` string
  - `external_billing_note` string
  - `item` UsageReferenceItem — 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 — Serialize reference asset object
    - `id` string, required
    - `external_id` string, nullable
    - `external_uid` string, nullable
  - `category` string
  - `tier` integer, nullable
  - `amount` number, nullable
  - `multiplier` integer
  - `usage` number, required
  - `status` 'valid' | 'invalid' | 'approved' | 'rejected' | 'closed', nullable
  - `closed_at` string, date-time, nullable
  - `closed_by` string, nullable
  - `params` UsageUsageRecordParameters[]
    - `parameter_name` string, required
    - `parameter_value` string, nullable
  - `item_id` string
  - `asset_id` string
  - `usagefile` UsageReferenceUsageFile, required
    - `id` string
    - `name` string, nullable
    - `schema` 'tr' | 'pr' | 'qt' | 'cr'
    - `currency` string, nullable
  - `resource_local_id` string
  - `asset_external_id` string
  - `asset_external_uid` string

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