Usage & Limits

Monitor your API usage and understand the limits for your plan. Usage resets monthly on your billing cycle date.

GET

/v1/usage

Retrieve your current usage statistics and plan limits.

Headers

Header	Value
Authorization	Bearer YOUR_API_KEY

Example

curl https://api-parse.conversiontools.io/v1/usage \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "usage": {
    "pages_used": 42,
    "pages_limit": 100,
    "reset_date": "2024-02-15T00:00:00Z",
    "plan": "free"
  }
}

Response Fields

Field	Type	Description
pages_used	Number	Pages processed in the current billing period
pages_limit	Number	Maximum pages allowed per billing period
reset_date	String	ISO 8601 date when usage resets
plan	String	Current plan name ("free" or "pro")

Plan Limits

Plan	Pages / Month	Max File Size	Schemas
Free	100	10 MB	3
Pro	2,500	50 MB	Unlimited

Rate Limiting

When you exceed your monthly page limit, API requests will return a 429 Too Many Requests response. Usage resets automatically on your monthly billing cycle date.

429 Rate Limited

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Monthly page limit exceeded",
    "limit": 100,
    "used": 100,
    "reset_date": "2024-02-15T00:00:00Z"
  }
}

Need more pages?

Upgrade to the Pro plan for 2,500 pages per month, larger file size limits, and unlimited schemas. Upgrade now