---
title: "Get Usage"
method: GET
path: "/v0/billing/get_usage"
tags: ["billing"]
---

# Get Usage

`GET /v0/billing/get_usage`

## Request

- Base URL: `https://api.databento.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.databento.com/v0/billing/get_usage`
- Auth: HTTP bearer

## Query parameters

- `start` string, required
- `end` string, nullable
- `granularity` string, nullable
- `retry` integer

## Response `200`

Successful Response

- BillingUsageResponse
  - `pending_usage` PendingUsageBucket[], required
    - `mode` string, required
    - `dataset` string, required
    - `schema` string, required
    - `cost_usd` number
    - `usage_bytes` integer
  - `settled_usage` SettledUsageBucket[], required
    - `mode` string, required
    - `dataset` string, required
    - `schema` string, required
    - `cost_usd` number
    - `usage_bytes` integer
    - `start` string, required
    - `end` string, required

## Other responses

- `400`: If the request parameters would lead to too many buckets
- `401`: If user authentication fails
- `403`: If user does not have sufficient permissions
- `422`: Validation Error

## Changes

- **2026-10-14** `c406c4f42fa6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/databento/apis/databento-openapi-specification/changes/v0/billing/get_usage/get.md)

---

[API](https://skmtc.dev/databento/apis/databento-openapi-specification.md) - [All operations](https://skmtc.dev/databento/apis/databento-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/databento/apis/databento-openapi-specification/revisions/9cc41e22eead?raw)