---
title: "Get AI credit usage"
method: GET
path: "/ai/usage"
tags: ["AI Intelligence"]
---

# Get AI credit usage

`GET /ai/usage`

## Request

- Base URL: `https://app.arkova.ai/api/v1`
- URL: `https://app.arkova.ai/api/v1/ai/usage`
- Auth: HTTP bearer

Returns AI credit balance and recent usage events for the authenticated user.

## Response `200`

AI credit balance and usage history

- AIUsageResponse
  - `balance` integer: Remaining AI credits
  - `used` integer: Credits used this month
  - `limit` union
    - integer
    - 'unlimited'
  - `recentEvents` object[]
    - `event_type` string
    - `credits_used` integer
    - `created_at` string, date-time

## Other responses

- `401`: Authentication required

---

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