v1

latestOpenAPI 3.1.0Commercial License2026-07-132434129.1 KB

Usage Statistics

Get detailed usage statistics

        Retrieves hourly aggregated usage statistics for your API key within a specified date range.
        Returns detailed breakdown of requests, quota consumption, and performance metrics.

        **Authorization:** Requires valid API key.

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

get/api/v1/usage/stats

Query parameters

api_keystring required

Your API key

start_datestring date-time required

Start date in ISO 8601 format (inclusive)

end_datestring date-time required

End date in ISO 8601 format (exclusive)

api_type'IP' | 'ADVANCED_EMAIL_VALIDATION'

Filter by API type (optional)

Response

Successfully retrieved usage statistics

idinteger nullable

apiKeystring required

planIdstring required

apiTypestring required

authTypestring required

hourBucketstring date-time required

totalRequestsinteger required

successfulRequestsinteger required

rateLimitedRequestsinteger required

quotaConsumedinteger required

peakRemainingQuotainteger nullable

minRemainingQuotainteger nullable

batchOperationsinteger required

batchTokensConsumedinteger required

avgRequestDurationNanosinteger nullable

createdAtstring date-time nullable

updatedAtstring date-time nullable