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 | 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
{
"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 5,000 pages per month, larger file size limits, and unlimited schemas. Upgrade now