Skip to content
Last updated

Compare your organization's usage metrics against industry benchmarks and similar organizations.

GEThttps://api.aitronos.com/v1/analytics/usage/benchmarks/{org_id}

Path Parameters

org_id string required

The organization ID.

Query Parameters

metric string optional

Metric type to analyze: neurons, synapses, or omit for combined metrics. Default: combined (null).

month integer required

Month for benchmark comparison (1-12).

year integer required

Year for benchmark comparison.

Returns

Returns benchmark comparison data showing how your usage compares to similar organizations.

Bash
curl "https://api.aitronos.com/v1/analytics/usage/benchmarks/org_abc123?metric=neurons" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

200 OK
{
  "organization_id": "org_abc123",
  "metric": "neurons",
  "benchmarks": {
    "your_usage": 15000,
    "industry_average": 12000,
    "top_quartile": 20000,
    "period": "2025-11"
  },
  "comparisons": {
    "vs_average": "+25%",
    "vs_top_quartile": "-25%",
    "percentile": 72
  },
  "rankings": {
    "overall_rank": "above_average",
    "category": "mid-tier"
  }
}