Skip to content
OG Engine logoOG Engine

GET /usage

Returns the current quota usage for your API key. This endpoint does not count as a render — calling it will never consume quota.

GET https://og-engine.com/usage

Authentication: Required (Authorization: Bearer oge_sk_...)

Example Request

Section titled “Example Request”
Terminal window
curl https://og-engine.com/usage \
  -H "Authorization: Bearer oge_sk_YOUR_KEY"

Response

Section titled “Response”
{
  "plan": "free",
  "limit": 500,
  "used": 142,
  "remaining": 358,
  "resetAt": "2026-05-01T00:00:00Z"
}

Response Fields

Section titled “Response Fields”
Field Type Description
plan string Current plan: free, starter, pro, or scale
limit number Total monthly render quota
used number Renders consumed this billing cycle
remaining number Renders remaining (limit - used)
resetAt string ISO 8601 timestamp of next quota reset

For paid plans, resetAt is the next billing cycle anniversary. For the free plan, it is the 1st of the next month at 00:00 UTC.

Error Responses

Section titled “Error Responses”
Status Code Cause
401 unauthorized Missing or invalid API key

SDK Example

Section titled “SDK Example”
const { plan, used, remaining, resetAt } = await og.usage()


console.log(`Plan: ${plan}`)
console.log(`Used: ${used} / ${used + remaining} renders`)
console.log(`Resets: ${new Date(resetAt).toLocaleDateString()}`)

Next Steps

Section titled “Next Steps”