---
title: "Get account usage"
method: GET
path: "/v1/account/usage"
---

# Get account usage

`GET /v1/account/usage`

## Request

- Base URL: `https://api.roveapi.com`
- URL: `https://api.roveapi.com/v1/account/usage`
- Auth: HTTP bearer

## Response `200`

Successful response

- object
  - `api_key` string, required: Deprecated: the masked key prefix (rvp_live_… or rvp_test_…), never the token. To be removed in a future major version.
  - `plan` string, required
  - `credits_total` number, required
  - `credits_used` number, required
  - `credits_remaining` number, required
  - `credits_total_millicredits` integer, required: Exact credits_total in millicredits (1 credit = 1,000); equals used + remaining exactly.
  - `credits_used_millicredits` integer, required: Exact credits_used in millicredits.
  - `credits_remaining_millicredits` integer, required: Exact balance in millicredits; credits_remaining is its floor in whole credits.
  - `current_period_actions` object, required
    - `sessions` integer, required
    - `navigations` integer, required
    - `interactions` integer, required
    - `screenshots` integer, required
    - `extractions` integer, required
  - `credits_expire` string, nullable, required

## Other responses

- `401`: RFC 7807 authentication problem
- `409`: RFC 7807 state/control problem
- `410`: RFC 7807 expired or replayed admission problem

---

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