---
title: "Retrieve credit usage"
method: GET
path: "/org/usage"
tags: ["Usage"]
---

# Retrieve credit usage

`GET /org/usage`

## Request

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

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

## Response `200`

Current credit usage

- OrgUsageResponse
  - `credits_remaining` integer, required: Credits available to your organization right now.
  - `period` object, nullable, required: The current monthly credit period, or null when your organization has no monthly credits or billing is paused.
    - `start` string, date-time, required: When the current credit period started.
    - `credits_used` integer, required: Credits charged since `start`.
  - `next_refill` object, nullable, required: The next monthly refill, or null when no refill is scheduled. While billing is paused, this is when billing resumes.
    - `at` string, date-time, required: When your credits next refill.
    - `credits` integer, required: Your balance is reset to this amount at the refill. Unused credits do not carry over.
  - `auto_topup` object, required: Auto-Topup settings and spend.
    - `enabled` boolean, required: Whether credits are added automatically when your balance runs out.
    - `credits_used_this_period` integer, required: Credits added by Auto-Topup in the current period.
    - `monthly_budget_credits` integer, nullable, required: Monthly Auto-Topup budget you are alerted against, or null when none is set.
  - `key_metadata` KeyMetadata: Credits this request used and your remaining balance.
    - `credits_consumed` integer, required: Credits charged for this request.
    - `credits_remaining` integer, required: Credits remaining for your organization.
  - `request_id` string, uuid, required: Unique ID of this request, also in `X-Request-Id`. Include it when contacting support.

## Other responses

- `401`: Unauthorized
- `429`: Rate limit exceeded (60 requests per minute per organization).
- `500`: Usage data is temporarily unavailable.

## Changes

- **2026-10-21** `61627728926b`: 3 warning
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `401`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `429`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `500`
- **2026-10-19** `4ddcf49b9fe5`: 3 info
  - added the optional property `error_data` to the response with the `401` status
  - added the optional property `error_data` to the response with the `429` status
  - added the optional property `error_data` to the response with the `500` status
- **2026-10-16** `2125f3e94e52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/context/apis/brand-api/changes/org/usage/get.md)

---

[API](https://skmtc.dev/context/apis/brand-api.md) · [All operations](https://skmtc.dev/context/apis/brand-api/llms.txt) · [OpenAPI document](https://skmtc.dev/context/apis/brand-api/revisions/9e2ab7841fb1?raw)