---
title: "Get usage"
method: GET
path: "/usage"
tags: ["Account"]
---

# Get usage

`GET /usage`

## Request

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

Request counts (with the error split) and credits spent, for the whole account and for this key's app, for building your own dashboard or a spend alarm.

## Query parameters

- `days` integer

## Response `200`

Get usage

- object
  - `window` object: `{ days, since }`.
  - `account` object: `{ credits, requests, errors, successes, byAction, balance }` for every credential on the account. `credits` is net of refunds.
  - `app` object: The same counts for this key's app (or this key, when it has no app), with `appId` and `keyId`.

## Other responses

- `400`: `invalid_request`: `days` is not a positive number.

---

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