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

# Get API Usage for Specified Dates

> Retrieve API usage statistics for a specified date range



## OpenAPI

````yaml GET /usage
openapi: 3.0.1
info:
  title: Risk Score API
  description: API definition for Webacy Risk Scores
  version: 1.2.0
servers:
  - url: https://api.webacy.com
    description: Webacy Risk Score API (Production)
  - url: https://api-development.webacy.com
    description: Webacy Risk Score API (Development)
  - url: http://0.0.0.0:3030/api/v1/risk-score
    description: Webacy Risk Score API - Local
security:
  - api_key: []
tags:
  - name: Threat Risks
    description: Analyze addresses for security threats and malicious activity
  - name: Sanction Checks
    description: Check addresses against OFAC and other sanction lists
  - name: Approval Risks
    description: Analyze token approvals and associated risks
  - name: Transaction Risks
    description: Assess risk details for blockchain transactions
  - name: Exposure Risk
    description: Understand risk profile and exposure of addresses
  - name: Contract Risk
    description: Real-time smart contract security analysis
  - name: URL Risks
    description: Analyze URLs for phishing and security threats
  - name: API Usage
    description: Monitor and manage API consumption
  - name: Holder Analysis
    description: Token holder distribution and sniper detection
  - name: Address Poisoning
    description: Detect address poisoning attack patterns
  - name: Token Analysis
    description: Comprehensive token security and market analysis
  - name: Pool Analysis
    description: Liquidity pool data and analysis
  - name: Transaction Scanning
    description: Scan and simulate transactions for risks
  - name: trading-lite
    description: Lightweight trading risk assessment
  - name: RWA & Pegged Tokens
    description: >-
      Real-world asset and pegged-token analytics (supply flows, mint/burn
      velocity)
  - name: Vault Risk v3
    description: >-
      Webacy-native v3 vault risk surface — composite grade, categories,
      coverage, and the framework taxonomy (RFC-019).
  - name: RWA Risk v3
    description: >-
      Webacy-native v3 RWA / stablecoin risk surface — composite grade,
      structural-health criteria, and batch (RFC-019).
paths:
  /usage:
    get:
      tags:
        - API Usage
      summary: Get API usage for specified dates
      description: Retrieve API usage statistics for a specified date range
      operationId: getUsage
      parameters:
        - name: from
          in: query
          required: true
          schema:
            type: string
            format: date
          description: Start date for the usage data (YYYY-MM-DD format)
        - name: to
          in: query
          required: true
          schema:
            type: string
            format: date
          description: End date for the usage data (YYYY-MM-DD format)
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    description: >-
                      Per-day, per-path usage map for the requested date range,
                      plus an avgRequestsPerHour summary field.
                    properties:
                      avgRequestsPerHour:
                        type: string
                        description: Average requests per hour over the requested range.
                        example: '41.67'
                    additionalProperties:
                      type: object
                      additionalProperties:
                        $ref: '#/components/schemas/DailyUsage'
                  - type: object
                    description: >-
                      Returned when the API key had no usage in the requested
                      date range.
                    required:
                      - hasUsage
                      - usage
                      - avgRequestsPerHour
                    additionalProperties: false
                    properties:
                      hasUsage:
                        type: boolean
                        enum:
                          - false
                        description: >-
                          Always false; indicates there was no usage in the
                          requested range.
                        example: false
                      usage:
                        type: object
                        description: Empty usage map.
                        maxProperties: 0
                        additionalProperties:
                          type: object
                          additionalProperties:
                            $ref: '#/components/schemas/DailyUsage'
                      avgRequestsPerHour:
                        type: string
                        enum:
                          - '0.00'
                        description: Always "0.00" for the no-usage response.
                        example: '0.00'
        '404':
          description: Organization name not found
          content:
            application/json:
              example:
                message: Organization name not found
      security:
        - api_key: []
components:
  schemas:
    DailyUsage:
      type: object
      properties:
        usedQuota:
          type: number
          description: Used quota for the day
        remainingQuota:
          type: number
          description: Remaining quota for the day
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````