Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: boothcheck Analyst Desk API
version: 1.4.0
description: 'Read-only derived data from SEC filings: what a stock price is betting on (implied growth, duration, margin), research report sections, segment snapshots, peer cohorts, a management guidance track record, risk-factor additions, insider and holder fact registers, and the cross-company analyst desk (one table and deterministic brief across 2 to 25 names, available to signed-in Founding Access accounts). No Boothcheck house fair value, price target, or rating. Informational and research purposes only.'
termsOfService: https://boothcheck.com/api-terms
contact:
url: https://boothcheck.com/developers
servers:
- url: https://boothcheck.com/api/v1
tags:
- name: Analyst Desk
paths:
/analyst-desk:
get:
operationId: analyst_desk
summary: Analyst desk
description: 'One standardized table across 2 to 25 US companies from already-published boothcheck records — the priced-in read (point or worded non-point) with its solve anchor, the delivered record on the same variable, severity, vintages, what changed since each narrative, guidance behavior with the recent 8-quarter window, and risk-factor changes — plus a deterministic research brief naming the largest differences. No model runs, no report is generated, and no fair value, target, rating, or ranking appears. Authenticated account access; paid-mode packaging is documented separately. Requires a signed-in Founding Access account API key (Authorization: Bearer bck_...).'
parameters:
- name: tickers
in: query
required: false
schema:
type: string
description: Comma-separated US tickers, 2 to 25 (e.g. NVDA,AMD,INTC)
- name: setId
in: query
required: false
schema:
type: string
description: A saved company-set id (acs_...) belonging to your account, instead of tickers
- name: format
in: query
required: false
schema:
type: string
enum:
- json
- csv
default: json
description: Response format. CSV requires a signed-in Founding Access account key.
security:
- apiKey: []
responses:
'200':
description: Structured result. Every payload carries an informational-purposes disclaimer; no Boothcheck house fair value, price target, or rating.
'401':
description: Missing or invalid API key for a keyed endpoint.
'404':
description: Ticker not covered or no data for this surface.
'429':
description: Rate limit reached for the key tier.
tags:
- Analyst Desk
components:
securitySchemes:
apiKey:
type: http
scheme: bearer
description: API key (bck_...). Create one from any signed-in Founding Access account at https://boothcheck.com/settings.