Usage & Quota

Check your current usage and remaining quota for the billing period.

GET/v1/usage

Returns current billing period usage and plan limits

Request

Requires authentication with a live API key.

cURL

curl https://api.statementparse.dev/v1/usage \
  -H "Authorization: Bearer sp_live_your_key_here"

Response

200 OK

{
  "plan": "starter",
  "statements_used": 142,
  "statements_limit": 500,
  "pages_processed": 856,
  "period_start": "2025-03-01",
  "period_end": "2025-04-01"
}

Response Fields

Parameter	Type	Description
`plan`	string	Current plan: "free", "starter", "growth", or "scale"
`statements_used`	integer	Statements parsed this billing period
`statements_limit`	integer	Maximum statements allowed per period
`pages_processed`	integer	Total PDF pages processed this period
`period_start`	string	Start of current billing period (ISO 8601)
`period_end`	string	End of current billing period (ISO 8601)

Billing periods

Billing periods run from the 1st to the last day of each month (UTC). Usage resets automatically on the 1st.

Plan Limits

Plan	Statements/mo	Rate Limit	Price
Free	50	10/min	$0
Starter	500	100/min	$49/mo
Growth	3,000	100/min	$199/mo
Scale	10,000	200/min	$499/mo