Skip to main content
POST
Stock Report

How It Works

This endpoint uses async job processing for generating comprehensive stock reports:
  1. Submit Request: POST the stock symbol to /v1/stock-report
  2. Receive Job ID: Get a job ID and polling URL immediately
  3. Poll for Status: Check /v1/jobs/{job_id} until status is completed
  4. Get Report URLs: The completed job contains URLs to PDF, HTML, and JSON reports
Report generation typically takes 5-10 minutes. Reports include financial analysis, valuation metrics, AI-generated insights, and more.

Request Body

If force is false and a recent report exists (generated within the last 30 days), the cached report URLs will be returned immediately.

Response (202 Accepted)

When the job is created:

Completed Response

When the job completes, GET /v1/jobs/{job_id} returns:

Example: Polling for Results

Error Responses

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
symbol
string
required

Stock symbol/RIC identifier

Example:

"AAPL.O"

force
boolean
default:false

Force regeneration even if recent report exists

lang
enum<string>
default:en

Report language: 'en' (default) or 'th' (Thai)

Available options:
en,
th

Response

Job created successfully

Last modified on January 20, 2026