> ## Documentation Index
> Fetch the complete documentation index at: https://docs.limitguard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Usage Summary

> Return aggregated usage for the authenticated API key.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/usage/summary
openapi: 3.1.0
info:
  title: Limitguard.ai
  description: >-
    Lead validation API: the company behind each lead checked against the NL and
    BE business registers, EU VAT and sanctions lists, plus company, KYB and
    agent wallet checks for developers and AI agents
  version: 0.1.0
servers:
  - url: https://api.limitguard.ai
security: []
paths:
  /v1/usage/summary:
    get:
      summary: Get Usage Summary
      description: Return aggregated usage for the authenticated API key.
      operationId: get_usage_summary_v1_usage_summary_get
      parameters:
        - name: period
          in: query
          required: false
          schema:
            type: string
            pattern: ^(day|week|month)$
            default: day
            title: Period
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageSummary'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    UsageSummary:
      properties:
        total_calls:
          type: integer
          minimum: 0
          title: Total Calls
          description: Total API calls in period
        total_cost_usd:
          type: number
          minimum: 0
          title: Total Cost Usd
          description: Total cost in USD
        avg_latency_ms:
          type: number
          minimum: 0
          title: Avg Latency Ms
          description: Average latency in ms
        period:
          type: string
          title: Period
          description: Aggregation period (day, week, month)
        endpoint_counts:
          additionalProperties:
            type: integer
          type: object
          title: Endpoint Counts
          description: Calls per endpoint
        calls_by_status:
          additionalProperties:
            type: integer
          type: object
          title: Calls By Status
          description: Calls grouped by HTTP status code
      type: object
      required:
        - total_calls
        - total_cost_usd
        - avg_latency_ms
        - period
      title: UsageSummary
      description: Aggregated usage stats returned by /v1/usage/summary.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.