---
title: "Ask"
method: POST
path: "/ask"
tags: ["ask"]
---

# Ask

`POST /ask`

## Request

- Base URL: `https://api.tickertrac.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tickertrac.com/ask`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Request body

- AskRequest
  - `question` string, required
  - `ticker` string, nullable
  - `watchlist_id` integer, nullable
  - `section` string, nullable
  - `top_k` integer
  - `embedding_model` 'voyage-4' | 'voyage-finance-2'
  - `source_scope` 'all' | 'filings' | 'calls'
  - `transcript_section` 'all' | 'prepared_remarks' | 'questions_and_answers'
  - `speaker_role` 'all' | 'executive' | 'analyst'

## Response `200`

Successful Response

- AskResponse
  - `text` string, required
  - `sources` SourceChunk[], required
    - `source_type` 'filing' | 'earnings_call' | 'disclosure'
    - `ticker` string, required
    - `section` string, required
    - `fiscal_period` string, required
    - `filed_date` string, date, nullable
    - `event_date` string, date, nullable
    - `published_at` string, date-time, nullable
    - `publication_date_known` boolean, nullable
    - `observed_at` string, date-time, nullable
    - `provider_code` string, nullable
    - `title` string, nullable
    - `speaker_name` string, nullable
    - `speaker_role` 'executive' | 'analyst' | 'operator' | 'other' | 'unknown', nullable
    - `source_locator` string, nullable
    - `source_artifact_version_id` integer, nullable
    - `source_segment_id` integer, nullable
    - `source_chunk_id` integer, nullable
    - `source_document_chunk_id` integer, nullable
    - `source_document_segment_id` integer, nullable
    - `form_type` string, nullable
    - `char_start` integer, nullable
    - `char_end` integer, nullable
    - `page_number` integer, nullable
    - `chunk_index` integer, nullable
    - `source_url` string, required
    - `company_transcript_url` string, nullable
  - `outcome` 'answered' | 'insufficient_evidence'
  - `abstention_reason` 'no_relevant_evidence' | 'insufficient_citation_support' | 'conflicting_evidence' | 'outside_source_coverage', nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tickertrac/apis/tickerrag-api.md) · [All operations](https://skmtc.dev/tickertrac/apis/tickerrag-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickertrac/apis/tickerrag-api/revisions/3c7eb0f6425d?raw)