BoothCheck Dilution Facts API

openapi: 3.2.0
info:
  title: boothcheck Dilution Facts 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: Dilution Facts
paths:
  /dilution-facts:
    get:
      operationId: get_dilution_facts
      summary: Share issuance capacity (filed facts)
      description: 'Can this company issue new shares? Filed facts from SEC EDGAR for a US ticker: shelf registrations (S-3/F-3, incl. automatic shelves) with effective date, three-year mark (Rule 415(a)(5)) and status; the 424B prospectus supplements of the last 24 months (counts for all, the newest 40 listed), each linked to its registration by EDGAR''s own file number where that registration is on file, with what the newest covers say is offered (equity, debt, convertible, at-the-market program, resale, headline amount) quoted from the filing; other share registrations (S-1, S-4, S-8); 8-K items 3.02 and 5.03; the as-filed cover-page share count and its 1- and 3-year change (split-like steps flagged); authorized versus outstanding shares; and reported cash against trailing operating cash flow. Never a dilution score, label or forecast. Requires a signed-in Founding Access account API key (Authorization: Bearer bck_...).'
      parameters:
      - name: ticker
        in: query
        required: true
        schema:
          type: string
        description: US stock ticker symbol, e.g. AAOI
      - 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:
      - Dilution Facts
  /dilution-facts/{ticker}:
    get:
      operationId: get_dilution_facts_by_path
      summary: Share issuance capacity (filed facts)
      description: 'Can this company issue new shares? Filed facts from SEC EDGAR for a US ticker: shelf registrations (S-3/F-3, incl. automatic shelves) with effective date, three-year mark (Rule 415(a)(5)) and status; the 424B prospectus supplements of the last 24 months (counts for all, the newest 40 listed), each linked to its registration by EDGAR''s own file number where that registration is on file, with what the newest covers say is offered (equity, debt, convertible, at-the-market program, resale, headline amount) quoted from the filing; other share registrations (S-1, S-4, S-8); 8-K items 3.02 and 5.03; the as-filed cover-page share count and its 1- and 3-year change (split-like steps flagged); authorized versus outstanding shares; and reported cash against trailing operating cash flow. Never a dilution score, label or forecast. Requires a signed-in Founding Access account API key (Authorization: Bearer bck_...).'
      parameters:
      - name: ticker
        in: path
        required: true
        schema:
          type: string
        description: US ticker symbol.
      - 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:
      - Dilution Facts
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.