---
title: "Your own IC Credits spend"
method: GET
path: "/api/credits/usage"
tags: ["keys", "browser-session"]
---

# Your own IC Credits spend

`GET /api/credits/usage`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/credits/usage`
- Auth: API key in cookie `__session`

Clerk-session only (agents use ic_credits_usage). `{ ok, has_key, usage? }` where usage carries budget_usd, budget_used_usd, budget_remaining_usd, budget_period, budget_resets, by_model and default_model for the live member key; has_key:false (plus pending_request when one waits) when the member holds no live key.

## Response `200`

The member's spend.

- CreditsUsageResponse
  - `ok` boolean, required
  - `has_key` boolean, required
  - `usage` CreditsStatus: The member's IC Credits console state.
    - `has_key` boolean, required: Whether a live member key exists.
    - `token_prefix` string
    - `kind` string
    - `budget_usd` number, nullable
    - `budget_used_usd` number
    - `budget_remaining_usd` number, nullable
    - `budget_period` 'month' | 'lifetime' | 'null', nullable
    - `budget_resets` string, nullable
    - `by_model` object[]
      - `model` string
      - `provider` string
      - `tokens` integer
    - `default_model` string
    - `pending_request` object: A member request waiting for an operator, when one exists.
      - `request_id` string
      - `budget_usd` number
      - `created_at` string, date-time
  - `pending_request` object
    - `request_id` string
    - `budget_usd` number
    - `created_at` string, date-time

## Other responses

- `401`: Not signed in.

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)