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

# GET /usage/chunks

`GET /usage/chunks`

## Query parameters

- `limit` integer
- `offset` integer
- `binding.hub.id` string
- `id` string
- `provider.id` string
- `status` 'draft' | 'ready' | 'closed' | 'failed'
- `usagefile.id` string

## Headers

- `Content-Range` ContentRange — unresolved $ref

## Response `200`

- UsagePartUsageFile[]
  - `id` string
  - `status` 'draft' | 'ready' | 'closed' | 'failed'
  - `outdated` boolean
  - `usagefile` UsageReferenceUsageFile
    - `id` string
    - `name` string, nullable
    - `schema` 'tr' | 'pr' | 'qt' | 'cr'
    - `currency` string, nullable
  - `binding` UsageReferenceBinding
    - `hub` UsageReferenceHub
      - `id` string, required
      - `name` string, nullable
    - `external_id` string
  - `marketplace` UsageReferenceMarketplace
    - `id` string, required
    - `name` string, nullable
    - `icon` string, nullable
  - `error` object
    - `detail` string
  - `events` object
    - `created` UsageUsageEvents
      - `at` string, date-time, required
      - `by` UsageReferenceUser
        - `id` string, required
        - `name` string, required
    - `uploaded` UsageUsageEvents
      - `at` string, date-time, required
      - `by` UsageReferenceUser
        - `id` string, required
        - `name` string, required
    - `submitted` UsageUsageEvents
      - `at` string, date-time, required
      - `by` UsageReferenceUser
        - `id` string, required
        - `name` string, required
    - `accepted` UsageUsageEvents
      - `at` string, date-time, required
      - `by` UsageReferenceUser
        - `id` string, required
        - `name` string, required
    - `closed` UsageUsageEvents
      - `at` string, date-time, required
      - `by` UsageReferenceUser
        - `id` string, required
        - `name` string, required
    - `rejected` UsageUsageEvents
      - `at` string, date-time, required
      - `by` UsageReferenceUser
        - `id` string, required
        - `name` string, required
    - `deleted` UsageUsageEvents
      - `at` string, date-time, required
      - `by` UsageReferenceUser
        - `id` string, required
        - `name` string, required
  - `stats` object
    - `uploaded` integer
    - `validated` integer
    - `pending` integer
    - `accepted` integer
    - `closed` integer
    - `billed` integer
  - `provider` UsageReferenceAccount
    - `id` string, required
    - `name` string, nullable
    - `icon` string, nullable
  - `external_id` 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)