POST
/
api
/
scorecard
/
close
Close scorecard
curl --request POST \
  --url https://three.arcprize.org/api/scorecard/close \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "card_id": "8bb3b1b8-4b46-4a29-a13b-ad7850a0f916"
}'
{
  "card_id": "8bb3b1b8-4b46-4a29-a13b-ad7850a0f916",
  "won": 3,
  "played": 5,
  "total_actions": 1742,
  "score": 12,
  "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": {
    "ls20-016295f7601e": {
      "game_id": "ls20-016295f7601e",
      "total_plays": 2,
      "total_actions": 148,
      "scores": [
        2,
        3
      ],
      "states": [
        "NOT_FINISHED",
        "WIN"
      ],
      "actions": [
        33,
        115
      ]
    }
  }
}

Authorizations

X-API-Key
string
header
required

Body

application/json

Identifier of the scorecard to close.

Payload for closing a previously opened scorecard and finalising its aggregated results.

card_id
string
required

Identifier of the scorecard to close—use the card_id returned by OpenScorecardResponse.

Response

scorecard closed; final aggregate results 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.