> ## Documentation Index > Fetch the complete documentation index at: https://doc.prometheus.services/llms.txt > Use this file to discover all available pages before exploring further. # Guidance scorecard > Per-call scorecard of commitments kept vs missed. ## OpenAPI ````yaml /openapi.json get /api/v1/companies/{id}/earnings/scorecard openapi: 3.1.0 info: title: Prometheus API version: 1.0.0 description: >- Audit-grade financial data: SEC 10-K/10-Q/8-K filings parsed from XBRL into standardized statements where every number links back to its source fact; earnings-call transcripts turned into verified observations and guidance scorecards; a bitemporal (point-in-time) macro cube; benchmark, commodity and compute-price series; and a validated causal claim graph. Tiers: `public` endpoints need no credentials. Everything else takes an **API key** — create one on the Developers page in the terminal (https://www.prometheus.services/developers) and send it as `X-API-KEY: pk_live_...` (or `Authorization: Bearer pk_live_...`). Signed-in terminal sessions may use their Cognito ID token instead. Rate limits and quotas are per plan (fixed UTC windows): Free — 30 req/min, 250 req/day; Build ($200/mo) — 300 req/min, 100,000 req/month; Scale — custom. Responses carry RateLimit-* and X-Quota-* headers; a 429 carries `Retry-After` and a machine `code` of rate_limited or quota_exceeded. Not investment advice. See /terms. contact: email: sales@prometheus.finance termsOfService: https://www.prometheus.services/terms servers: - url: https://www.prometheus.services security: [] tags: - name: Search & Meta description: Entity resolution and platform metadata. - name: Company Data description: Profiles, structure, leadership, calendars. - name: Financial Statements description: >- Standardized XBRL-derived statements — every line traceable to its filing via fact provenance. - name: SEC Filings description: The filing index and parsed section text. - name: 8-K Events description: Material events, typed by family, with extracted item text. - name: Transcripts & Calls description: Earnings-call transcripts, span-anchored observations, IR decks. - name: Guidance & Scorecards description: What management promised vs. what happened. - name: Ownership & Insiders description: 13F holders, Forms 3/4/5, the people registry. - name: Macro description: Point-in-time economic series and central-bank text. - name: Market Data description: Daily bars for stocks, benchmarks, commodities and compute. - name: Intelligence description: Narratives, the validated claim graph, scenario simulation. - name: Analytics description: Correlation and charting over any catalog series. paths: /api/v1/companies/{id}/earnings/scorecard: get: tags: - Guidance & Scorecards summary: Guidance scorecard description: Per-call scorecard of commitments kept vs missed. operationId: get-guidance-scorecard parameters: - name: id in: path required: true description: >- Ticker symbol (e.g. NVDA) or numeric SEC CIK (zero-padding optional). schema: type: string responses: '200': description: OK content: application/json: schema: type: object additionalProperties: true example: ticker: NVDA predictions: - observationId: 3637 stdKey: gross_margin periodicity: quarterly targetPeriodEnd: '2026-04-30' guidedLow: 74.4 guidedHigh: 75.4 guidedUnit: percent realizedValue: 74.9335 realizedPeriodEnd: '2026-04-26' withinRange: true midpointErrorRel: 0.000447 speakerName: Colette Kress speakerRole: executive changeBasis: level reaffirmCount: 0 revisionSeq: 0 firstObservedAt: '2026-02-25' horizonDays: 64 evidence: observationId: 3637 quote: >- GAAP and non-GAAP gross margins are expected to be 74.9% and 75%, respectively, plus or minus 50 bas… statement: >- NVIDIA expects Q1 FY2027 GAAP gross margin to be 74.9%, plus or minus 50 basis points. speakerName: Colette Kress speakerRole: executive ticker: NVDA companyName: NVIDIA Corporation observedAt: '2026-02-25' observationType: metric direction: null verificationStatus: supported documentId: 735 transcriptExternalId: '20595' transcriptDate: '2026-02-25' fiscalLabel: Q4 FY2026 - observationId: 3638 stdKey: gross_margin_non_gaap periodicity: quarterly targetPeriodEnd: '2026-04-30' guidedLow: 74.5 guidedHigh: 75.5 guidedUnit: percent realizedValue: 75 realizedPeriodEnd: '2026-04-26' withinRange: true midpointErrorRel: 0 speakerName: Colette Kress speakerRole: executive changeBasis: level reaffirmCount: 0 revisionSeq: 0 firstObservedAt: '2026-02-25' horizonDays: 64 evidence: observationId: 3638 quote: >- GAAP and non-GAAP gross margins are expected to be 74.9% and 75%, respectively, plus or minus 50 bas… statement: >- NVIDIA expects Q1 FY2027 non-GAAP gross margin to be 75%, plus or minus 50 basis points. speakerName: Colette Kress speakerRole: executive ticker: NVDA companyName: NVIDIA Corporation observedAt: '2026-02-25' observationType: metric direction: null verificationStatus: supported documentId: 735 transcriptExternalId: '20595' transcriptDate: '2026-02-25' fiscalLabel: Q4 FY2026 aggregate: 'n': 78 hits: 40 hitRate: 0.5128205128205128 sufficient: true avgAbsError: 0.03925760256410256 above: 54 below: 21 speakers: 1 metrics: 6 tracked: 824 funnel: tracked: 824 reconciled: 88 verified: 78 held: 7 speakerFunnels: Colette Kress: tracked: 544 reconciled: 88 verified: 78 held: 7 Jen-Hsun Huang: tracked: 166 reconciled: 0 verified: 0 held: 0 Jensen Huang;Co-Founder, CEO, President & Director: tracked: 113 reconciled: 0 verified: 0 held: 0 Simona Stefan Jankowski: tracked: 1 reconciled: 0 verified: 0 held: 0 speakerCiks: Colette Kress: '0001588670' Jen-Hsun Huang: '0001197649' Jensen Huang: '0001197649' corpus: predictions: 527 issuers: 10 metrics: 22 caveats: - >- A verdict compares the reported figure to the range management themselves gave. It is not a comparis… - >- Realized figures are GAAP as filed. Guidance stated on an adjusted or non-GAAP basis is deliberately… '400': description: Invalid parameter. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Unknown company, country, symbol or resource. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limited. Honour Retry-After. content: application/json: schema: $ref: '#/components/schemas/Error' security: - apiKey: [] - cognitoIdToken: [] components: schemas: Error: type: object required: - error properties: error: type: string description: Human-readable message. code: type: string description: >- Stable machine code when present: unauthenticated, upgrade_required, rate_limited, quota_exceeded. enum: - unauthenticated - upgrade_required - rate_limited - quota_exceeded securitySchemes: apiKey: type: apiKey in: header name: X-API-KEY description: >- Prometheus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as `Authorization: Bearer pk_live_...`. x-default: pk_live_YOUR_KEY cognitoIdToken: type: http scheme: bearer bearerFormat: JWT description: >- Amazon Cognito ID token (token_use=id) for the Prometheus user pool — the terminal's own session credential. API consumers should use an API key instead. ````