Usage

Retrieve credit usage

Changed on

Retrieve your organization’s credit balance, current-period usage, and next refill.

get/org/usage

Request

  • Base URL: https://api.context.dev/v1
  • URL: https://api.context.dev/v1/org/usage
  • Auth: HTTP bearer

Response

Current credit usage

credits_remaininginteger required

Credits available to your organization right now.

request_idstring uuid required

Unique ID of this request, also in X-Request-Id. Include it when contacting support.

Example response

{
  "credits_remaining": 41250,
  "period": {
    "start": "2026-09-14T07:01:00.000Z",
    "credits_used": 8750
  },
  "next_refill": {
    "at": "2026-10-14T07:01:00.000Z",
    "credits": 50000
  },
  "auto_topup": {
    "enabled": true,
    "credits_used_this_period": 0,
    "monthly_budget_credits": 100000
  },
  "key_metadata": {
    "credits_consumed": 0,
    "credits_remaining": 41250
  },
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91"
}

Changes

  • 61627728926bRevision changes
    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

  • 4ddcf49b9fe5Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status