Usage Quotas

Unmarkdown™ tracks monthly API call usage per account. Each tier has a monthly quota that resets on the 1st of every month at midnight UTC.

Quotas by Tier

Tier	Monthly Quota	Price
Free	1,000 calls	$0
Pro	10,000 calls	$8/mo (annual) or$10/mo (monthly)

Which Calls Count

Most API calls count toward your monthly quota. The following endpoints are exempt and do not consume quota:

• GET /v1/templates (list templates)
• GET /v1/usage (check usage)
• GET /v1/documents (list documents)
• GET /v1/documents/:id (get a document)

Demo publish endpoints (POST /v1/demo/publish) do not require authentication and have no quota.

Checking Your Usage

Use the Get Usage endpoint to check your current consumption:

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

Response:

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

Quota Headers

Quota information is not included in standard response headers. Use the /v1/usage endpoint to check your quota status programmatically.

Exceeding the Quota

When your monthly quota is exhausted, the API returns a 429 status code:

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly API quota exceeded. Used 1000/1000. Resets 2026-03-01T00:00:00.000Z",
    "status": 429
  }
}

When this happens, you have two options:

1. Wait for reset. Quotas reset on the 1st of each month.
2. Upgrade to Pro. Increase your limit from 1,000 to 10,000 calls per month.

Best Practices

Cache responses. If you are fetching the same template list or document repeatedly, cache the result to avoid unnecessary API calls.

Use bulk endpoints. The Create and Publish endpoint creates and publishes in one call instead of two, saving one API call per document.

Monitor usage proactively. Periodically call GET /v1/usage to track consumption. Set up alerts in your application when usage exceeds 80% of the limit.