Traces API

Traces record leaderboard runs, inference requests, dataset events, and manual events.

export API_BASE="https://dr-gero-frontend-99142474693.europe-west1.run.app"
export DRGERO_TOKEN="drgero_REPLACE_WITH_TOKEN_FROM_SETTINGS"
export LEADERBOARD_ID="b60fe691-06a3-4261-bec3-6080380dc72d"

Export traces as JSON

curl -sS "$API_BASE/v1/leaderboard/$LEADERBOARD_ID/traces?limit=100&format=json" \
  -H "Authorization: Bearer $DRGERO_TOKEN" | jq

Export inference traces only

curl -sS "$API_BASE/v1/leaderboard/$LEADERBOARD_ID/traces?limit=100&format=json&source=inference" \
  -H "Authorization: Bearer $DRGERO_TOKEN" | jq

Export as JSONL

curl -sS "$API_BASE/v1/leaderboard/$LEADERBOARD_ID/traces?limit=100&format=jsonl" \
  -H "Authorization: Bearer $DRGERO_TOKEN" > traces.jsonl

Query parameters

Parameter	Default	Description
limit	100	Number of trace rows to return. Maximum is 1000.
offset	0	Pagination offset.
source	all	Filter by run, inference, dataset, or manual.
run_id	none	Filter by a specific leaderboard run.
format	jsonl	json, jsonl, or ndjson.
batch_limit	25	Number of trace batches to scan. Maximum is 100.

JSON response shape

{
  "leaderboard_id": "b60fe691-06a3-4261-bec3-6080380dc72d",
  "traces_url": "https://dr-gero-frontend-99142474693.europe-west1.run.app/api/leaderboards/.../traces",
  "count": 100,
  "limit": 100,
  "offset": 0,
  "batch_count": 4,
  "scanned_rows": 284,
  "rows": []
}

Auth

• Dr.Gero API token with leaderboards:read.
• Supabase user session when used by the signed-in app.

Trace access can also be gated by plan/entitlement.