# Linq Alpha API Docs

## Docs

- [Analytics](https://docs.linqalpha.com/api-reference/basic/analytics-sse.md): Generate an agentic analytics response via Server-Sent Events. This endpoint leverages multi-step reasoning with tool use to deliver deeper, more comprehensive answers compared to the standard search & generate endpoints.
- [Analytics V2](https://docs.linqalpha.com/api-reference/basic/analytics-sse-v2.md): Agentic analytics with structured source selection, hard/soft filters, and identity fields.
- [Analytics V2 Judge](https://docs.linqalpha.com/api-reference/basic/analytics_judge.md): Runs a source-grounding judge over one Analytics answer. You supply the answer's `chat_message_id` plus your own judging `prompt` (and an optional `response_schema`); we resolve the original prompt, the generated answer, and every reference the answer cited, run a tool-less GPT-4.1 over them, and re…
- [Analytics V2 References](https://docs.linqalpha.com/api-reference/basic/analytics_references.md): Retrieves the list of evidence references (citations) used in an analytics conversation, in normalized format with enriched metadata.
- [Batch Presigned URLs](https://docs.linqalpha.com/api-reference/basic/batch_presigned_urls.md): Generates temporary presigned URLs for multiple documents in a single request.
- [Batch Presigned URLs V2](https://docs.linqalpha.com/api-reference/basic/batch_presigned_urls_v2.md): Generates temporary presigned URLs for multiple documents. Supports both external documents and RMS documents via the `search_type` parameter.
- [Chat Message](https://docs.linqalpha.com/api-reference/basic/chat_message.md): Retrieves a specific chat message by its ID.
- [Chat](https://docs.linqalpha.com/api-reference/basic/chat_v2.md): Generate a response from the LinqAlpha engine. LinqAlpha uses different types of language models and data sources to generate an answer. The response is provided as a server-sent events (SSE) stream.
- [Customer Connectors](https://docs.linqalpha.com/api-reference/basic/connectors.md): Lists customer MCP connectors for the authenticated organization. Query parameters are used to filter the results.
- [Conversation Feedback](https://docs.linqalpha.com/api-reference/basic/conversation_feedback.md): Submits feedback for a specific conversation. Use this endpoint to collect user ratings and comments about the quality of AI responses. Feedback helps improve the service and can be used for quality monitoring.
- [Delete Conversation Feedback](https://docs.linqalpha.com/api-reference/basic/delete_conversation_feedback.md): Deletes feedback for a specific conversation. If `message_id` is not provided, the feedback from the last message in the conversation will be deleted.
- [Map Tickers](https://docs.linqalpha.com/api-reference/basic/map_tickers.md): Accepts a list of ticker strings via query parameters and returns their corresponding stock IDs (BBG IDs).
- [LinqAlpha MCP](https://docs.linqalpha.com/api-reference/basic/mcp.md): LinqAlpha MCP gives AI assistants direct access to institutional-grade financial data for fundamental research. Through the Model Context Protocol (MCP), your AI can query company fundamentals, earnings estimates, stock prices, economic indicators, SEC filings, and earnings transcripts — all from a…
- [Presigned URL](https://docs.linqalpha.com/api-reference/basic/presigned_url.md): Generates a temporary presigned URL for secure access to the original document file.
- [Presigned URL V2](https://docs.linqalpha.com/api-reference/basic/presigned_url_v2.md): Generates a temporary presigned URL for secure access to a document file. Supports both external documents (filings, transcripts, news) and RMS documents (Third Bridge transcripts, internal notes, EDS content).
- [References](https://docs.linqalpha.com/api-reference/basic/references.md): Retrieves evidence references for a specific chat message. Each reference corresponds to an exact chunk used in the final answer generated by the LinqAlpha engine. These chunks represent the precise portions of documents (e.g., filings, transcripts, or news) that were retrieved and cited by the mode…
- [References (v2)](https://docs.linqalpha.com/api-reference/basic/references_v2.md): Retrieves the list of evidence references (citations) used in a conversation.
- [Search](https://docs.linqalpha.com/api-reference/basic/search.md): LinqAlpha uses multiple data sources and retrieval methods to find the most relevant documents or information based on a query. Unlike the generate endpoint, this API only performs the search step and returns matched results without generating a response.
- [Stop Stream](https://docs.linqalpha.com/api-reference/basic/stop_stream.md): Pause the RMS (Research Management System) chat stream.
- [TTSQL](https://docs.linqalpha.com/api-reference/basic/ttsql.md): Converts natural language query to SQL, executes it, and returns results in markdown format
- [Create Briefing Schedule](https://docs.linqalpha.com/api-reference/briefing/create.md): Create a new briefing with topic, tickers, and schedule in a single call.
- [Delete Briefing Schedule](https://docs.linqalpha.com/api-reference/briefing/delete.md): Delete an existing briefing schedule.
- [List Deliveries](https://docs.linqalpha.com/api-reference/briefing/deliveries.md): Retrieve delivery history for a specific briefing.
- [Get Delivery Detail](https://docs.linqalpha.com/api-reference/briefing/delivery-detail.md): Retrieve full delivery detail including briefing content. Also available at /v1/briefings/{id}/deliveries/{delivery_id}.
- [Get Delivery References](https://docs.linqalpha.com/api-reference/briefing/delivery-references.md): Retrieves the full list of citation references (sources) used to generate a briefing delivery.
- [List Briefing Schedules](https://docs.linqalpha.com/api-reference/briefing/list.md): Retrieve all briefing schedules for the authenticated user.
- [Preview Briefing On-Demand](https://docs.linqalpha.com/api-reference/briefing/preview.md): Run a briefing on-demand from an ad-hoc prompt as a fire-and-forget job: enqueue the run and get a pending delivery handle immediately, then poll `GET /v1/briefings/deliveries/{delivery_id}` for the result.
- [Update Briefing Schedule](https://docs.linqalpha.com/api-reference/briefing/update.md): Update an existing briefing. All fields are optional.
- [Create Organization](https://docs.linqalpha.com/api-reference/rms/create_organization.md): Creates a new organization with the specified parameters.
- [Create Source](https://docs.linqalpha.com/api-reference/rms/create_source.md): Registers a previously-uploaded file as a document source under a source batch and queues it for asynchronous parsing. Once `status: "success"`, the source is searchable in chat/search conversations that reference its `source_batch_id`.
- [Create Source Batch](https://docs.linqalpha.com/api-reference/rms/create_source_batch.md): Creates a new source batch container for organizing and managing related document sources. A source batch acts as a logical grouping that must be created before uploading any sources. The returned `source_batch_id` is required when creating sources and can be used to reference all contained sources…
- [RMS Chat](https://docs.linqalpha.com/api-reference/rms/rms_chat.md): Generate a response using the RMS (Research Management System) with streaming server-sent events. This endpoint provides enhanced search capabilities with organization-specific data and customizable document types.
- [RMS Deep Research](https://docs.linqalpha.com/api-reference/rms/rms_deep_research.md): Generate a response using the RMS (Research Management System) with deep research capabilities. This endpoint provides enhanced search capabilities with organization-specific data and customizable document types.
- [Source](https://docs.linqalpha.com/api-reference/rms/source.md): Retrieves the current processing status of an uploaded source. Use this endpoint to poll source readiness before including it in chat or search requests.
- [Get Upload URL](https://docs.linqalpha.com/api-reference/rms/upload_url.md): Returns a presigned S3 PUT URL for direct file upload. Lets clients upload files without managing AWS credentials or staging buckets — the server signs a single-use URL bound to a server-generated S3 object key, the client PUTs the file body to that URL, then registers the upload via `POST /v1/sourc…
- [Container Sync Status](https://docs.linqalpha.com/api-reference/status/containers.md): Returns per-container sync status with direct children IDs. At least one filter (path, name, or container_ids) is required.
- [Document Sync Status](https://docs.linqalpha.com/api-reference/status/documents.md): Returns per-document sync status. At least one filter (path, name, or document_ids) is required.
- [Organization Sync Status](https://docs.linqalpha.com/api-reference/status/sync.md): Returns an overview of the sync status for your organization, including searchable-aware document counts and recent sync job history.
- [Vault — Confirm Upload](https://docs.linqalpha.com/api-reference/vault/confirm.md): Step 3 of the Vault upload flow. Registers the uploaded file in RMS and triggers async ingestion (parse → chunk → embed → index), returning immediately with the rms_document_id. Poll GET /v2/vault/status for processing status / readiness.
- [Vault — Get Upload URL](https://docs.linqalpha.com/api-reference/vault/presigned_url.md): Step 1 of the Vault upload flow. Returns a single-use presigned upload (PUT) URL. Upload the file directly to that URL, then register it via POST /v2/vault/confirm.
- [Vault — Document Status](https://docs.linqalpha.com/api-reference/vault/status.md): Returns the processing status for one or more vault documents. Poll after confirm until status is `Synced` (complete and searchable).
- [Quickstart](https://docs.linqalpha.com/quickstart.md)

## OpenAPI Specs

- [openapi](https://docs.linqalpha.com/api-reference/openapi.json)

## Optional

- [Website](https://linqalpha.com)