> ## Documentation Index > Fetch the complete documentation index at: https://docs.arcprize.org/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve scorecard > Returns the current (or final) statistics for the specified scorecard. This works for both open and already-closed scorecards, making it useful for polling progress or fetching archived results. ## OpenAPI ````yaml /arc3v1.yaml get /api/scorecard/{card_id} openapi: 3.0.3 info: title: ARC‑AGI‑3 REST API version: 1.0.0 description: > Programmatic interface for running agents against ARC‑AGI‑3 games, opening/closing score‑cards and driving game state with actions. All requests **require** an `X‑API‑Key` header issued from the ARC‑AGI‑3 web console. **Important: Session Affinity via Cookies** Games are stateful and require session affinity. The server sets cookies (especially `AWSALB*` cookies) in responses that **must be included in all subsequent requests** for the same game session. These cookies route requests to the correct backend instance maintaining your game state. Most HTTP clients handle cookies automatically, but ensure your client preserves and sends cookies received from RESET and ACTION responses. servers: - url: https://three.arcprize.org security: [] tags: - name: Games - name: Scorecards - name: Commands paths: /api/scorecard/{card_id}: get: tags: - Scorecards summary: Retrieve scorecard description: | Returns the current (or final) statistics for the specified scorecard. This works for both open and already-closed scorecards, making it useful for polling progress or fetching archived results. operationId: getScorecard parameters: - name: card_id in: path required: true description: Identifier returned by **/scorecard/open**. schema: type: string responses: '200': description: scorecard found; summary returned. content: application/json: schema: $ref: '#/components/schemas/ScorecardSummary' examples: example: value: 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 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 environments: [] tags_scores: [] '401': description: Missing or invalid **X-API-Key** header. '404': description: No open or closed scorecard found with the supplied `card_id`. security: - ApiKeyAuth: [] components: schemas: ScorecardSummary: type: object description: > 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. properties: card_id: type: string description: The scorecard ID returned by **OpenScorecardResponse**. score: type: number format: float description: Average of the best per-environment scores in this scorecard. source_url: type: string format: uri description: Link originally supplied in the **OpenScorecardRequest**. tags: type: array description: Arbitrary labels echoed back from the open request. items: type: string user_name: type: string description: Display name of the user who opened/ran this scorecard. user_id: type: string description: Stable identifier of the user (e.g. provider subject id). published_at: type: string format: date-time description: When the scorecard was closed/published (absent if still open). environments: type: array description: >- Per-environment breakdown; each entry is one game/environment with its runs. items: $ref: '#/components/schemas/EnvironmentSummary' opaque: description: | JSON value (≤ 16 KB) exactly as provided when the scorecard was opened. Absent if none was supplied. tags_scores: type: array description: Per-tag aggregate statistics for runs that were tagged. items: $ref: '#/components/schemas/TagScore' competition_mode: type: boolean nullable: true description: Whether competition restrictions apply to this scorecard. open_at: type: string format: date-time description: When the scorecard was opened. last_update: type: string format: date-time description: When the scorecard was last updated (e.g. last action or close). total_environments_completed: type: integer description: Number of environments with at least one run that reached WIN. total_environments: type: integer description: Total number of environments in this scorecard. total_levels_completed: type: integer description: Sum of the highest completed-level count for each environment. total_levels: type: integer description: Total number of levels across all environments. total_actions: type: integer description: Number of actions taken across all recorded runs. required: - card_id - score - environments - total_environments_completed - total_environments - total_levels_completed - total_levels - total_actions EnvironmentSummary: type: object description: | Statistics for one environment (game) inside a scorecard. Contains aggregate counts and an array of `runs` (one per RESET/play). properties: id: type: string description: Environment/game identifier (e.g. `am92-80effacb`). runs: type: array description: One entry per run (RESET) in this environment. items: $ref: '#/components/schemas/RunSummary' score: type: number format: float description: Best run score for this environment. actions: type: integer description: Total actions taken in this environment across all runs. levels_completed: type: integer description: Highest completed-level count among this environment's runs. completed: type: boolean description: Whether at least one run in this environment reached WIN. level_count: type: integer description: Number of levels in this environment. resets: type: integer description: Number of RESETs (level or full) in this environment. required: - id - runs - score - actions - levels_completed - completed - level_count - resets TagScore: type: object description: >- Per-tag aggregate statistics for runs that were tagged (e.g. for filtering). properties: id: type: string description: Tag or run identifier. guid: type: string description: Session id associated with this tag entry. score: type: number format: float description: Aggregate score for this tag. levels_completed: type: integer description: Levels completed for this tag. actions: type: integer description: Total actions for this tag. resets: type: integer description: Resets for this tag. state: type: string enum: - NOT_PLAYED - NOT_FINISHED - WIN - GAME_OVER description: Terminal state for this tag run, if applicable. completed: type: boolean description: Whether this tag aggregate reached the WIN state. number_of_levels: type: integer description: Number of levels. number_of_environments: type: integer description: Number of environments. required: - id - score - levels_completed - actions - number_of_levels - number_of_environments RunSummary: type: object description: > Statistics for a single run (one RESET → play until WIN/GAME_OVER or abandon) within an environment. Arrays `level_scores`, `level_actions`, and `level_baseline_actions` align by index (one entry per level). properties: id: type: string description: Environment id this run belongs to. guid: type: string description: Server-generated session id for this run. score: type: number format: float description: Score achieved in this run. levels_completed: type: integer description: Number of levels completed in this run. actions: type: integer description: Number of actions taken in this run. resets: type: integer description: Number of resets (level or full) in this run. state: type: string description: | Final state of the run: • **NOT_FINISHED** - run is active. • **NOT_PLAYED** - no game has been started. • **WIN** - run ended in victory. • **GAME_OVER** - run ended in defeat. enum: - NOT_PLAYED - NOT_FINISHED - WIN - GAME_OVER completed: type: boolean description: Whether the run reached the WIN state. level_scores: type: array description: Score achieved at each level (positional). items: type: number format: float level_actions: type: array description: Actions taken at each level (positional). items: type: integer level_baseline_actions: type: array description: Baseline (e.g. par) actions per level, when defined (positional). items: type: integer number_of_levels: type: integer description: Number of levels in this environment (may be 0 if not applicable). number_of_environments: type: integer description: Number of environments (may be 0 if not applicable). required: - id - guid - score - levels_completed - actions - resets - state - completed securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ````