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.
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>'
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ARC-AGI-3 Docs","colors":{"primary":"#ff0000"},"logo":{"light":"https://mintcdn.com/arcprizefoundation/ojplxyPxeNtW_5ms/images/ap-logo-stacked-margins_light.png?fit=max\u0026auto=format\u0026n=ojplxyPxeNtW_5ms\u0026q=85\u0026s=3122221f7af0c3e78e450c122b69592e","dark":"https://mintcdn.com/arcprizefoundation/ojplxyPxeNtW_5ms/images/ap-logo-stacked-margins_dark.png?fit=max\u0026auto=format\u0026n=ojplxyPxeNtW_5ms\u0026q=85\u0026s=b468accb6e1a9ba07517008ee4720108","href":"https://arcprize.org"},"favicon":"https://mintcdn.com/arcprizefoundation/ojplxyPxeNtW_5ms/images/favicon.png?fit=max\u0026auto=format\u0026n=ojplxyPxeNtW_5ms\u0026q=85\u0026s=c3d9d0a706623f6cba41f5bf08c812b6","appearance":{"default":"dark"},"footer":{"socials":{"github":"https://github.com/arcprize/docs","discord":"https://discord.gg/9b77dPAmcA","twitter":"https://twitter.com/arcprize"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"arcprizefoundation","hasAudioNarration":false,"actualSubdomain":"arcprizefoundation","customDomains":["docs.arcprize.org"],"gitSource":{"type":"github","owner":"arcprize","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a8da9cf0d1ad8b280ced3c4","collectionId":"3ba36649-a6aa-47bd-a251-eee251a5ab60","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a8da9cf0d1ad8b280ced3c4"},"feedback":{"edits":true,"thumbs":true,"issues":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a8da9cf0d1ad8b280ced3c4","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Overview","count":26},{"language":"default","tag":"REST API","count":17},{"language":"default","tag":"Core Concepts","count":15},{"language":"default","tag":"ARC-AGI Toolkit","count":15},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Agents","count":9},{"language":"default","tag":"Games","count":8},{"language":"default","tag":"Commands","count":8},{"language":"default","tag":"Scorecards","count":7},{"language":"default","tag":"Get Started","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/scorecards/retrieve-scorecard","slug":"/api-reference/scorecards/retrieve-scorecard","pageMetadata":{"title":"Retrieve scorecard","description":"Returns the current (or final) statistics for the specified\nscorecard. \nThis works for both open and already-closed scorecards, making it\nuseful for polling progress or fetching archived results.\n","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/scorecard/{card_id}","href":"/api-reference/scorecards/retrieve-scorecard","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n br: \"br\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns the current (or final) statistics for the specified\\nscorecard.\", _jsx(_components.br, {}), \"\\n\", \"This works for both open and already-closed scorecards, making it\\nuseful for polling progress or fetching archived results.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Retrieve scorecard","description":"Returns the current (or final) statistics for the specified\nscorecard. \nThis works for both open and already-closed scorecards, making it\nuseful for polling progress or fetching archived results.\n","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/scorecard/{card_id}","href":"/api-reference/scorecards/retrieve-scorecard","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Scorecards"],"summary":"Retrieve scorecard","description":"Returns the current (or final) statistics for the specified\nscorecard. \nThis works for both open and already-closed scorecards, making it\nuseful for polling progress or fetching archived results.\n","operationId":"getScorecard","security":["b60a5908-78e1-49d1-912f-246ac4cc4088"],"parameters":["97f7fdfb-de5d-470e-b70f-e16f74d6873d"],"responses":{"200":"a8c2b801-a124-45a8-afcb-126d81b54a44","401":"77c3701b-91d3-4c56-8861-4d91ed771887","404":"02f7d99c-36fc-42fd-b650-b6a3d0c19d43"},"method":"get","type":"path","servers":["813bc833-cecb-4f1a-8009-fcf36bd1a0a7"],"path":"/api/scorecard/{card_id}","baseUrlOptions":["https://three.arcprize.org"],"title":"Retrieve scorecard","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"97f7fdfb-de5d-470e-b70f-e16f74d6873d":{"name":"card_id","in":"path","required":true,"description":"Identifier returned by **/scorecard/open**.","schema":{"type":"string","isRequired":true,"description":"Identifier returned by **/scorecard/open**.","uniqueKey":"","typeLabel":"string"}}},"responses":{"a8c2b801-a124-45a8-afcb-126d81b54a44":{"description":"scorecard found; summary returned.","content":{"application/json":{"schema":{"type":"object","description":"Aggregate results for an entire scorecard run. \nReturned when closing a scorecard or when retrieving a scorecard (open or closed).\nIncludes cumulative totals, optional metadata echoed from the open request\n(e.g. `source_url`, `tags`, `opaque`), user identity (`user_name`, `user_id`),\ntimestamps (`open_at`, `last_update`, `published_at`), and a per-environment\nbreakdown in `environments`. The `tags_scores` array provides per-tag aggregates\nfor runs that were tagged.\n","properties":{"card_id":{"type":"string","description":"The scorecard ID returned by **OpenScorecardResponse**.","isRequired":true,"uniqueKey":"card_id","typeLabel":"string"},"score":{"type":"number","format":"float","description":"Average of the best per-environment scores in this scorecard.","isRequired":true,"uniqueKey":"score","typeLabel":"number\u003cfloat>"},"environments":{"type":"array","description":"Per-environment breakdown; each entry is one game/environment with its runs.","items":{"type":"object","description":"Statistics for one environment (game) inside a scorecard. \nContains aggregate counts and an array of `runs` (one per RESET/play).\n","properties":{"id":{"type":"string","description":"Environment/game identifier (e.g. `am92-80effacb`).","isRequired":true,"uniqueKey":"environments.items.[INDEX].id","typeLabel":"string"},"runs":{"type":"array","description":"One entry per run (RESET) in this environment.","items":{"type":"object","description":"Statistics for a single run (one RESET → play until WIN/GAME_OVER or abandon)\nwithin an environment. Arrays `level_scores`, `level_actions`, and\n`level_baseline_actions` align by index (one entry per level).\n","properties":{"id":{"type":"string","description":"Environment id this run belongs to.","isRequired":true,"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].id","typeLabel":"string"},"guid":{"type":"string","description":"Server-generated session id for this run.","isRequired":true,"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].guid","typeLabel":"string"},"score":{"type":"number","format":"float","description":"Score achieved in this run.","isRequired":true,"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].score","typeLabel":"number\u003cfloat>"},"levels_completed":{"type":"integer","description":"Number of levels completed in this run.","isRequired":true,"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].levels_completed","typeLabel":"integer"},"actions":{"type":"integer","description":"Number of actions taken in this run.","isRequired":true,"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].actions","typeLabel":"integer"},"resets":{"type":"integer","description":"Number of resets (level or full) in this run.","isRequired":true,"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].resets","typeLabel":"integer"},"state":{"type":"string","description":"Final state of the run:\n• **NOT_FINISHED** - run is active. \n• **NOT_PLAYED** - no game has been started.\n• **WIN** - run ended in victory. \n• **GAME_OVER** - run ended in defeat.\n","enum":["NOT_PLAYED","NOT_FINISHED","WIN","GAME_OVER"],"isRequired":true,"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"completed":{"type":"boolean","description":"Whether the run reached the WIN state.","isRequired":true,"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].completed","typeLabel":"boolean"},"level_scores":{"type":"array","description":"Score achieved at each level (positional).","items":{"type":"number","format":"float","uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].level_scores.items.[INDEX]","typeLabel":"number\u003cfloat>"},"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].level_scores","typeLabel":"number\u003cfloat>[]"},"level_actions":{"type":"array","description":"Actions taken at each level (positional).","items":{"type":"integer","uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].level_actions.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].level_actions","typeLabel":"integer[]"},"level_baseline_actions":{"type":"array","description":"Baseline (e.g. par) actions per level, when defined (positional).","items":{"type":"integer","uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].level_baseline_actions.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].level_baseline_actions","typeLabel":"integer[]"},"number_of_levels":{"type":"integer","description":"Number of levels in this environment (may be 0 if not applicable).","uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].number_of_levels","typeLabel":"integer"},"number_of_environments":{"type":"integer","description":"Number of environments (may be 0 if not applicable).","uniqueKey":"environments.items.[INDEX].runs.items.[INDEX].number_of_environments","typeLabel":"integer"}},"required":["id","guid","score","levels_completed","actions","resets","state","completed"],"uniqueKey":"environments.items.[INDEX].runs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"environments.items.[INDEX].runs","typeLabel":"object[]"},"score":{"type":"number","format":"float","description":"Best run score for this environment.","isRequired":true,"uniqueKey":"environments.items.[INDEX].score","typeLabel":"number\u003cfloat>"},"actions":{"type":"integer","description":"Total actions taken in this environment across all runs.","isRequired":true,"uniqueKey":"environments.items.[INDEX].actions","typeLabel":"integer"},"levels_completed":{"type":"integer","description":"Highest completed-level count among this environment's runs.","isRequired":true,"uniqueKey":"environments.items.[INDEX].levels_completed","typeLabel":"integer"},"completed":{"type":"boolean","description":"Whether at least one run in this environment reached WIN.","isRequired":true,"uniqueKey":"environments.items.[INDEX].completed","typeLabel":"boolean"},"level_count":{"type":"integer","description":"Number of levels in this environment.","isRequired":true,"uniqueKey":"environments.items.[INDEX].level_count","typeLabel":"integer"},"resets":{"type":"integer","description":"Number of RESETs (level or full) in this environment.","isRequired":true,"uniqueKey":"environments.items.[INDEX].resets","typeLabel":"integer"}},"required":["id","runs","score","actions","levels_completed","completed","level_count","resets"],"uniqueKey":"environments.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"environments","typeLabel":"object[]"},"total_environments_completed":{"type":"integer","description":"Number of environments with at least one run that reached WIN.","isRequired":true,"uniqueKey":"total_environments_completed","typeLabel":"integer"},"total_environments":{"type":"integer","description":"Total number of environments in this scorecard.","isRequired":true,"uniqueKey":"total_environments","typeLabel":"integer"},"total_levels_completed":{"type":"integer","description":"Sum of the highest completed-level count for each environment.","isRequired":true,"uniqueKey":"total_levels_completed","typeLabel":"integer"},"total_levels":{"type":"integer","description":"Total number of levels across all environments.","isRequired":true,"uniqueKey":"total_levels","typeLabel":"integer"},"total_actions":{"type":"integer","description":"Number of actions taken across all recorded runs.","isRequired":true,"uniqueKey":"total_actions","typeLabel":"integer"},"source_url":{"type":"string","format":"uri","description":"Link originally supplied in the **OpenScorecardRequest**.","uniqueKey":"source_url","typeLabel":"string\u003curi>"},"tags":{"type":"array","description":"Arbitrary labels echoed back from the open request.","items":{"type":"string","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"tags","typeLabel":"string[]"},"user_name":{"type":"string","description":"Display name of the user who opened/ran this scorecard.","uniqueKey":"user_name","typeLabel":"string"},"user_id":{"type":"string","description":"Stable identifier of the user (e.g. provider subject id).","uniqueKey":"user_id","typeLabel":"string"},"published_at":{"type":"string","format":"date-time","description":"When the scorecard was closed/published (absent if still open).","uniqueKey":"published_at","typeLabel":"string\u003cdate-time>"},"opaque":{"description":"JSON value (≤ 16 KB) exactly as provided when the\nscorecard was opened. Absent if none was supplied.\n","uniqueKey":"opaque","typeLabel":"any"},"tags_scores":{"type":"array","description":"Per-tag aggregate statistics for runs that were tagged.","items":{"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.","isRequired":true,"uniqueKey":"tags_scores.items.[INDEX].id","typeLabel":"string"},"score":{"type":"number","format":"float","description":"Aggregate score for this tag.","isRequired":true,"uniqueKey":"tags_scores.items.[INDEX].score","typeLabel":"number\u003cfloat>"},"levels_completed":{"type":"integer","description":"Levels completed for this tag.","isRequired":true,"uniqueKey":"tags_scores.items.[INDEX].levels_completed","typeLabel":"integer"},"actions":{"type":"integer","description":"Total actions for this tag.","isRequired":true,"uniqueKey":"tags_scores.items.[INDEX].actions","typeLabel":"integer"},"number_of_levels":{"type":"integer","description":"Number of levels.","isRequired":true,"uniqueKey":"tags_scores.items.[INDEX].number_of_levels","typeLabel":"integer"},"number_of_environments":{"type":"integer","description":"Number of environments.","isRequired":true,"uniqueKey":"tags_scores.items.[INDEX].number_of_environments","typeLabel":"integer"},"guid":{"type":"string","description":"Session id associated with this tag entry.","uniqueKey":"tags_scores.items.[INDEX].guid","typeLabel":"string"},"resets":{"type":"integer","description":"Resets for this tag.","uniqueKey":"tags_scores.items.[INDEX].resets","typeLabel":"integer"},"state":{"type":"string","enum":["NOT_PLAYED","NOT_FINISHED","WIN","GAME_OVER"],"description":"Terminal state for this tag run, if applicable.","uniqueKey":"tags_scores.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"completed":{"type":"boolean","description":"Whether this tag aggregate reached the WIN state.","uniqueKey":"tags_scores.items.[INDEX].completed","typeLabel":"boolean"}},"required":["id","score","levels_completed","actions","number_of_levels","number_of_environments"],"uniqueKey":"tags_scores.items.[INDEX]","typeLabel":"object"},"uniqueKey":"tags_scores","typeLabel":"object[]"},"competition_mode":{"oneOf":[{"type":"boolean","description":"Whether competition restrictions apply to this scorecard.","uniqueKey":"competition_mode.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether competition restrictions apply to this scorecard.","uniqueKey":"competition_mode.oneOf.1","typeLabel":"null"}],"uniqueKey":"competition_mode","typeLabel":"boolean | null"},"open_at":{"type":"string","format":"date-time","description":"When the scorecard was opened.","uniqueKey":"open_at","typeLabel":"string\u003cdate-time>"},"last_update":{"type":"string","format":"date-time","description":"When the scorecard was last updated (e.g. last action or close).","uniqueKey":"last_update","typeLabel":"string\u003cdate-time>"}},"required":["card_id","score","environments","total_environments_completed","total_environments","total_levels_completed","total_levels","total_actions"],"uniqueKey":"","typeLabel":"object"},"examples":{"example":{"title":"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":[]}}},"exampleType":"examples"}},"exampleType":"examples"},"77c3701b-91d3-4c56-8861-4d91ed771887":{"description":"Missing or invalid **X-API-Key** header.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"02f7d99c-36fc-42fd-b650-b6a3d0c19d43":{"description":"No open or closed scorecard found with the supplied `card_id`.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"b60a5908-78e1-49d1-912f-246ac4cc4088":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[]}}},"servers":{"813bc833-cecb-4f1a-8009-fcf36bd1a0a7":{"url":"https://three.arcprize.org"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[]},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"arc3v1.yaml"},"subdomain":"arcprizefoundation","siteName":"ARC-AGI-3 Docs","title":"Retrieve scorecard - ARC-AGI-3 Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-25T14:42:34.784Z","originalFileLocation":"api-reference/scorecards/retrieve-scorecard.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ARC-AGI-3 Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve scorecard - ARC-AGI-3 Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ARC-AGI-3 Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.arcprize.org/api-reference/scorecards/retrieve-scorecard\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://arcprizefoundation.mintlify.app/_mintlify/api/og/v2?division=Scorecards\u0026amp;title=Retrieve+scorecard\u0026amp;description=Returns+the+current+%28or+final%29+statistics+for+the+specified%0Ascorecard.++%0AThis+works+for+both+open+and+already-closed+scorecards%2C+making+it%0Auseful+for+polling+pr\u0026amp;theme=1de61eb03f71cd07c44a4a8b\u0026amp;signature=e91f9e14558e760ea435f5bee4089a1f6d31c156f77f43cd79e97c427f606eb9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Retrieve scorecard - ARC-AGI-3 Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://arcprizefoundation.mintlify.app/_mintlify/api/og/v2?division=Scorecards\u0026amp;title=Retrieve+scorecard\u0026amp;description=Returns+the+current+%28or+final%29+statistics+for+the+specified%0Ascorecard.++%0AThis+works+for+both+open+and+already-closed+scorecards%2C+making+it%0Auseful+for+polling+pr\u0026amp;theme=1de61eb03f71cd07c44a4a8b\u0026amp;signature=e91f9e14558e760ea435f5bee4089a1f6d31c156f77f43cd79e97c427f606eb9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/arcprizefoundation/t8cxagpq7CKhQioK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ARC-AGI-3 Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff0000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.arcprize.org/api-reference/scorecards/retrieve-scorecard\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/scorecards/retrieve-scorecard.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.arcprize.org/#organization\",\"name\":\"ARC-AGI-3 Docs\",\"url\":\"https://docs.arcprize.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/arcprizefoundation/ojplxyPxeNtW_5ms/images/ap-logo-stacked-margins_light.png?fit=max\u0026auto=format\u0026n=ojplxyPxeNtW_5ms\u0026q=85\u0026s=3122221f7af0c3e78e450c122b69592e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.arcprize.org#website\",\"name\":\"ARC-AGI-3 Docs\",\"url\":\"https://docs.arcprize.org\",\"publisher\":{\"@id\":\"https://docs.arcprize.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.arcprize.org/api-reference/scorecards/retrieve-scorecard#webpage\",\"url\":\"https://docs.arcprize.org/api-reference/scorecards/retrieve-scorecard\",\"name\":\"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.\",\"dateModified\":\"2026-08-25T14:42:34.784Z\",\"isPartOf\":{\"@id\":\"https://docs.arcprize.org#website\"},\"breadcrumb\":{\"@id\":\"https://docs.arcprize.org/api-reference/scorecards/retrieve-scorecard#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.arcprize.org/api-reference/scorecards/retrieve-scorecard#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Scorecards\",\"item\":\"https://docs.arcprize.org/api-reference/scorecards/open-scorecard\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve scorecard\",\"item\":\"https://docs.arcprize.org/api-reference/scorecards/retrieve-scorecard\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.arcprize.org/api-reference/scorecards/retrieve-scorecard#apireference\",\"headline\":\"Retrieve scorecard\",\"name\":\"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.\",\"url\":\"https://docs.arcprize.org/api-reference/scorecards/retrieve-scorecard\",\"mainEntityOfPage\":{\"@id\":\"https://docs.arcprize.org/api-reference/scorecards/retrieve-scorecard#webpage\"},\"dateModified\":\"2026-08-25T14:42:34.784Z\",\"publisher\":{\"@id\":\"https://docs.arcprize.org/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.arcprize.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ARC-AGI-3 Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ARC-AGI-3 Docs","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":""}]},{"tab":"ARC-AGI Toolkit","pages":[{"title":"ARC-AGI Toolkit","href":"/toolkit/overview"}]},{"tab":"REST API","groups":[{"group":"Using the API","pages":[{"title":"Overview","icon":"file-text","href":"/rest_overview"},{"title":"Rate Limits","icon":"activity","href":"/rate_limits"}]},{"group":"Games","pages":[{"title":"List available games","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/games","href":"/api-reference/games/list-available-games"},{"title":"Retrieve game metadata","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/games/{game_id}","href":"/api-reference/games/retrieve-game-metadata"}]},{"group":"API Reference","pages":[{"title":"Check API health","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/healthcheck","href":"/api-reference/check-api-health"}]},{"group":"Scorecards","pages":[{"title":"Open scorecard","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/scorecard/open","href":"/api-reference/scorecards/open-scorecard"},{"title":"Close scorecard","description":"Finalises a previously opened scorecard, locking its data and\nreturning the aggregate results. \nAfter a scorecard is closed, additional RESET or ACTION commands\nusing its `card_id` are rejected. \nYou must supply the `card_id` obtained from **/scorecard/open**.\n","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/scorecard/close","href":"/api-reference/scorecards/close-scorecard"},{"title":"Retrieve scorecard","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/scorecard/{card_id}","href":"/api-reference/scorecards/retrieve-scorecard"},{"title":"Retrieve scorecard (one game)","description":"Returns the scorecard statistics **limited to a single environment**.\nOnly the entry matching `game_id` is present in `environments`; all\ntop-level counters are recomputed for that environment alone.\n\nUseful for dashboards that present per-game progress without\nfetching the full scorecard payload.\n","deprecated":null,"version":null,"openapi":"/arc3v1.yaml get /api/scorecard/{card_id}/{game_id}","href":"/api-reference/scorecards/retrieve-scorecard-one-game"}]},{"group":"Commands","pages":[{"title":"Start or reset game instance","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/RESET","href":"/api-reference/commands/start-or-reset-game-instance"},{"title":"Execute simple action 1","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION1","href":"/api-reference/commands/execute-simple-action-1"},{"title":"Execute simple action 2","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION2","href":"/api-reference/commands/execute-simple-action-2"},{"title":"Execute simple action 3","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION3","href":"/api-reference/commands/execute-simple-action-3"},{"title":"Execute simple action 4","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION4","href":"/api-reference/commands/execute-simple-action-4"},{"title":"Execute simple action 5","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION5","href":"/api-reference/commands/execute-simple-action-5"},{"title":"Execute complex action (requires x,y)","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION6","href":"/api-reference/commands/execute-complex-action-requires-xy"},{"title":"Execute simple action 7","deprecated":null,"version":null,"openapi":"/arc3v1.yaml post /api/cmd/ACTION7","href":"/api-reference/commands/execute-simple-action-7"}]}]}]},"basePath":"","title":"Retrieve scorecard - ARC-AGI-3 Docs","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}