---
title: "Get current billing period usage"
method: GET
path: "/api/v1/billing/usage"
tags: ["Billing"]
---

# Get current billing period usage

`GET /api/v1/billing/usage`

## Request

- Base URL: `https://api.korala.ai`
- URL: `https://api.korala.ai/api/v1/billing/usage`
- Auth: one of:
  - API key in header `X-API-Key`
  - `bearer` (a scheme the document does not define)

## Response `200`

- UsageDto
  - `signingCount` number, required: Document signings used this period
  - `signingLimit` number, nullable: Signing limit (null = unlimited)
  - `signingRemaining` number, nullable: Signings remaining (null = unlimited)
  - `fillCount` number, required: Template fills used this period
  - `fillLimit` number, nullable: Fill limit (null = unlimited)
  - `fillRemaining` number, nullable: Fills remaining (null = unlimited)
  - `periodStart` string, date-time, required: Current billing period start
  - `periodEnd` string, date-time, required: Current billing period end
  - `planType` 'api_sandbox' | 'api_payg' | 'api_startup' | 'api_scale' | 'web_free' | 'web_pro' | 'web_business' | 'web_enterprise', required: Current plan type
  - `planName` string, required: Current plan display name
  - `signingOverageCents` number, required: Signing overage charges this period (cents)
  - `fillOverageCents` number, required: Fill overage charges this period (cents)

---

[API](https://skmtc.dev/korala/apis/korala-public-api.md) · [All operations](https://skmtc.dev/korala/apis/korala-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/korala/apis/korala-public-api/revisions/5c4d7810c507?raw)