---
title: "Get usage summary"
method: GET
path: "/api/v1/usage/summary"
tags: ["Usage Statistics"]
---

# Get usage summary

`GET /api/v1/usage/summary`

Retrieves aggregated summary statistics for your API key within a specified date range.
            Returns totals and averages without hourly breakdown, useful for dashboard overview.

            **Authorization:** Requires valid API key.

            **Example usage:**
            ```
            GET /api/v1/usage/summary?api_key=YOUR_KEY&start_date=2025-11-01T00:00:00Z&end_date=2025-11-04T00:00:00Z
            ```

## Query parameters

- `api_key` string, required
- `start_date` string, date-time, required
- `end_date` string, date-time, required
- `api_type` 'IP' | 'ADVANCED_EMAIL_VALIDATION'

## Response `200`

Successfully retrieved usage summary

- ApiUsageSummary
  - `apiKey` string, required
  - `apiType` string, required
  - `periodStart` string, date-time, required
  - `periodEnd` string, date-time, required
  - `totalRequests` integer, required
  - `successfulRequests` integer, required
  - `rateLimitedRequests` integer, required
  - `quotaConsumed` integer, required
  - `batchOperations` integer, required
  - `avgRequestDurationMs` number, double, nullable

## Other responses

- `401` — Invalid or missing API key
- `404` — No usage data found for this period

---

[API](https://skmtc.dev/ip-api/apis/ip-api-io-ip-geolocation-security-api.md) · [All operations](https://skmtc.dev/ip-api/apis/ip-api-io-ip-geolocation-security-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ip-api/ip-api-io-ip-geolocation-security-api/revisions/a6862f586bf3/schema)