GET/v1/usage

Get Usage

Check your current API usage and quota.

Check your current API usage, remaining quota, and rate limit tier. This endpoint supports both API key and session cookie authentication.

This endpoint does not count toward your monthly usage quota.

Response

Field	Type	Description
`used`	`number`	API calls used this month
`limit`	`number`	Monthly call limit for your tier
`remaining`	`number`	Calls remaining this month
`month`	`string`	Current billing month (`YYYY-MM`)
`reset_date`	`string`	ISO 8601 timestamp when the quota resets
`tier`	`string`	Your subscription tier: `"free"` or `"pro"`

Quota Details

Tier	Monthly Limit	Rate Limit
Free	1,000 calls	10 req/sec
Pro	10,000 calls	30 req/sec

Quotas reset on the 1st of each month at midnight UTC.

The following endpoints do not count toward your monthly quota: GET /v1/templates, GET /v1/usage, GET /v1/documents, GET /v1/documents/:id.

curl https://api.unmarkdown.com/v1/usage \
  -H "Authorization: Bearer um_your_key"

const res = await fetch('https://api.unmarkdown.com/v1/usage', {
  headers: {
    'Authorization': 'Bearer um_your_key'
  }
});
const data = await res.json();
console.log(`${data.remaining} calls remaining this month`);

import requests

res = requests.get(
    'https://api.unmarkdown.com/v1/usage',
    headers={'Authorization': 'Bearer um_your_key'}
)
data = res.json()
print(f"{data['remaining']} calls remaining this month")

Response

{
  "used": 142,
  "limit": 1000,
  "remaining": 858,
  "month": "2026-02",
  "reset_date": "2026-03-01T00:00:00.000Z",
  "tier": "free"
}

Pro tier response

{
  "used": 3847,
  "limit": 10000,
  "remaining": 6153,
  "month": "2026-02",
  "reset_date": "2026-03-01T00:00:00.000Z",
  "tier": "pro"
}

List Templates

Authentication