---
title: "Usage Summary"
method: GET
path: "/v1/analytics/usage"
tags: ["Analytics"]
---

# Usage Summary

`GET /v1/analytics/usage`

Get daily usage summary with requests, credits consumed, and chargeable rates.

## Query parameters

- `days` integer

## Response `200`

Usage summary retrieved successfully

- object
  - `period` object
    - `start` string, date
    - `end` string, date
    - `days` integer
  - `summary` object
    - `total_requests` integer
    - `chargeable_requests` integer
    - `total_credits` number
    - `avg_credits_per_request` number
    - `chargeable_rate` number
    - `unique_products` integer
  - `daily` object[]
    - `date` string, date
    - `total_requests` integer
    - `chargeable_requests` integer
    - `total_credits` number
    - `unique_products_used` integer

## Other responses

- `400` — Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values
- `401` — Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key

## Changes

- **2026-08-25** `1f289eff3a26` — 3 breaking
  - the `allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property format changed from `uri` to `uri-reference` for status `400`
  - the `oneOf[#/components/schemas/InvalidApiKeyError]/allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property format changed from `uri` to `uri-reference` for status `401`
  - the `oneOf[#/components/schemas/MissingAuthenticationError]/allOf[#/components/schemas/ErrorResponse]/errors/items/instance` response's property format changed from `uri` to `uri-reference` for status `401`

[Change history](https://skmtc.dev/leadmagic/apis/leadmagic-api/changes/v1/analytics/usage/get.md)

---

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