---
title: "Get Usage"
method: GET
path: "/v1/usage"
tags: ["Usage"]
---

# Get Usage

`GET /v1/usage`

## Request

- Base URL: `https://api.racehooks.io`
- URL: `https://api.racehooks.io/v1/usage`
- Auth: API key in header `Authorization`

Get delivery usage for the authenticated client in the current period.

## Response `200`

Default Response

- object
  - `data` object
    - `period` string: Current billing-period key: the period's start date (YYYY-MM-DD) for a Stripe-billed account, or the calendar month (YYYY-MM) when the account has no Stripe billing period.
    - `periodStart` string: Start of the current period (ISO 8601, UTC)
    - `periodEnd` string: When the delivery bucket, overage and spend cap next reset (ISO 8601, UTC)
    - `tier` string
    - `deliveryCount` integer: Metered deliveries so far this month
    - `failureCount` integer
    - `monthlyDeliveryBucket` unknown
    - `bucketRemaining` unknown
    - `overageDeliveries` integer: Deliveries beyond the included bucket
    - `overageSpendCents` integer: Overage spend so far this month, in USD cents
    - `spendCapCents` unknown

## Other responses

- `401`: Missing or invalid Bearer token

---

[API](https://skmtc.dev/racehooks/apis/racehooks-api.md) · [All operations](https://skmtc.dev/racehooks/apis/racehooks-api/llms.txt) · [OpenAPI document](https://skmtc.dev/racehooks/apis/racehooks-api/revisions/2335b73f46e4?raw)