GET
/
api
/
v2
/
keys
/
{key_id}
/
stats
curl -X GET \
  "https://api.buena.ai/api/v2/keys/key_123/stats?period=7d&granularity=day" \
  -H "x-api-key: YOUR_API_KEY"

{
  "key_id": "key_123",
  "period": "7d",
  "total_requests": 1250,
  "successful_requests": 1180,
  "failed_requests": 70,
  "usage_by_endpoint": {
    "/api/v2/leads": 450,
    "/api/v2/enrich": 380,
    "/api/v2/linkedin": 420
  },
  "daily_usage": [
    {
      "date": "2024-01-01",
      "requests": 180,
      "successful": 175,
      "failed": 5
    }
  ]
}

Retrieves usage statistics and analytics for a specific API key.

​
Path Parameters

​
key_id
string
required

The unique identifier of the API key

​
Query Parameters

​
period
string
default:"30d"

The time period for statistics. Options: 24h, 7d, 30d, 90d

​
granularity
string
default:"day"

The granularity of the data. Options: hour, day, week

​
Response

​
key_id
string

The unique identifier of the API key

​
period
string

The time period of the statistics

​
total_requests
number

Total number of requests made with this key

​
successful_requests
number

Number of successful requests (2xx status codes)

​
failed_requests
number

Number of failed requests (4xx and 5xx status codes)

​
usage_by_endpoint
object

Breakdown of usage by API endpoint

​
daily_usage
array

Array of daily usage statistics

curl -X GET \
  "https://api.buena.ai/api/v2/keys/key_123/stats?period=7d&granularity=day" \
  -H "x-api-key: YOUR_API_KEY"

{
  "key_id": "key_123",
  "period": "7d",
  "total_requests": 1250,
  "successful_requests": 1180,
  "failed_requests": 70,
  "usage_by_endpoint": {
    "/api/v2/leads": 450,
    "/api/v2/enrich": 380,
    "/api/v2/linkedin": 420
  },
  "daily_usage": [
    {
      "date": "2024-01-01",
      "requests": 180,
      "successful": 175,
      "failed": 5
    }
  ]
}