GET
/
api
/
scorecard
/
{card_id}
Retrieve scorecard
curl --request GET \
  --url https://three.arcprize.org/api/scorecard/{card_id} \
  --header 'X-API-Key: <api-key>'
{
  "card_id": "8bb3b1b8-4b46-4a29-a13b-ad7850a0f916",
  "won": 3,
  "played": 5,
  "total_actions": 142,
  "score": 612,
  "source_url": "https://github.com/example/agent",
  "tags": [
    "baseline",
    "gpt-4o"
  ],
  "opaque": {
    "model": "gpt-4o",
    "temperature": 0.25
  },
  "api_key": "YOUR-API-KEY-ID",
  "cards": {
    "…": null
  }
}

Authorizations

X-API-Key
string
header
required

Path Parameters

card_id
string
required

Identifier returned by /scorecard/open.

Response

scorecard found; summary returned.

Aggregate results for an entire scorecard run.
Includes cumulative counters, optional metadata echoed back from the open request, the API key that authenticated the run, and a per-game breakdown in cards.

api_key
string
required

The API key that initiated and authenticated this run.

card_id
string
required

The Scorecard ID that was returned by returned by OpenScorecardResponse.

won
integer
required

Total number of games won in this scorecard.

played
integer
required

Total number of games played (wins + losses + unfinished).

total_actions
integer
required

Cumulative number of actions taken across all plays.

score
integer
required

Sum of per-game scores (each 0-254) for this scorecard.

cards
object
required

Map keyed by game_id, each entry summarising a single game.

source_url
string<uri>

Link originally supplied in the OpenScorecardRequest.

tags
string[]

Arbitrary labels echoed back from the open request.

opaque
object

Free-form JSON blob (≤ 16 KB) exactly as provided when the scorecard was opened. Absent if none was supplied.