---
title: "Retrieve usage data for a specific time range"
method: GET
path: "/v1/account/usage/"
tags: ["Account"]
---

# Retrieve usage data for a specific time range

`GET /v1/account/usage/`

Retrieve API usage data for a specified date range.

Returns daily usage statistics including request counts for each day
within the specified time period. The response includes both individual
daily usage data and total usage for the entire period.

- The request count is total number of requests made including 2xx, 4xx
and 5xx responses. It is not the same as billable requests which is not
available right now as part of API.
- Maximum date range allowed: 90 days
- Dates are in UTC format
- Current day data when requested will be updated during the day
- Usage data is updated approximately every 30 minutes
- Usage data is returned only from the first date of actual usage in
the specified duration

## Query parameters

- `start_date` string, date, required — Start date of the duration to get usage data for. Format: YYYY-MM-DD
- `end_date` string, date, required — End date of the duration to get usage data for. Format: YYYY-MM-DD

## Response `200`

Usage data retrieved successfully

- UsageResponseDto — Response model for the usage endpoint.
  - `time_range` TimeRange, required — Time range object for the usage data.
    - `start_date` string, date, required — Start date of input duration range
    - `end_date` string, date, required — End date of input duration range
  - `usage_data` UsageData[], required — List of usage data for each day in the input duration range
    - `date` string, date, required — Date of the usage data
    - `request_count` integer, required — Request count for the usage date
  - `total_requests_in_timeperiod` integer, required — Total requests in the input duration range

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.dev/whitepages/apis/whitepages-api-reference.md) · [All operations](https://skmtc.dev/whitepages/apis/whitepages-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whitepages/whitepages-api-reference/revisions/c27a0cd8718f/schema)