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,
"plan": "free",
"pages_used": 42,
"pages_limit": 100,
"pages_remaining": 58,
"reset_date": "2024-02-01T00:00:00.000Z"
}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 | 5,000 | 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
{
"error": "Monthly page limit exceeded",
"code": "LIMIT_REACHED",
"message": "You've reached your monthly page limit (100 pages).",
"remedy": { "text": "View plans and upgrade", "path": "/pricing" }
}Need more pages?
Upgrade to the Pro plan for 5,000 pages per month, larger file size limits, and unlimited schemas. Upgrade now