---
title: "Usage (fair-use progress)"
method: GET
path: "/api/v2/usage"
tags: ["v2 Account"]
---

# Usage (fair-use progress)

`GET /api/v2/usage`

## Request

- Base URL: `https://pdf2md.dev`
- URL: `https://pdf2md.dev/api/v2/usage`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `p2m_session`

## Response `200`

Usage

- V2Usage: EP-023-T9: monthly fair-use + durable counters (usage_ledger).
  - `period_start` string, date
  - `pages` integer
  - `jobs` integer
  - `upload_bytes` integer
  - `download_count` integer
  - `mcp_calls` integer
  - `slots_in_use` integer
  - `max_active_slots` integer
  - `monthly_pages_soft_limit` integer, nullable: EP-069: soft on subscription tiers, HARD on anonymous/free/lifetime
  - `monthly_pages_pct` integer: % of soft limit
  - `warned` boolean: true at ≥80% (§5)
  - `over_fair_use` boolean: soft-degraded to free pool/band this cycle (≥100%)

## Other responses

- `401`: Missing/invalid API key or session

---

[API](https://skmtc.dev/pdf2md/apis/pdf-to-markdown-api-facade.md) · [All operations](https://skmtc.dev/pdf2md/apis/pdf-to-markdown-api-facade/llms.txt) · [OpenAPI document](https://skmtc.dev/pdf2md/apis/pdf-to-markdown-api-facade/revisions/4636782fb8b6?raw)