The published scores for the stocks you name. Each stock counts once per Pacific day toward the plan, whichever day’s score you get; asking again that day is free. At the limit the whole call is refused (limit_reached) and nothing counts.
A trading day as YYYY-MM-DD within the last 21 trading days, the latest included. A day with no published scores returns invalid_date. Leave it out for the latest scores.
full or short. Defaults to full for 1 to 10 symbols (after duplicates are dropped), short for more. Short entries leave out notice; show 'Published score, the same for everyone. Not personal investment advice.' with any score you display.
How much of the plan's allowance is left until it renews, in words.
Available options:
plenty left,
running low,
none left until your plan renews
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Forward Model","colors":{"primary":"#18181B","light":"#A1A1AA","dark":"#18181B"},"seo":{"metatags":{"robots":"noindex, nofollow"}},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"forward-model","hasAudioNarration":false,"actualSubdomain":"forward-model","customDomains":["docs.forwardmodel.ai"],"gitSource":{"type":"github","owner":"forwardmodel","repo":"forwardmodel-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6aebba0f50daecfb2359a178","collectionId":"51101cbb-13b5-49df-98bc-d52b80c58026","liveDeploymentHistoryId":"6aebba0f50daecfb2359a178","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aebbc7a346bfefaaa0bed50","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"Use the scores","count":3},{"language":"default","tag":"Account","count":3},{"language":"default","tag":"API reference","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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/get-scores","slug":"/api-reference/get-scores","pageMetadata":{"title":"Get scores","description":"The published scores for the stocks you name. Each stock counts once per Pacific day toward the plan, whichever day's score you get; asking again that day is free. At the limit the whole call is refused (limit_reached) and nothing counts.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/scores","href":"/api-reference/get-scores","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The published scores for the stocks you name. Each stock counts once per Pacific day toward the plan, whichever day’s score you get; asking again that day is free. At the limit the whole call is refused (limit_reached) and nothing counts.\"\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":"Get scores","description":"The published scores for the stocks you name. Each stock counts once per Pacific day toward the plan, whichever day's score you get; asking again that day is free. At the limit the whole call is refused (limit_reached) and nothing counts.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/scores","href":"/api-reference/get-scores","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getScores","summary":"Get scores","description":"The published scores for the stocks you name. Each stock counts once per Pacific day toward the plan, whichever day's score you get; asking again that day is free. At the limit the whole call is refused (limit_reached) and nothing counts.","parameters":["32354da8-86f3-4204-9d5b-f608c6e57a43","6e98671c-7ec3-45bb-8f62-90ee74e20cfe","b71f51f8-dd2a-4ac0-9ff8-da1311310dab"],"responses":{"200":"9b7dc6aa-757d-4b7d-beed-e23eb0dd3b87","400":"c90c40cf-1b44-4d27-b9d8-0b489d08476b","401":"7191a27d-061f-495a-9132-bdfa5ac7f68f","402":"f1ff6a1c-a4f3-4927-8d6c-f5fac3968a28","429":"bfa78a5a-61b2-4828-98bd-2ec7de628a75","500":"d34fb559-7a26-439b-b247-9f3b34584157","503":"ac024a1f-1d0d-48ac-88f3-7b5f4bee6e6f"},"method":"get","type":"path","servers":["082a37e0-8243-43a3-acc9-5d56b4f553ce"],"security":["398fe01a-7651-4f4d-9657-41db87e0af08"],"path":"/v1/scores","baseUrlOptions":["https://api.forwardmodel.ai"],"title":"Get scores","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"32354da8-86f3-4204-9d5b-f608c6e57a43":{"name":"symbols","in":"query","required":true,"description":"Up to 50 US stock tickers, comma-separated, such as COST,MSFT,BRK-B (share classes use a hyphen). Unknown tickers come back under not_scored.","schema":{"type":"string","isRequired":true,"description":"Up to 50 US stock tickers, comma-separated, such as COST,MSFT,BRK-B (share classes use a hyphen). Unknown tickers come back under not_scored.","uniqueKey":"","typeLabel":"string"},"example":"COST,MSFT"},"6e98671c-7ec3-45bb-8f62-90ee74e20cfe":{"name":"date","in":"query","required":false,"description":"A trading day as YYYY-MM-DD within the last 21 trading days, the latest included. A day with no published scores returns invalid_date. Leave it out for the latest scores.","schema":{"type":"string","format":"date","isRequired":false,"description":"A trading day as YYYY-MM-DD within the last 21 trading days, the latest included. A day with no published scores returns invalid_date. Leave it out for the latest scores.","uniqueKey":"","typeLabel":"string\u003cdate>"}},"b71f51f8-dd2a-4ac0-9ff8-da1311310dab":{"name":"detail","in":"query","required":false,"description":"full or short. Defaults to full for 1 to 10 symbols (after duplicates are dropped), short for more. Short entries leave out notice; show 'Published score, the same for everyone. Not personal investment advice.' with any score you display.","schema":{"type":"string","enum":["full","short"],"isRequired":false,"description":"full or short. Defaults to full for 1 to 10 symbols (after duplicates are dropped), short for more. Short entries leave out notice; show 'Published score, the same for everyone. Not personal investment advice.' with any score you display.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"9b7dc6aa-757d-4b7d-beed-e23eb0dd3b87":{"description":"The scores.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["date","entries","not_scored","of","scores_left_words"],"properties":{"date":{"type":"string","description":"The trading day of these scores.","format":"date","isRequired":true,"uniqueKey":"date","typeLabel":"string\u003cdate>"},"of":{"type":"integer","description":"How many stocks were scored that day.","isRequired":true,"uniqueKey":"of","typeLabel":"integer"},"entries":{"type":"array","items":{"type":"object","required":["symbol","name","date","score","band","top_pct"],"properties":{"symbol":{"type":"string","description":"The ticker.","isRequired":true,"uniqueKey":"entries.items.[INDEX].symbol","typeLabel":"string"},"name":{"type":"string","description":"The company.","isRequired":true,"uniqueKey":"entries.items.[INDEX].name","typeLabel":"string"},"date":{"type":"string","description":"The trading day of the score.","format":"date","isRequired":true,"uniqueKey":"entries.items.[INDEX].date","typeLabel":"string\u003cdate>"},"score":{"type":"number","minimum":1,"maximum":10,"description":"1.00 to 10.00: the stock's position among that day's scored stocks. Compare within a day.","isRequired":true,"uniqueKey":"entries.items.[INDEX].score","typeLabel":"number"},"band":{"type":"string","enum":["Strong","Above average","Middle","Below average","Weak"],"isRequired":true,"uniqueKey":"entries.items.[INDEX].band","typeLabel":"enum\u003cstring>"},"top_pct":{"type":"integer","minimum":1,"maximum":100,"description":"35 means the top 35% of the day's scores.","isRequired":true,"uniqueKey":"entries.items.[INDEX].top_pct","typeLabel":"integer"},"context_through":{"oneOf":[{"type":"string","description":"The newest information the score could use (US Eastern offset). ISO 8601 to the minute, e.g. 2026-11-16T07:14-05:00.","uniqueKey":"entries.items.[INDEX].context_through.oneOf.0","typeLabel":"string"},{"type":"null","description":"The newest information the score could use (US Eastern offset). ISO 8601 to the minute, e.g. 2026-11-16T07:14-05:00.","uniqueKey":"entries.items.[INDEX].context_through.oneOf.1","typeLabel":"null"}],"uniqueKey":"entries.items.[INDEX].context_through","typeLabel":"string | null"},"scored_at":{"oneOf":[{"type":"string","description":"When the stock was scored. ISO 8601 to the minute, e.g. 2026-11-16T07:14-05:00.","uniqueKey":"entries.items.[INDEX].scored_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the stock was scored. ISO 8601 to the minute, e.g. 2026-11-16T07:14-05:00.","uniqueKey":"entries.items.[INDEX].scored_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"entries.items.[INDEX].scored_at","typeLabel":"string | null"},"set_at":{"oneOf":[{"type":"string","description":"When the day's scores were locked and published. ISO 8601 to the minute, e.g. 2026-11-16T07:14-05:00.","uniqueKey":"entries.items.[INDEX].set_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the day's scores were locked and published. ISO 8601 to the minute, e.g. 2026-11-16T07:14-05:00.","uniqueKey":"entries.items.[INDEX].set_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"entries.items.[INDEX].set_at","typeLabel":"string | null"},"out_of":{"type":"number","const":10,"uniqueKey":"entries.items.[INDEX].out_of","typeLabel":"number"},"summary":{"oneOf":[{"type":"string","description":"One line on the stock.","uniqueKey":"entries.items.[INDEX].summary.oneOf.0","typeLabel":"string"},{"type":"null","description":"One line on the stock.","uniqueKey":"entries.items.[INDEX].summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"entries.items.[INDEX].summary","typeLabel":"string | null"},"for":{"type":"array","items":{"type":"string","uniqueKey":"entries.items.[INDEX].for.items.[INDEX]","typeLabel":"string"},"description":"Main points for. May be empty.","uniqueKey":"entries.items.[INDEX].for","typeLabel":"string[]"},"against":{"type":"array","items":{"type":"string","uniqueKey":"entries.items.[INDEX].against.items.[INDEX]","typeLabel":"string"},"description":"Main points against. May be empty.","uniqueKey":"entries.items.[INDEX].against","typeLabel":"string[]"},"watch":{"type":"array","items":{"type":"string","uniqueKey":"entries.items.[INDEX].watch.items.[INDEX]","typeLabel":"string"},"description":"Things to watch. Often empty.","uniqueKey":"entries.items.[INDEX].watch","typeLabel":"string[]"},"graded_after_trading_days":{"type":"integer","const":21,"uniqueKey":"entries.items.[INDEX].graded_after_trading_days","typeLabel":"integer"},"notice":{"type":"string","description":"Show this line with any score you display.","uniqueKey":"entries.items.[INDEX].notice","typeLabel":"string"}},"uniqueKey":"entries.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"entries","typeLabel":"object[]"},"not_scored":{"type":"array","items":{"type":"object","required":["symbol","reason"],"properties":{"symbol":{"type":"string","description":"The ticker asked for.","isRequired":true,"uniqueKey":"not_scored.items.[INDEX].symbol","typeLabel":"string"},"reason":{"type":"string","description":"Why there's no score, for example a fund or ETF.","isRequired":true,"uniqueKey":"not_scored.items.[INDEX].reason","typeLabel":"string"}},"uniqueKey":"not_scored.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"not_scored","typeLabel":"object[]"},"scores_left_words":{"type":"string","enum":["plenty left","running low","none left until your plan renews"],"description":"How much of the plan's allowance is left until it renews, in words.","isRequired":true,"uniqueKey":"scores_left_words","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"date":"2023-12-25","of":123,"entries":[{"symbol":"\u003cstring>","name":"\u003cstring>","date":"2023-12-25","score":5.5,"band":"Strong","top_pct":50,"context_through":"\u003cstring>","scored_at":"\u003cstring>","set_at":"\u003cstring>","out_of":10,"summary":"\u003cstring>","for":["\u003cstring>"],"against":["\u003cstring>"],"watch":["\u003cstring>"],"graded_after_trading_days":21,"notice":"\u003cstring>"}],"not_scored":[{"symbol":"\u003cstring>","reason":"\u003cstring>"}],"scores_left_words":"plenty left"}}},"exampleType":"generated"}},"exampleType":"generated"},"c90c40cf-1b44-4d27-b9d8-0b489d08476b":{"description":"invalid_input or invalid_date: fix the input named in field.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_input","invalid_date","unauthenticated","key_revoked","plan_required","limit_reached","rate_limited","model_unavailable","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What happened, in plain words.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it to support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","description":"The input that was wrong.","uniqueKey":"error.field","typeLabel":"string"},"retry_after_seconds":{"type":"integer","uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"resets_at":{"oneOf":[{"type":"string","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.resets_at","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_input","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","retry_after_seconds":123,"resets_at":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7191a27d-061f-495a-9132-bdfa5ac7f68f":{"description":"unauthenticated or key_revoked: a valid key is needed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_input","invalid_date","unauthenticated","key_revoked","plan_required","limit_reached","rate_limited","model_unavailable","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What happened, in plain words.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it to support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","description":"The input that was wrong.","uniqueKey":"error.field","typeLabel":"string"},"retry_after_seconds":{"type":"integer","uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"resets_at":{"oneOf":[{"type":"string","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.resets_at","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_input","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","retry_after_seconds":123,"resets_at":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f1ff6a1c-a4f3-4927-8d6c-f5fac3968a28":{"description":"plan_required: needs Plus, or the date is older than the plan covers.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_input","invalid_date","unauthenticated","key_revoked","plan_required","limit_reached","rate_limited","model_unavailable","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What happened, in plain words.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it to support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","description":"The input that was wrong.","uniqueKey":"error.field","typeLabel":"string"},"retry_after_seconds":{"type":"integer","uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"resets_at":{"oneOf":[{"type":"string","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.resets_at","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_input","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","retry_after_seconds":123,"resets_at":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"bfa78a5a-61b2-4828-98bd-2ec7de628a75":{"description":"limit_reached (wait until resets_at) or rate_limited (wait retry_after_seconds).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_input","invalid_date","unauthenticated","key_revoked","plan_required","limit_reached","rate_limited","model_unavailable","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What happened, in plain words.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it to support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","description":"The input that was wrong.","uniqueKey":"error.field","typeLabel":"string"},"retry_after_seconds":{"type":"integer","uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"resets_at":{"oneOf":[{"type":"string","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.resets_at","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_input","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","retry_after_seconds":123,"resets_at":"\u003cstring>"}}}},"exampleType":"generated"}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying (rate_limited, model_unavailable)."}},"exampleType":"generated"},"d34fb559-7a26-439b-b247-9f3b34584157":{"description":"server_error: retry once.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_input","invalid_date","unauthenticated","key_revoked","plan_required","limit_reached","rate_limited","model_unavailable","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What happened, in plain words.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it to support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","description":"The input that was wrong.","uniqueKey":"error.field","typeLabel":"string"},"retry_after_seconds":{"type":"integer","uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"resets_at":{"oneOf":[{"type":"string","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.resets_at","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_input","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","retry_after_seconds":123,"resets_at":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"ac024a1f-1d0d-48ac-88f3-7b5f4bee6e6f":{"description":"model_unavailable: retry after retry_after_seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_input","invalid_date","unauthenticated","key_revoked","plan_required","limit_reached","rate_limited","model_unavailable","server_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What happened, in plain words.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it to support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"field":{"type":"string","description":"The input that was wrong.","uniqueKey":"error.field","typeLabel":"string"},"retry_after_seconds":{"type":"integer","uniqueKey":"error.retry_after_seconds","typeLabel":"integer"},"resets_at":{"oneOf":[{"type":"string","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the limit resets: the next midnight Pacific for the daily limit, the plan's renewal for the monthly one; null if not known.","uniqueKey":"error.resets_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.resets_at","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_input","message":"\u003cstring>","request_id":"\u003cstring>","field":"\u003cstring>","retry_after_seconds":123,"resets_at":"\u003cstring>"}}}},"exampleType":"generated"}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying (rate_limited, model_unavailable)."}},"exampleType":"generated"}},"security":{"398fe01a-7651-4f4d-9657-41db87e0af08":{"bearer":{"type":"http","scheme":"bearer","description":"An API key from console.forwardmodel.ai, starting fm_live_.","scopes":[],"schemeName":"bearer"}}},"servers":{"082a37e0-8243-43a3-acc9-5d56b4f553ce":{"url":"https://api.forwardmodel.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API key from console.forwardmodel.ai, starting fm_live_.","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key from console.forwardmodel.ai, starting fm_live_.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"openapi.json"},"subdomain":"forward-model","siteName":"Forward Model","title":"Get scores - Forward Model","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T23:15:09.675Z","originalFileLocation":"api-reference/get-scores.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=\"system\"}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=\"The published scores for the stocks you name. Each stock counts once per Pacific day toward the plan, whichever day\u0026#x27;s score you get; asking again that day is free. At the limit the whole call is refused (limit_reached) and nothing counts.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Forward Model\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex, nofollow\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/forward-model/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/forward-model/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/forward-model/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/forward-model/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get scores - Forward Model\">\u003cmeta data-mint-head property=\"og:description\" content=\"The published scores for the stocks you name. Each stock counts once per Pacific day toward the plan, whichever day\u0026#x27;s score you get; asking again that day is free. At the limit the whole call is refused (limit_reached) and nothing counts.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Forward Model\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.forwardmodel.ai/api-reference/get-scores\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://forward-model.mintlify.app/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Get+scores\u0026amp;description=The+published+scores+for+the+stocks+you+name.+Each+stock+counts+once+per+Pacific+day+toward+the+plan%2C+whichever+day%27s+score+you+get%3B+asking+again+that+day+is+fr\u0026amp;theme=df198dc2fbd1853564f33252\u0026amp;signature=3ee1142cab9768655490707762e6877143eeb5edf0466467fc40005f3a413f1d\">\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=\"Get scores - Forward Model\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The published scores for the stocks you name. Each stock counts once per Pacific day toward the plan, whichever day\u0026#x27;s score you get; asking again that day is free. At the limit the whole call is refused (limit_reached) and nothing counts.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://forward-model.mintlify.app/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Get+scores\u0026amp;description=The+published+scores+for+the+stocks+you+name.+Each+stock+counts+once+per+Pacific+day+toward+the+plan%2C+whichever+day%27s+score+you+get%3B+asking+again+that+day+is+fr\u0026amp;theme=df198dc2fbd1853564f33252\u0026amp;signature=3ee1142cab9768655490707762e6877143eeb5edf0466467fc40005f3a413f1d\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/forward-model/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Forward Model\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#18181B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.forwardmodel.ai/api-reference/get-scores\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-scores.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.forwardmodel.ai/#organization\",\"name\":\"Forward Model\",\"url\":\"https://docs.forwardmodel.ai\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.forwardmodel.ai#website\",\"name\":\"Forward Model\",\"url\":\"https://docs.forwardmodel.ai\",\"publisher\":{\"@id\":\"https://docs.forwardmodel.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.forwardmodel.ai/api-reference/get-scores#webpage\",\"url\":\"https://docs.forwardmodel.ai/api-reference/get-scores\",\"name\":\"Get scores\",\"description\":\"The published scores for the stocks you name. Each stock counts once per Pacific day toward the plan, whichever day's score you get; asking again that day is free. At the limit the whole call is refused (limit_reached) and nothing counts.\",\"dateModified\":\"2026-11-04T23:15:09.675Z\",\"isPartOf\":{\"@id\":\"https://docs.forwardmodel.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.forwardmodel.ai/api-reference/get-scores#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.forwardmodel.ai/api-reference/get-scores#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Forward Model\",\"item\":\"https://docs.forwardmodel.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get scores\",\"item\":\"https://docs.forwardmodel.ai/api-reference/get-scores\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.forwardmodel.ai/api-reference/get-scores#apireference\",\"headline\":\"Get scores\",\"name\":\"Get scores\",\"description\":\"The published scores for the stocks you name. Each stock counts once per Pacific day toward the plan, whichever day's score you get; asking again that day is free. At the limit the whole call is refused (limit_reached) and nothing counts.\",\"url\":\"https://docs.forwardmodel.ai/api-reference/get-scores\",\"mainEntityOfPage\":{\"@id\":\"https://docs.forwardmodel.ai/api-reference/get-scores#webpage\"},\"dateModified\":\"2026-11-04T23:15:09.675Z\",\"publisher\":{\"@id\":\"https://docs.forwardmodel.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.forwardmodel.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Forward Model\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Forward Model","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"Forward Model docs","href":"/index"},{"title":"Quickstart","href":"/quickstart"},{"title":"For coding agents","href":"/for-agents"},{"title":"What a score means","href":"/what-a-score-means"}]},{"group":"Use the scores","pages":[{"title":"The scores API","href":"/scores-api"},{"title":"Claude and ChatGPT","href":"/claude-and-chatgpt"},{"title":"Keys and sign-in","description":"Sign in at console.forwardmodel.ai with Google or with a code sent to your email.","href":"/authentication"}]},{"group":"API reference","pages":[{"title":"Get scores","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/scores","href":"/api-reference/get-scores"}]},{"group":"Account","pages":[{"title":"Plans and limits","description":"Unlimited chat is subject to fair use.","href":"/plans-and-limits"},{"title":"Errors","href":"/errors"},{"title":"Data and privacy","href":"/data-and-privacy"}]}]},"basePath":"","title":"Get scores - Forward Model","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"]}