Usage Quotas

Every Unmarkdown account has a monthly API call quota that limits the total number of API requests you can make in a billing period. Quotas are separate from rate limits: rate limits control how fast you can make requests, while quotas control how many total requests you can make per month.

• Free plan: 1,000 API calls per month (hard wall)
• Pro plan: 10,000 API calls per month

The following endpoints do not count toward your monthly quota:

• GET /v1/documents (list your documents)
• GET /v1/documents/:id (get a single document)
• GET /v1/templates (list available templates)
• GET /v1/usage (check your quota status)

All other endpoints (convert, create, update, delete, publish, unpublish) count as one API call per request.

Check your current usage at any time by calling the usage endpoint:

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

{
  "limit": 10000,
  "used": 3472,
  "remaining": 6528,
  "resets_at": "2026-03-01T00:00:00Z"
}

The usage count is updated in near real time. There may be a short delay of a few seconds between making a request and seeing it reflected in the usage endpoint.

Monthly quotas reset on the first day of each calendar month at midnight UTC. Unused calls do not roll over to the next month. On the reset date, your usage counter returns to zero.

When you exceed your monthly quota, the API returns a 429 Too Many Requests response with the quota_exceeded error code:

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly API quota exceeded. Resets on 2026-03-01.",
    "status": 429
  }
}

Requests that exceed the quota are rejected but are not counted against your usage. Free plan quotas are a hard wall with no overage option.

If you reach your monthly quota:

• Wait for the monthly reset on the 1st of the next month
• Upgrade to Pro for 10x the quota (1,000 to 10,000 calls/month)
• Use exempt endpoints (GET /documents, GET /templates, GET /usage) which do not count
• Optimize your integration to make fewer calls (batch operations, caching)