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

# Get current billing period usage

`GET /usage`

## Request

- Base URL: `https://api.tinysend.com/v1`
- URL: `https://api.tinysend.com/v1/usage`
- Auth: HTTP bearer

## Response `200`

Usage info

- object
  - `plan` string, required
  - `period_start` string, required
  - `period_end` string, required
  - `emails_included` number, required
  - `emails_sent` number, required
  - `emails_remaining` number, required
  - `overage` object, required
    - `enabled` boolean, required
    - `count` number, required
    - `rate` number, required
    - `cost` number, required
    - `cap` number, nullable, required
    - `cap_remaining` number, nullable, required

## Other responses

- `401`: Unauthorized

---

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