---
title: "Usage"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Billing API

## Fields

- `Usage.organizationId` (string, required)
- `Usage.from` (string, required)
  - format `date-time`
- `Usage.to` (string, required)
  - format `date-time`
- `Usage.granularity` (string, required)
- `Usage.ratedThrough` (string, required)
  - format `date-time`
- `Usage.periods` (array<object>, required)
  - `Usage.periods.start` (string, required)
    - format `date-time`
  - `Usage.periods.end` (string, required) — Exclusive.
    - format `date-time`
  - `Usage.periods.estimated` (boolean, required) — Any of its groups is.
  - `Usage.periods.groups` (array<object>, required)
    - `Usage.periods.groups.keys` (map<string>, required) — Always includes meter.
    - `Usage.periods.groups.quantity` (string, required) — In unit.
      - pattern `^-?[0-9]+(\.[0-9]+)?$`
    - `Usage.periods.groups.unit` (string | null, required)
    - `Usage.periods.groups.eventCount` (integer, required)
    - `Usage.periods.groups.estimated` (boolean, required) — Some of it is a level carried forward.
- `Usage.values` (map<array<string>>, required) — Every value of each key in the window, whatever the filter.
- `Usage.labels` (object, required) — Display names for the IDs in the answer. IDs without one are left out.
  - `Usage.labels.services` (map<string>, required)
  - `Usage.labels.meters` (map<string>, required)
  - `Usage.labels.skus` (map<string>, required)
- `Usage.nextCursor` (null, required) — One page: always null.


Source: https://docs.ezghcloud.com/billing-api/schemas/Usage/index.md