Skip to main content
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": "8ae52f21-b40c-457b-9f4e-65bd8381e67f",
  "score": 100,
  "source_url": "https://sandbox.internal.arc-prize.com",
  "tags": [
    "human"
  ],
  "user_name": "distracted_poincare",
  "user_id": "102214435702678430912@google",
  "published_at": "2026-01-26T23:34:57.097896Z",
  "environments": [
    {
      "id": "am92-80effacb",
      "runs": [
        {
          "id": "am92-80effacb",
          "guid": "4a38a278-796b-4f42-a28b-a27a68dbf862",
          "score": 100,
          "levels_completed": 5,
          "actions": 136,
          "resets": 0,
          "state": "WIN",
          "completed": true,
          "level_scores": [
            100,
            100,
            100,
            100,
            100
          ],
          "level_actions": [
            12,
            34,
            41,
            26,
            23
          ],
          "level_baseline_actions": [
            20,
            40,
            50,
            55,
            60
          ],
          "number_of_levels": 0,
          "number_of_environments": 0
        }
      ],
      "score": 100,
      "actions": 136,
      "levels_completed": 5,
      "completed": true,
      "level_count": 5,
      "resets": 0
    }
  ],
  "tags_scores": [
    {
      "id": "change9",
      "guid": "d3a0a4d8-536c-479d-b5a8-10bf1dc8aee3",
      "score": 100,
      "levels_completed": 5,
      "actions": 136,
      "resets": 0,
      "state": "NOT_FINISHED",
      "completed": false,
      "number_of_levels": 5,
      "number_of_environments": 1
    },
    {
      "id": "example",
      "guid": "66fe6b58-adf8-45b1-ac73-70ed486e22d0",
      "score": 100,
      "levels_completed": 5,
      "actions": 136,
      "resets": 0,
      "state": "NOT_FINISHED",
      "completed": false,
      "number_of_levels": 5,
      "number_of_environments": 1
    }
  ],
  "open_at": "2026-01-26T23:34:18.213873Z",
  "last_update": "2026-01-26T23:34:53.229182Z",
  "total_environments_completed": 1,
  "total_environments": 1,
  "total_levels_completed": 5,
  "total_levels": 5,
  "total_actions": 136
}

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.
Returned when closing a scorecard or when retrieving a scorecard (open or closed). Includes cumulative totals, optional metadata echoed from the open request (e.g. source_url, tags, opaque), user identity (user_name, user_id), timestamps (open_at, last_update, published_at), and a per-environment breakdown in environments. The tags_scores array provides per-tag aggregates for runs that were tagged.

​
card_id
string
required

The scorecard ID returned by OpenScorecardResponse.

​
score
integer
required

Aggregate score for this scorecard (sum of per-level scores).

​
environments
object[]
required

Per-environment breakdown; each entry is one game/environment with its runs.

​
open_at
string<date-time>
required

When the scorecard was opened.

​
last_update
string<date-time>
required

When the scorecard was last updated (e.g. last action or close).

​
total_environments_completed
integer
required

Number of environments that reached a terminal state (WIN or GAME_OVER).

​
total_environments
integer
required

Total number of environments in this scorecard.

​
total_levels_completed
integer
required

Cumulative levels completed across all runs.

​
total_levels
integer
required

Total number of levels across all environments.

​
total_actions
integer
required

Cumulative number of actions taken across all plays.

​
source_url
string<uri>

Link originally supplied in the OpenScorecardRequest.

​
tags
string[]

Arbitrary labels echoed back from the open request.

​
user_name
string

Display name of the user who opened/ran this scorecard.

​
user_id
string

Stable identifier of the user (e.g. provider subject id).

​
published_at
string<date-time>

When the scorecard was closed/published (absent if still open).

​
opaque
object

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

​
tags_scores
object[]

Per-tag aggregate statistics for runs that were tagged.