---
title: "Current billing tier and usage against its limits"
method: GET
path: "/v1/usage"
tags: ["Billing"]
---

# Current billing tier and usage against its limits

`GET /v1/usage`

## Request

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

## Response `200`

OK

- Usage
  - `tier` 'free' | 'starter' | 'pro' | 'enterprise'
  - `limits` object
    - `label` string
    - `domains` integer, nullable: null represents unlimited (enterprise)
    - `emailsPerMonth` integer, nullable
    - `storageBytes` integer, nullable: one pool for the whole account; null = unlimited
    - `maxTeamMembers` integer, nullable: included team logins (extra seats are a $2/mo add-on); null = unlimited
  - `domainCount` integer
  - `emailsThisMonth` integer
  - `storageBytes` integer: the account's stored mail on disk - what limits.storageBytes is enforced against
  - `storageByDomain` object[]
    - `domain_id` string, uuid
    - `domain` string
    - `bytes` string: Numeric string (bigint)

## Changes

- **2026-10-20** `e394b91cbc53`: 1 warning, 2 info
  - removed the optional property `limits/storageBytesPerDomain` from the response with the `200` status
  - added the optional property `limits/storageBytes` to the response with the `200` status
  - added the optional property `storageBytes` to the response with the `200` status

[Operation history](https://skmtc.dev/usemektup/apis/mektup-api/changes/v1/usage/get.md)

---

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