---
title: "The account's recorded API calls and error rates by operation."
method: GET
path: "/v1/usage/requests"
tags: ["account"]
---

# The account's recorded API calls and error rates by operation.

`GET /v1/usage/requests`

## Request

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

Authenticated API answers only, grouped by operation across hourly buckets. The current hour is partial; counts are written about once a minute. Calls are exact decimal strings; clientErrors counts 4xx, serverErrors counts 5xx, errorPercent counts both and is null when no calls were recorded. The read checks the current key's usage permission and returns only its organization's counts.

## Query parameters

- `range` '24h' | '7d' | '30d' | '90d'

## Response `200`

Success

- object
  - `range` '24h' | '7d' | '30d' | '90d', required
  - `since` string, required
  - `until` string, required
  - `calls` string, required: Exact integer count, as a decimal string.
  - `clientErrors` string, required: Exact integer count, as a decimal string.
  - `serverErrors` string, required: Exact integer count, as a decimal string.
  - `errorPercent` number, nullable, required: Share of recorded authenticated answers with status 400 or above; null with no calls.
  - `operations` object[], required
    - `operation` string, required
    - `calls` string, required: Exact integer count, as a decimal string.
    - `clientErrors` string, required: Exact integer count, as a decimal string.
    - `serverErrors` string, required: Exact integer count, as a decimal string.
    - `errorPercent` number, nullable, required: Share of answers with status 400 or above; null with no calls.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/6f4012286988?raw)