---
title: "Get account balance and usage"
method: GET
path: "/account/usage"
tags: ["AccountUsage"]
---

# Get account balance and usage

`GET /account/usage`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/account/usage`
- Auth: API key in header `X-API-KEY`

Returns the authenticated account's current credit balance and recent
successful request usage. Calling this endpoint does not consume a credit.

## Response `200`

- object
  - `balance` integer, required
  - `credits` object, required
    - `usable` integer, required
    - `available` integer, required
    - `free_remaining` integer, required
    - `active_paid_remaining` integer, required
    - `inactive_paid_remaining` integer, required
    - `free_used_this_month` integer, required
    - `free_blocked_by_verification` boolean, required
  - `usage` object, required
    - `current_month` integer, required
    - `last_1_hour` integer, required
    - `last_24_hours` integer, required
    - `last_7_days` integer, required
  - `generated_at` string, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid

---

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