DevPass Usage API

Read DevPass monthly, daily and weekly usage limits from an application using its gateway API key

Plan changes from October 15, 2026

DevPass subscription prices stay the same, but included usage decreases. Daily and premium weekly caps and Reset Pass benefits change on October 15; existing monthly allowances change at the first renewal on or after that date. New subscriptions from that date start with the new allowance. Review the dated plan-change notice before subscribing.

Use GET /v1/key to show DevPass allowance meters in a coding tool or other trusted application. The endpoint uses the application's existing gateway API key, so it does not require a dashboard session.

A regular gateway API key is a secret. Do not embed it in public browser code or distribute it with an application. Read it from the user's secure local configuration or call the endpoint from a trusted backend.

Request

curl https://api.llmgateway.io/v1/key \
  -H "Authorization: Bearer llmgtwy_your_api_key_here"

Only regular gateway API keys can use this endpoint. Platform publishable keys and end-user sessions receive 403 Forbidden because they cannot read organization-level plan state.

Response

{
	"data": {
		"label": "My coding tool",
		"usage": "31.42",
		"limit": null,
		"devPlan": "pro",
		"devPlanCreditsUsed": "25",
		"devPlanCreditsLimit": "158",
		"devPlanCreditsRemaining": "133.00",
		"devPlanDailyLimit": "14.22",
		"devPlanDailyCreditsUsed": "3.10",
		"devPlanDayResetsAt": "2026-08-22T09:30:00.000Z",
		"devPlanPremiumWeeklyLimit": "18.96",
		"devPlanPremiumCreditsUsed": "5.00",
		"devPlanPremiumWeekResetsAt": "2026-08-28T12:00:00.000Z"
	}
}

Field	Meaning
`label`	Description of the key
`usage`	All-time usage attributed to the key, in USD
`limit`	All-time key usage limit in USD, or `null`
`devPlan`	`lite`, `pro`, `max`, or `none`
`devPlanCreditsUsed`	Plan credits used in the current billing cycle
`devPlanCreditsLimit`	Plan credit allowance for the current billing cycle
`devPlanCreditsRemaining`	Remaining plan credits, clamped to zero
`devPlanDailyLimit`	Daily pacing allowance — plan credits usable per rolling 24h
`devPlanDailyCreditsUsed`	Plan credits used in the current 24-hour window
`devPlanDayResetsAt`	ISO 8601 reset time, or `null` when no daily window is active
`devPlanPremiumWeeklyLimit`	Weekly premium-model allowance
`devPlanPremiumCreditsUsed`	Premium-model credits used in the current weekly window
`devPlanPremiumWeekResetsAt`	ISO 8601 reset time, or `null` when no weekly window is active

All USD values are decimal strings. Parse them before calculating percentages or remaining allowances.

Daily window behavior

The pacing window starts with the first request that draws on the plan allowance and lasts 24 hours; it covers every model. When it expires, the endpoint returns "0.00" for devPlanDailyCreditsUsed and null for devPlanDayResetsAt; the full daily share is available again, and the next request starts a new window.

Weekly window behavior

The premium window starts with the first premium-model request and lasts seven days. When it expires, the endpoint returns "0.00" for devPlanPremiumCreditsUsed and null for devPlanPremiumWeekResetsAt; the full weekly allowance is already available, and the next premium request starts a new window.

Pay-as-you-go keys return "none" for devPlan and zero for every DevPass field. This lets one integration support both key types without a separate account lookup.

The endpoint remains readable when the key has exceeded its own usage limit, so an integration can explain why requests stopped. Invalid or inactive keys receive 401 Unauthorized.

See Retrieve key status for the generated API reference and complete response schema.

Recovering a failed renewal

If your renewal fails, DevPass shows Payment overdue with a Complete payment link to the outstanding invoice. Follow the link to pay and complete any bank verification. Your allowance refreshes after payment succeeds.

Updating your card in Billing also retries the failed renewal. Saving a card alone does not mean the invoice is paid: if payment remains outstanding, the invoice link stays visible above the card details. Return to DevPass after paying to refresh the payment status.