---
title: "Read account subscription + usage"
method: POST
path: "/api2/usage"
tags: ["Account"]
---

# Read account subscription + usage

`POST /api2/usage`

Returns the calling account's subscription tier and current-period usage.
Set `get_history=true` to also receive a per-month conversion history array.

## Request body

- UsageParameters
  - `key` string, uuid, required
  - `get_history` boolean — If true, populate the `history` array with per-month conversion counts.

## Response `200`

Account usage report.

- UsageResponse
  - `status` string — `License key active.` on success.
  - `subscription_type` string — Plan label (e.g. `Free`, `Personal`, `Business Pro`).
  - `limit` integer — Conversions allowed in the current billing period.
  - `used` integer
  - `available` integer — `max(0, limit - used)`.
  - `history` UsageHistoryEntry[] — Present only if `get_history=true`.
    - `year` integer
    - `month` integer — 1–12.
    - `conversions` integer
    - `credits` integer

## Other responses

- `401` — Unauthorized — license key invalid or expired.

---

[API](https://skmtc.dev/selectpdf/apis/selectpdf-rest-api.md) · [All operations](https://skmtc.dev/selectpdf/apis/selectpdf-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/selectpdf/selectpdf-rest-api/revisions/3e8de86ac045/schema)