---
title: "API requests over time"
method: GET
path: "/admin/billing/stats/requests/timeseries"
tags: ["Billing"]
---

# API requests over time

`GET /admin/billing/stats/requests/timeseries`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/admin/billing/stats/requests/timeseries`
- Auth: API key in header `x-api-key`

Admin-only endpoint that returns request/charged/failed/credit counts bucketed by time across all users. Without an explicit range it defaults to the last 30 days.

## Query parameters

- `from` string
- `to` string
- `bucket` 'hour' | 'day'
- `endpoint` string
- `exclude_user_id` string

## Headers

- `x-api-key` string, required

## Response `200`

Request timeseries

- BillingAdminRequestTimeseriesResponseDoc
  - `code` integer
  - `data` BillingAdminRequestPointDoc[]
    - `bucket_end` string
    - `bucket_start` string
    - `charged_requests` integer
    - `credits` integer
    - `failed_requests` integer
    - `non_billable_requests` integer
    - `overage` integer
    - `requests` integer
  - `msg` string

## Other responses

- `400`: Invalid query parameters
- `401`: Authentication required
- `403`: Admin plan required
- `500`: Internal server error

---

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