List Scores

List scores with optional filters.

List Scores

List annotation scores across your organization with optional filters. Results are paginated.

GET https://api.futureagi.com/model-hub/scores/
Bearer 
          Click "Try It" to send a request

Authentication

All requests require authentication via API keys:

HeaderDescription
X-Api-KeyYour API key
X-Secret-KeyYour secret key

Query Parameters

source_type string

Filter by source type. One of trace, span, generation, or session.

source_id string

Filter by a specific source UUID.

label_id string

Filter by a specific label UUID.

annotator_id string

Filter by a specific annotator UUID.

page integer

Page number for pagination.

page_size integer

Number of results per page.

Response

Returns a paginated response:

count integer
Total number of matching scores.
next string
URL for the next page, or null.
previous string
URL for the previous page, or null.
results array
Array of Score objects. Each contains id, source_type, source_id, label_id, label_name, label_type, value, score_source, notes, annotator, annotator_name, annotator_email, queue_item, created_at, and updated_at.

Code Examples

import requests

url = "https://api.futureagi.com/model-hub/scores/"
headers = {
    "X-Api-Key": "YOUR_API_KEY",
    "X-Secret-Key": "YOUR_SECRET_KEY",
}

params = {
    "source_type": "trace",
    "label_id": "your-label-uuid",
    "page": 1,
    "page_size": 50,
}

response = requests.get(url, params=params, headers=headers)
data = response.json()

print(f"Total scores: {data['count']}")
for score in data["results"]:
    print(f"{score['label_name']}: {score['value']}")
const params = new URLSearchParams({
  sourceType: "trace",
  labelId: "your-label-uuid",
  page: "1",
  pageSize: "50",
});

const response = await fetch(
  `https://api.futureagi.com/model-hub/scores/?${params}`,
  {
    headers: {
      "X-Api-Key": "YOUR_API_KEY",
      "X-Secret-Key": "YOUR_SECRET_KEY",
    },
  }
);

const data = await response.json();
console.log(`Total scores: ${data.count}`);
data.results.forEach((score: any) => {
  console.log(`${score.labelName}: ${JSON.stringify(score.value)}`);
});
curl -G "https://api.futureagi.com/model-hub/scores/" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "X-Secret-Key: YOUR_SECRET_KEY" \
  --data-urlencode "source_type=trace" \
  --data-urlencode "label_id=your-label-uuid" \
  --data-urlencode "page=1" \
  --data-urlencode "page_size=50"
Was this page helpful?

Questions & Discussion