API Reference
Usage API
Retrieve billing-period usage, remaining pages, and current plan limits.
GET
/usage
Retrieve usage
Returns document processing usage and page limits for the current billing period.
No request parameters.
Returns
A usage object.
Endpoint
https://api.nicedata.ai/v1/usage
Example request
curl https://api.nicedata.ai/v1/usage
-H "Authorization: Bearer nd_live_abc123..."
Example response
{
"usage": {
"current_usage": 142,
"page_limit": 2500,
"remaining_pages": 2358,
"can_upload": true,
"plan": "2500_pages",
"billing_period_start": "2026-03-01T00:00:00Z",
"billing_period_end": "2026-03-31T23:59:59Z"
}
}