---
title: "Open scorecard"
method: POST
path: "/api/scorecard/open"
tags: ["Scorecards"]
---

# Open scorecard

`POST /api/scorecard/open`

Creates a new scorecard to aggregate statistics across one or more
plays. The server returns a `card_id`, which must be included in all
subsequent RESET commands and in the final **/scorecard/close** call.
You may attach optional metadata (URL, tags, opaque JSON) that will
be echoed back in summary responses.

## Request body

- OpenScorecardRequest — Optional metadata sent when opening a scorecard. Every field is optional; omit any you don't need. Use this to attach provenance links, free-form tags, or an “opaque” JSON blob describing the run (e.g. model settings, hyper-parameters, experiment notes). The opaque payload must not exceed 16 KB once serialized.
  - `source_url` string, uri — Link to code, notebook, or write-up associated with the run.
  - `tags` string[] — Arbitrary labels for later filtering and aggregation.
  - `opaque` object — Free-form JSON data (≤ 16 KB). Stored verbatim; the service does not inspect or validate its structure.

## Response `200`

scorecard successfully created.

- OpenScorecardResponse — Response returned after a successful “open scorecard” request. Contains the server-generated identifier for this tracked run.
  - `card_id` string, required — Globally unique ID for the newly opened scorecard.

## Other responses

- `401` — Missing or invalid **X-API-Key** header.

---

[API](https://skmtc.net/arcprize/apis/arc-agi-3-rest-api.md) · [All operations](https://skmtc.net/arcprize/apis/arc-agi-3-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arcprize/arc-agi-3-rest-api/versions/195a67c94d38/schema)