> ## Documentation Index > Fetch the complete documentation index at: https://docs.forwardmodel.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get scores > 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. ## OpenAPI ````yaml /openapi.json get /v1/scores openapi: 3.1.0 info: title: Forward Model scores API version: 1.0.0 description: >- Today's published Forward Model stock scores. One set per trading day, published before the US market opens (usually by 9:00 a.m. Eastern); a day's scores never change, so cache by (symbol, date). Needs a Plus plan and an API key from console.forwardmodel.ai. servers: - url: https://api.forwardmodel.ai security: - bearer: [] paths: /v1/scores: get: 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. operationId: getScores parameters: - 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 example: COST,MSFT - 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 - 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 responses: '200': description: The scores. headers: X-Request-Id: schema: type: string content: application/json: schema: $ref: '#/components/schemas/Scores' '400': description: 'invalid_input or invalid_date: fix the input named in field.' content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: 'unauthenticated or key_revoked: a valid key is needed.' content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: >- plan_required: needs Plus, or the date is older than the plan covers. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: >- limit_reached (wait until resets_at) or rate_limited (wait retry_after_seconds). content: application/json: schema: $ref: '#/components/schemas/Error' headers: Retry-After: schema: type: integer description: >- Seconds to wait before retrying (rate_limited, model_unavailable). '500': description: 'server_error: retry once.' content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: 'model_unavailable: retry after retry_after_seconds.' content: application/json: schema: $ref: '#/components/schemas/Error' headers: Retry-After: schema: type: integer description: >- Seconds to wait before retrying (rate_limited, model_unavailable). components: schemas: Scores: type: object required: - date - entries - not_scored - of - scores_left_words properties: date: type: string description: The trading day of these scores. format: date of: type: integer description: How many stocks were scored that day. entries: type: array items: $ref: '#/components/schemas/Entry' not_scored: type: array items: $ref: '#/components/schemas/NotScored' 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. Error: 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 message: type: string description: What happened, in plain words. request_id: type: string description: Quote it to support. field: type: string description: The input that was wrong. retry_after_seconds: type: integer resets_at: type: - string - '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. Entry: type: object required: - symbol - name - date - score - band - top_pct properties: symbol: type: string description: The ticker. name: type: string description: The company. date: type: string description: The trading day of the score. format: date context_through: type: - string - '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. scored_at: type: - string - 'null' description: >- When the stock was scored. ISO 8601 to the minute, e.g. 2026-11-16T07:14-05:00. set_at: type: - string - 'null' description: >- When the day's scores were locked and published. ISO 8601 to the minute, e.g. 2026-11-16T07:14-05:00. 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. out_of: type: number const: 10 band: type: string enum: - Strong - Above average - Middle - Below average - Weak top_pct: type: integer minimum: 1 maximum: 100 description: 35 means the top 35% of the day's scores. summary: type: - string - 'null' description: One line on the stock. for: type: array items: type: string description: Main points for. May be empty. against: type: array items: type: string description: Main points against. May be empty. watch: type: array items: type: string description: Things to watch. Often empty. graded_after_trading_days: type: integer const: 21 notice: type: string description: Show this line with any score you display. NotScored: type: object required: - symbol - reason properties: symbol: type: string description: The ticker asked for. reason: type: string description: Why there's no score, for example a fund or ETF. securitySchemes: bearer: type: http scheme: bearer description: An API key from console.forwardmodel.ai, starting fm_live_. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.