Usage Statistics

View your API usage for the current or past months.

GET /v1/usage

Query Parameters

Parameter	Type	Default	Description
period	string	current_month	current_month, last_month, or YYYY-MM (e.g., 2025-02)

Response

{
  "period": "2025-02",
  "requests": 142,
  "pages_processed": 847,
  "ocr_tokens": 125000,
  "structuring_tokens": 89000,
  "pdfs_filled": 12,
  "excels_filled": 8,
  "daily_breakdown": [
    {
      "date": "2025-02-01",
      "requests": 5,
      "pages": 23
    },
    {
      "date": "2025-02-02",
      "requests": 8,
      "pages": 45
    }
  ]
}

Response Fields

Field	Type	Description
period	string	The month being reported (YYYY-MM)
requests	number	Total API requests made
pages_processed	number	Total document pages processed
ocr_tokens	number	OCR tokens consumed
structuring_tokens	number	AI structuring tokens consumed
pdfs_filled	number	PDF forms filled
excels_filled	number	Excel templates filled
daily_breakdown	array	Per-day breakdown of requests and pages

Examples

# Current month
curl "https://developer-api.qomplement.com/v1/usage" \
  -H "Authorization: Bearer sd_YOUR_API_KEY"

# Specific month
curl "https://developer-api.qomplement.com/v1/usage?period=2025-01" \
  -H "Authorization: Bearer sd_YOUR_API_KEY"