Add to Watchlist
add_to_watchlistFull Description
Add companies to a watchlist
Parameters (2 required)
companyIdsarrayCompany IDs to add
watchlistIdnumberWatchlist ID. Use 0 to follow companies.
Access structured first-party IR data from over 14,500+ public companies across 65 markets. Quartr delivers live and recorded earnings calls, real-time and historical transcripts with speaker identification, slide presentations, filings, reports, and event summaries. Best-in-class reliability and timeliness. Ideal for financial research, investment analysis, and building data-driven workflows on top of institutional-grade public company data.
add_to_watchlistAdd companies to a watchlist
companyIdsarrayCompany IDs to add
watchlistIdnumberWatchlist ID. Use 0 to follow companies.
create_folderCreate a new saved clips folder
namestringFolder name
visibilitystringFolder visibility (default: private)
privateteamcreate_keywordCreate a keyword alert. Supports scoping to all companies, followed companies, specific watchlists, specific companies, or followed-plus-watchlists.
companySettingstringScope of companies to monitor. 'all' = every company. 'followed' = only companies the user follows. 'watchlists' = only companies in the supplied watchlists (requires watchlistIds). 'companies' = only the supplied companies (requires companyIds). 'followedAndWatchlists' = followed companies plus the supplied watchlists (requires watchlistIds).
allfollowedwatchlistscompaniesfollowedAndWatchlistsnamestringThe keyword to monitor
companyIdsarrayCompany IDs. Required when companySetting is 'companies'. Use search_companies to find IDs.
documentTypesarrayOptional document types to restrict alerts (slides, report, transcript).
eventTypeIdsarrayEvent type IDs to restrict alerts to. Omit or pass an empty array to monitor all event types — do not list every event type ID to mean 'all'.
watchlistIdsarrayWatchlist IDs. Required when companySetting is 'watchlists' or 'followedAndWatchlists'. Use list_watchlists to find IDs.
create_search_filterCreate a saved search filter
namestringFilter name
companyIdsarraySpecific company IDs
countriesarrayISO country codes (e.g., "US", "SE")
eventTypesarrayEvent type names in snake_case (e.g., earnings_call)
gicsarrayGICS sector/industry codes (use list_gics to find codes)
marketCapCategoriesarrayMarket cap size filter
create_watchlistCreate a new watchlist
namestringName for the new watchlist
companyIdsarrayCompany IDs to add initially
create_workspaceCreate a new workspace
namestringWorkspace name
visibilitystringWorkspace visibility (default: private)
privateteamdelete_folderDelete a saved clips folder
folderIdnumberFolder ID to delete
delete_keywordDelete a keyword alert
keywordIdnumberKeyword ID to delete
delete_search_filterDelete a saved search filter
filterIdnumberFilter ID to delete
delete_watchlistDelete a watchlist
watchlistIdnumberWatchlist ID to delete (cannot delete followed companies list, id 0)
delete_workspaceDelete a workspace
workspaceIdnumberWorkspace ID to delete
get_companyGet a company's full profile
companyIdnumberCompany ID
get_conferenceGet a conference and its events — title, dates, type, and the events that took place under it (each with its company, date, and one-line summary). Use the returned event IDs with get_event, get_event_summary, or read_document to dig into transcripts and reports.
conferenceIdnumberConference (event group) ID
get_current_userGet information about the currently signed-in user, including name, email, and subscription. Available regardless of subscription status.
get_document_summaryGet a Quartr summary of a document (transcript, report, or slides). summary is null when no summary exists for the document.
documentIdnumberDocument ID
get_eventGet details for a specific event
eventIdnumberEvent ID
get_event_summaryGet a Quartr summary of an event, covering all attached documents. summary is null when no summary exists for the event.
eventIdnumberEvent ID
get_financialsGet financial statements (income statement, balance sheet, cash flow) for a company. Each metric includes extraction source details (bounding box, page number) that can be used as the reference query parameter when linking to the report page on Quartr.
companyIdnumberCompany ID
endDatestringEnd date (ISO 8601, e.g., "2025-01-01"), default today
financialTypestringStatement type filter
incomeStatementbalanceSheetcashFlowStatementperiodTypestringReporting period granularity
quarterlyhalfYearyearlyperiodicalquarterlystartDatestringStart date (ISO 8601, e.g., "2023-01-01"), default 2 years ago
get_watchlistGet a watchlist with its companies
watchlistIdnumberWatchlist ID
list_companiesList companies with optional filters. Results are paginated (default 20 per page). Use page/perPage params to navigate.
countriesarrayISO country codes (e.g., US, SE)
gicsarrayGICS sector or industry name
marketCapsarrayMarket cap size filter
pageintegerPage number (default: 1)
perPageintegerResults per page (default: 20, max: 100)
statusarrayCompany status filter
list_conferencesList investor / industry conferences. Conferences group related events from multiple companies (e.g. JPMorgan Healthcare Conference, Citi Tech Conference). Supports filtering by date range, organizer company, and title search. Sorted by start date (newest first). Use get_conference to fetch a conference's events.
afterstringOpaque cursor from a previous page's pagination.endCursor.
endDatestringISO 8601 calendar date — return conferences on/before.
limitnumberMax results (default 25, max 100).
organizerCompanyIdnumberFilter by organizing company ID (e.g. JPMorgan's company ID for the JPMorgan Healthcare Conference), or null.
querystringFree-text title search (e.g. 'healthcare'), or null.
startDatestringISO 8601 calendar date — return conferences on/after.
list_documentsList documents for a company
companyIdnumberCompany ID
documentTypesarrayDocument types to filter by
endDatestringEnd date (ISO 8601, e.g., "2025-01-01")
limitnumberMax results (default 50, max 200)
startDatestringStart date (ISO 8601, e.g., "2024-01-01")
list_event_typesList all event types
list_eventsList events for a company or watchlist. At least one of companyId or watchlistId is required; if both are passed, results are filtered by both.
expandarrayAllowlist of nested fields to include in each event. Always an array (or null). null = include all nested fields (default). [] = core fields only. [field, ...] = include only the listed fields. Available fields: documents, contentDates, expectedContent, liveTranscript.
companyIdnumberFilter by company ID. At least one of companyId or watchlistId is required.
endDatestringReturn events before this date/time, exclusive. ISO 8601 date (YYYY-MM-DD, e.g. "2025-01-01") or, for hour-level cutoffs, datetime with explicit timezone ("2025-01-01T12:00:00Z" or "2025-01-01T12:00:00+02:00").
eventTypesarrayEvent type names to filter by
limitnumberMax results (default 50, max 200)
orderstringSort order by date (default desc)
ascdescstartDatestringReturn events after this date/time, exclusive. ISO 8601 date (YYYY-MM-DD, e.g. "2024-01-01") or, for hour-level cutoffs, datetime with explicit timezone ("2024-01-01T12:00:00Z" or "2024-01-01T12:00:00+02:00").
watchlistIdnumberFilter by watchlist ID. At least one of companyId or watchlistId is required.
list_foldersList the user's saved clips folders
list_gicsList GICS classification hierarchy
list_keywordsList the user's keyword alerts
list_related_companiesFind related companies (peers, competitors)
companyIdnumberCompany ID
list_search_filtersList the user's saved search filters
list_watchlistsList the user's watchlists
list_workspacesList the user's workspaces
querystringSearch/filter workspaces by name
visibilitystringFilter by visibility. Omit to include both private and team workspaces.
privateteamread_documentRead a document (report, slide deck, or transcript). Pass documentId for a specific document, or eventId to read the best available transcript for an event (falls back to the live transcript when no indexed transcript is available yet — transcriptSource is "live" in that case). structuredContent.pages[] contains each paragraph/page with its text and a deep-link url (timestamped for transcripts, page-numbered for slides/reports).
documentIdnumberDocument ID (slide, report, or transcript).
eventIdnumberEvent ID — reads the best available transcript for the event.
formatstringShape of `structuredContent.pages[]`. Both formats include the per-page/paragraph `text` (and `speakerName`/`speakerRole` for transcripts). `compact` (default) omits the per-page deep-link `url` — clients build URLs from `pageUrlTemplate`. `verbose` includes a `url` on every page (useful for human-facing UIs). The rendered markdown view is always in `content[0].text` for non-structured-aware clients.
compactverbosemaxPagesnumberMaximum pages to return (default: all). Use for large documents to limit response size.
read_live_transcriptRead the live transcript for an ongoing or recently completed event. Use fromTimestamp to fetch only new content since your last call. Each paragraphs[i] carries text and a timestamped deep-link url.
eventIdnumberThe event ID to fetch the live transcript for.
fromTimestampnumberOnly return paragraphs that start after this timestamp (in seconds). Use null or omit to get the full transcript. Use this to fetch new content since your last read.
read_workspaceRead a workspace's properties and content
workspaceIdnumberWorkspace ID to read
remove_from_watchlistRemove companies from a watchlist
companyIdsarrayCompany IDs to remove
watchlistIdnumberWatchlist ID. Use 0 to unfollow companies.
rename_folderRename a saved clips folder
folderIdnumberFolder ID to rename
namestringNew folder name
rename_watchlistRename a watchlist
namestringNew name for the watchlist
watchlistIdnumberWatchlist ID (cannot rename followed companies list, id 0)
search_companiesSearch for companies by name or ticker symbol
querystringCompany name or ticker (e.g., "Apple", "AAPL")
search_documentsFull-text search across transcripts, slides, and reports
documentTypesarrayDocument types to search
querystringKeyword search query. Max 10 words and 128 characters per OR-separated sub-query (a quoted phrase counts as one word). Supports: implicit AND, OR, * wildcard, -exclusion, `exact phrase`. Example: "`artificial intelligence` revenue growth"
endDatestringFilter up to this date/time. ISO 8601 date (YYYY-MM-DD) or, for hour-level cutoffs, datetime with explicit timezone (e.g. 2026-06-02T12:00:00Z or 2026-06-02T12:00:00+02:00).
filingTypesarrayFiling type filter (reports only)
filterstringTypesense filter expression. Fields: companyId, eventId, eventTypeId, country, gics.level1-4, marketCapCategory.name. Transcript-only: speaker.role, speaker.name. Example: country:=[US, SE] && gics.level1:=["Information Technology"]
limitnumberMax results (default 25, max 100)
startDatestringFilter from this date/time onwards. ISO 8601 date (YYYY-MM-DD) or, for hour-level cutoffs, datetime with explicit timezone (e.g. 2026-06-02T12:00:00Z or 2026-06-02T12:00:00+02:00).
tag_company_to_workspaceTag a company to a workspace
companyIdnumberCompany ID to tag
workspaceIdnumberWorkspace ID
untag_company_from_workspaceRemove a company tag from a workspace
tagIdnumberTag ID to remove (returned from tag_company_to_workspace)
workspaceIdnumberWorkspace ID
update_keywordUpdate a keyword alert. Supports scoping to all companies, followed companies, specific watchlists, specific companies, or followed-plus-watchlists.
companySettingstringScope of companies to monitor. 'all' = every company. 'followed' = only companies the user follows. 'watchlists' = only companies in the supplied watchlists (requires watchlistIds). 'companies' = only the supplied companies (requires companyIds). 'followedAndWatchlists' = followed companies plus the supplied watchlists (requires watchlistIds).
allfollowedwatchlistscompaniesfollowedAndWatchlistskeywordIdnumberKeyword ID to update
namestringUpdated keyword text
companyIdsarrayCompany IDs. Required when companySetting is 'companies'. Use search_companies to find IDs.
documentTypesarrayOptional document types to restrict alerts (slides, report, transcript).
eventTypeIdsarrayEvent type IDs to restrict alerts to. Omit or pass an empty array to monitor all event types — do not list every event type ID to mean 'all'.
watchlistIdsarrayWatchlist IDs. Required when companySetting is 'watchlists' or 'followedAndWatchlists'. Use list_watchlists to find IDs.
write_workspaceEdit a workspace document body from Markdown, either appending content to the end or overwriting it entirely (controlled by mode). The edit lands live for any connected user. A snapshot of the prior state is automatically taken so the user can revert via the workspace's version history.
markdownstringDocument content as Markdown — the same format returned by read_workspace. Supports headings, paragraphs, bold/italic/links/inline code, blockquotes, and bullet/ordered/nested lists.
modestring`append` adds content to the end of the document body. `overwrite` replaces the entire body. Prefer `append` unless the user asked for a full rewrite.
appendoverwriteworkspaceIdnumberWorkspace ID to write to