---
title: "Current credit balance + recent requests"
method: GET
path: "/v1/account/usage"
tags: ["Account"]
---

# Current credit balance + recent requests

`GET /v1/account/usage`

## Request

- Base URL: `https://api.captapi.com`
- URL: `https://api.captapi.com/v1/account/usage`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Your live credit balance plus your most recent requests (endpoint, credits used, cache hit, status code, response time), newest first. limit sets how many requests to return. Free.

## Query parameters

- `limit` integer

## Response `200`

Success.

- object
  - `success` unknown, required
  - `data` object, required
    - `balance` object
      - `plan` string
      - `monthlyQuota` integer
      - `subscriptionCredits` integer
      - `topupCredits` integer
      - `totalCredits` integer
      - `subscriptionRenewsAt` string
      - `usedThisMonth` integer
      - `quotaResetsAt` string
      - `keyName` string
      - `rateLimitPerMinute` integer
      - `rateLimitRemaining` integer
    - `recentRequests` object[]
      - `requestId` string
      - `endpoint` string
      - `platform` string
      - `resource` string
      - `resourceUrl` string
      - `creditsUsed` integer
      - `cacheHit` boolean
      - `statusCode` integer
      - `responseTimeMs` integer
      - `createdAt` string

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.

---

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