{"openapi":"3.0.3","info":{"title":"Fintel Public Data API","version":"1.0.0","description":"Fintel Public Data API (/v1). Internal-only surface under active development; endpoints are promoted to public availability individually after legal, product, data-quality, operational, and billing readiness gates pass.\n\n## Authentication\n\nAll `/v1` API requests require an API key. Send the key in the `X-API-KEY` request header:\n\n```http\nX-API-KEY: YOUR_API_KEY\n```\n\nIn Swagger UI, click **Authorize**, enter your API key, and then use **Try it out**. If the key is missing, invalid, or revoked, the API returns `401 Unauthorized` with `WWW-Authenticate: ApiKey realm=\"fintel-api\"`."},"servers":[{"url":"https://api.fintel.io","description":"Public REST API"}],"tags":[{"name":"Security Master & Reference","description":"Securities, profiles, and identifier lookup."},{"name":"Market Data / Prices","description":"End-of-day price bars."},{"name":"Account & Application State","description":"Manage the authenticated user's own application state: stock lists (watchlists) and alerts."},{"name":"Teams & Collaboration","description":"API-user-facing team and collaboration endpoints: team membership, shared stock lists / documents, and discussion topics. These are for API/MCP clients and integrations; the agentic message-board product workflow is owned by the message-board service in fintel-web."},{"name":"Ownership & 13F","description":"Institutional ownership (SEC 13F-derived) of a security."},{"name":"Insider Transactions","description":"Reported insider (SEC Form 3/4/5-derived) transactions for a security."},{"name":"Short Interest & Borrow","description":"Exchange-reported short interest (NYSE/NASDAQ-derived) for a security."},{"name":"Fundamentals","description":"Dividends, earnings, and financial data points."},{"name":"Analyst Estimates","description":"Price targets, ratings, and analyst forecasts."},{"name":"Data Definitions","description":"Searchable catalog of data attributes and metrics."}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"Authenticate requests by providing your Fintel API key in the `X-API-KEY` header. In Swagger UI, click **Authorize**, paste your API key, and then use **Try it out**. Requests with a missing, invalid, or revoked key return `401 Unauthorized` with `WWW-Authenticate: ApiKey realm=\"fintel-api\"`. The legacy `auth` header may be accepted for compatibility, but `X-API-KEY` is the preferred header."}}},"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/securities":{"get":{"operationId":"searchSecurities","summary":"Search securities","description":"Search the security master by ticker symbol (exact), company/security name (prefix), or an exact external identifier (CUSIP, ISIN, or FIGI). Returns active securities.","tags":["Security Master & Reference"],"x-fintel-api-family":"Security Master & Reference","x-fintel-scope":"securities:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.search_securities","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"query","in":"query","description":"Search term: ticker symbol, company/security name prefix, CUSIP, ISIN, or FIGI.","required":true,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Optional ISO country code filter, e.g. US.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Optional max results (1-100, default 25).","required":false,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}":{"get":{"operationId":"getSecurity","summary":"Get security profile","description":"Get the security master profile for a security identified by country and symbol, including the expanded security_identifiers history and security_listings across other exchanges.","tags":["Security Master & Reference"],"x-fintel-api-family":"Security Master & Reference","x-fintel-scope":"securities:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_security","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}}]}},"/v1/identifiers/{type}/{value}":{"get":{"operationId":"lookupIdentifier","summary":"Look up identifier","description":"Resolve an external identifier (cusip, isin, ticker, id) to a security profile, including its expanded security_identifiers and security_listings.","tags":["Security Master & Reference"],"x-fintel-api-family":"Security Master & Reference","x-fintel-scope":"securities:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.lookup_identifier","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"type","in":"path","description":"Identifier type: cusip, isin, ticker, or id.","required":true,"schema":{"type":"string"}},{"name":"value","in":"path","description":"Identifier value to resolve.","required":true,"schema":{"type":"string"}}]}},"/v1/countries":{"get":{"operationId":"listCountries","summary":"List countries","description":"List the distinct countries for which the security master has active securities, each with a count of securities in that country.","tags":["Security Master & Reference"],"x-fintel-api-family":"Security Master & Reference","x-fintel-scope":"securities:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_countries","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}}}},"/v1/countries/{countryCode}":{"get":{"operationId":"listCountrySecurities","summary":"List securities in a country","description":"List the active securities within a given country (by ISO country code).","tags":["Security Master & Reference"],"x-fintel-api-family":"Security Master & Reference","x-fintel-scope":"securities:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_country_securities","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"countryCode","in":"path","description":"ISO country code, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Optional page size (1-500, default 100).","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Optional 1-based page number (default 1).","required":false,"schema":{"type":"string"}}]}},"/v1/exchanges":{"get":{"operationId":"listExchanges","summary":"List exchanges","description":"List the distinct exchanges for which the security master has active securities, each with a count of securities listed on that exchange.","tags":["Security Master & Reference"],"x-fintel-api-family":"Security Master & Reference","x-fintel-scope":"securities:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_exchanges","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}}}},"/v1/exchanges/{exchangeCode}":{"get":{"operationId":"listExchangeSecurities","summary":"List securities on an exchange","description":"List the active securities listed on a given exchange (by exchange code).","tags":["Security Master & Reference"],"x-fintel-api-family":"Security Master & Reference","x-fintel-scope":"securities:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_exchange_securities","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"exchangeCode","in":"path","description":"Exchange code, e.g. NASDAQ.","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Optional page size (1-500, default 100).","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Optional 1-based page number (default 1).","required":false,"schema":{"type":"string"}}]}},"/v1/countries/{countryCode}/securities":{"get":{"operationId":"listCountrySecuritiesByCountry","summary":"List securities in a country","description":"List the active securities within a given country (by ISO country code). Clearer alias of GET /v1/countries/{countryCode} with identical behavior.","tags":["Security Master & Reference"],"x-fintel-api-family":"Security Master & Reference","x-fintel-scope":"securities:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_country_securities","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"countryCode","in":"path","description":"ISO country code, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Optional page size (1-500, default 100).","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Optional 1-based page number (default 1).","required":false,"schema":{"type":"string"}}]}},"/v1/exchanges/{exchangeCode}/securities":{"get":{"operationId":"listExchangeSecuritiesByExchange","summary":"List securities on an exchange","description":"List the active securities listed on a given exchange (by exchange code). Clearer alias of GET /v1/exchanges/{exchangeCode} with identical behavior.","tags":["Security Master & Reference"],"x-fintel-api-family":"Security Master & Reference","x-fintel-scope":"securities:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_exchange_securities","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"exchangeCode","in":"path","description":"Exchange code, e.g. NASDAQ.","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Optional page size (1-500, default 100).","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Optional 1-based page number (default 1).","required":false,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/eod":{"get":{"operationId":"getPriceBars","summary":"Get end-of-day price bars","description":"Get end-of-day (EOD) adjusted daily price bars for a security.","tags":["Market Data / Prices"],"x-fintel-api-family":"Market Data / Prices","x-fintel-scope":"prices:eod","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_price_bars","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}},{"name":"period","in":"query","description":"Lookback window: 1m, 3m, 6m, 1y (default), 2y, 3y, 5y, all.","required":false,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/owners":{"get":{"operationId":"getSecurityOwners","summary":"Get institutional owners","description":"Get the current institutional owners (SEC 13F-derived) of a security.","tags":["Ownership & 13F"],"x-fintel-api-family":"Ownership & 13F","x-fintel-scope":"ownership:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_security_owners","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/insiders":{"get":{"operationId":"getSecurityInsiders","summary":"Get insider transactions","description":"Get reported insider (SEC Form 3/4/5-derived) transactions for a security.","tags":["Insider Transactions"],"x-fintel-api-family":"Insider Transactions","x-fintel-scope":"insiders:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_security_insiders","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}},{"name":"count","in":"query","description":"Optional maximum number of transactions to return.","required":false,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/short-interest":{"get":{"operationId":"getShortInterest","summary":"Get short interest","description":"Get the trailing-year exchange-reported short interest (NYSE/NASDAQ-derived) for a security. This data set has limited availability and is disabled for general use; it must be enabled per account before it can be accessed.","tags":["Short Interest & Borrow"],"x-fintel-api-family":"Short Interest & Borrow","x-fintel-scope":"shorts:interest","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_short_interest","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but the short interest data set is not enabled for this account (not_entitled). This data set has limited availability and must be enabled per account before it can be accessed."},"404":{"description":"The requested resource was not found."}},"x-fintel-requires-entitlement":true,"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/borrow-rate":{"get":{"operationId":"getBorrowRate","summary":"Get borrow rate & shares available","description":"Get the latest securities-lending borrow rate for a security, including the fee rate, rebate rate, and the number of shares available to borrow.","tags":["Short Interest & Borrow"],"x-fintel-api-family":"Short Interest & Borrow","x-fintel-scope":"shorts:borrow","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_borrow_rate","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/short-volume":{"get":{"operationId":"getShortVolume","summary":"Get short volume","description":"Get the trailing-year daily short-sale volume (NYSE/NASDAQ-derived) for a security, including short volume, short-exempt volume, and total volume.","tags":["Short Interest & Borrow"],"x-fintel-api-family":"Short Interest & Borrow","x-fintel-scope":"shorts:volume","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_short_volume","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/fails-to-deliver":{"get":{"operationId":"getFailsToDeliver","summary":"Get fails-to-deliver","description":"Get the trailing-year SEC fails-to-deliver (FTD) records for a US security, including the fail quantity and price.","tags":["Short Interest & Borrow"],"x-fintel-api-family":"Short Interest & Borrow","x-fintel-scope":"shorts:ftd","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_fails_to_deliver","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/dividends":{"get":{"operationId":"getSecurityDividends","summary":"Get dividends","description":"Get historical dividend payments for a security.","tags":["Fundamentals"],"x-fintel-api-family":"Fundamentals","x-fintel-scope":"fundamentals:dividends","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_security_dividends","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/earnings":{"get":{"operationId":"getSecurityEarnings","summary":"Get earnings","description":"Get historical earnings reports and surprises for a security.","tags":["Fundamentals"],"x-fintel-api-family":"Fundamentals","x-fintel-scope":"fundamentals:metrics","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_security_earnings","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/data-points/{key}":{"get":{"operationId":"getSecurityDataPoint","summary":"Get financial data point","description":"Get a specific financial data point or metric for a security by its key.","tags":["Fundamentals"],"x-fintel-api-family":"Fundamentals","x-fintel-scope":"fundamentals:metrics","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_security_data_point","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}},{"name":"key","in":"path","description":"Data definition key, e.g. market_cap.","required":true,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/price-targets":{"get":{"operationId":"getSecurityPriceTargets","summary":"Get price targets","description":"Get analyst price targets (high, low, mean, median) for a security.","tags":["Analyst Estimates"],"x-fintel-api-family":"Analyst Estimates","x-fintel-scope":"analysts:price-targets","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_security_price_targets","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/analyst-ratings":{"get":{"operationId":"getSecurityAnalystRatings","summary":"Get analyst ratings","description":"Get aggregated analyst recommendations (buy, hold, sell) for a security.","tags":["Analyst Estimates"],"x-fintel-api-family":"Analyst Estimates","x-fintel-scope":"analysts:ratings","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_security_analyst_ratings","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}}]}},"/v1/securities/{country}/{symbol}/forecast":{"get":{"operationId":"getSecurityForecast","summary":"Get analyst forecast","description":"Get aggregated analyst revenue and earnings forecasts for a security.","tags":["Analyst Estimates"],"x-fintel-api-family":"Analyst Estimates","x-fintel-scope":"analysts:ratings","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_security_forecast","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"country","in":"path","description":"ISO country code of the listing, e.g. US.","required":true,"schema":{"type":"string"}},{"name":"symbol","in":"path","description":"Ticker symbol, e.g. AAPL.","required":true,"schema":{"type":"string"}}]}},"/v1/data-definitions":{"get":{"operationId":"listDataDefinitions","summary":"Search data definitions","description":"Search the data dictionary for available metrics and attributes.","tags":["Data Definitions"],"x-fintel-api-family":"Data Definitions","x-fintel-scope":"meta:coverage","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_data_definitions","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"query","in":"query","description":"Search term for metric name or key.","required":false,"schema":{"type":"string"}},{"name":"tag","in":"query","description":"Filter by tag, e.g. valuation, quality.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max results (1-500, default 100).","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Page number (0-indexed).","required":false,"schema":{"type":"string"}}]}},"/v1/data-definitions/{key}":{"get":{"operationId":"getDataDefinition","summary":"Get data definition","description":"Get detailed information about a specific data attribute or metric.","tags":["Data Definitions"],"x-fintel-api-family":"Data Definitions","x-fintel-scope":"meta:coverage","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_data_definition","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"key","in":"path","description":"Data definition key, e.g. market_cap.","required":true,"schema":{"type":"string"}}]}},"/v1/stock-lists":{"get":{"operationId":"listStockLists","summary":"List stock lists","description":"List stock lists","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_stock_lists","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}}},"post":{"operationId":"createStockList","summary":"Create stock list","description":"Create stock list","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"201":{"description":"Created. Returns the created resource and a Location header for it."}}}},"/v1/stock-lists/{stockListId}":{"get":{"operationId":"getStockList","summary":"Get stock list","description":"Get stock list","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_stock_list","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"stockListId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"put":{"operationId":"updateStockList","summary":"Update stock list","description":"Update stock list","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"stockListId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"patch":{"operationId":"patchStockList","summary":"Patch stock list","description":"Patch stock list","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"stockListId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"delete":{"operationId":"deleteStockList","summary":"Delete stock list","description":"Delete stock list","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"204":{"description":"Deleted. No content is returned."}},"parameters":[{"name":"stockListId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/stock-lists/{stockListId}/items":{"get":{"operationId":"listStockListItems","summary":"List stock list items","description":"List stock list items","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_stock_list_items","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"stockListId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"post":{"operationId":"addStockListItem","summary":"Add stock list item","description":"Add stock list item","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"201":{"description":"Created. Returns the created resource and a Location header for it."}},"parameters":[{"name":"stockListId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/stock-lists/{stockListId}/items/{stockListItemId}":{"get":{"operationId":"getNestedStockListItem","summary":"Get stock list item (nested)","description":"Get stock list item (nested)","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"stockListId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}},{"name":"stockListItemId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"delete":{"operationId":"deleteNestedStockListItem","summary":"Delete stock list item (nested)","description":"Delete stock list item (nested)","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"204":{"description":"Deleted. No content is returned."}},"parameters":[{"name":"stockListId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}},{"name":"stockListItemId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/stock-lists/{stockListId}/insiders":{"get":{"operationId":"getStockListInsiders","summary":"Get stock list insiders","description":"Get stock list insiders","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"stockListId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/stock-lists/{stockListId}/filings":{"get":{"operationId":"getStockListFilings","summary":"Get stock list filings","description":"Get stock list filings","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"stockListId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/stock-lists/{stockListId}/owners":{"get":{"operationId":"getStockListOwners","summary":"Get stock list owners","description":"Get stock list owners","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"watchlists:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"stockListId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/alerts":{"get":{"operationId":"listAlerts","summary":"List alerts","description":"List alerts","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_alerts","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}}}},"/v1/alerts/{alertId}":{"get":{"operationId":"getAlert","summary":"Get alert","description":"Get alert","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_alert","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"alertId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"delete":{"operationId":"deleteAlert","summary":"Delete alert","description":"Delete alert","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"204":{"description":"Deleted. No content is returned."}},"parameters":[{"name":"alertId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/account":{"get":{"operationId":"getAccount","summary":"Get account profile","description":"Get account profile","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"account:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_account","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}}}},"/v1/alert-definitions":{"get":{"operationId":"listAlertDefinitions","summary":"List alert definitions","description":"List alert definitions","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}}}},"/v1/alert-definitions/{alertDefinitionId}":{"get":{"operationId":"getAlertDefinition","summary":"Get alert definition","description":"Get alert definition","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"alertDefinitionId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/alert-definitions/{alertDefinitionId}/subscription":{"put":{"operationId":"putAlertDefinitionSubscription","summary":"Subscribe to alert definition (subscription resource)","description":"Subscribe to alert definition (subscription resource)","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"alertDefinitionId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"delete":{"operationId":"deleteAlertDefinitionSubscription","summary":"Unsubscribe from alert definition (subscription resource)","description":"Unsubscribe from alert definition (subscription resource)","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"204":{"description":"Deleted. No content is returned."}},"parameters":[{"name":"alertDefinitionId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/alert-subscriptions":{"get":{"operationId":"listAlertSubscriptions","summary":"List alert subscriptions","description":"List alert subscriptions","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}}},"post":{"operationId":"createAlertSubscription","summary":"Create alert subscription","description":"Create alert subscription","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"201":{"description":"Created. Returns the created resource and a Location header for it."}}}},"/v1/alert-subscriptions/{alertSubscriptionId}":{"get":{"operationId":"getAlertSubscription","summary":"Get alert subscription","description":"Get alert subscription","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"alertSubscriptionId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"patch":{"operationId":"patchAlertSubscription","summary":"Patch alert subscription","description":"Patch alert subscription","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"alertSubscriptionId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"delete":{"operationId":"deleteAlertSubscription","summary":"Delete alert subscription","description":"Delete alert subscription","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"204":{"description":"Deleted. No content is returned."}},"parameters":[{"name":"alertSubscriptionId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/alert-messages":{"get":{"operationId":"listAlertMessages","summary":"List alert messages","description":"List alert messages","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_alert_messages","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}}}},"/v1/alert-messages/{alertMessageId}":{"get":{"operationId":"getAlertMessage","summary":"Get alert message","description":"Get alert message","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"alertMessageId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"patch":{"operationId":"patchAlertMessage","summary":"Patch alert message (mark viewed)","description":"Patch alert message (mark viewed)","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"alerts:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"204":{"description":"Alert message marked viewed. No content is returned."}},"parameters":[{"name":"alertMessageId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/screens":{"get":{"operationId":"listScreens","summary":"List screens","description":"List screens","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"screens:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}}}},"/v1/screens/{screenId}":{"get":{"operationId":"getScreen","summary":"Get screen","description":"Get screen","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"screens:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"screenId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/follows":{"get":{"operationId":"listFollows","summary":"List follows","description":"List follows","tags":["Account & Application State"],"x-fintel-api-family":"Account & Application State","x-fintel-scope":"follows:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}}}},"/v1/teams":{"get":{"operationId":"listTeams","summary":"List teams","description":"List teams","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.list_teams","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}}},"post":{"operationId":"createTeam","summary":"Create team","description":"Create team","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"201":{"description":"Created. Returns the created resource and a Location header for it."}}}},"/v1/teams/{teamId}":{"get":{"operationId":"getTeam","summary":"Get team","description":"Get team","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_team","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/teams/{teamId}/members":{"get":{"operationId":"getTeamMembers","summary":"Get team members","description":"Get team members","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","x-fintel-mcp-tool":"fintel.get_team_members","x-fintel-mcp-public-catalog":true,"responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"post":{"operationId":"addTeamMember","summary":"Add team member","description":"Add team member","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/teams/{teamId}/members/me":{"put":{"operationId":"putCurrentTeamMember","summary":"Join team (membership resource)","description":"Join team (membership resource)","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Already a member, or newly joined: membership is active."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"204":{"description":"Already an active member. No content is returned (idempotent)."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"delete":{"operationId":"deleteCurrentTeamMember","summary":"Leave team (membership resource)","description":"Leave team (membership resource)","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"204":{"description":"Deleted. No content is returned."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/teams/{teamId}/members/{memberId}":{"get":{"operationId":"getTeamMember","summary":"Get team member","description":"Get team member","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}},{"name":"memberId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"delete":{"operationId":"removeTeamMember","summary":"Remove team member","description":"Remove team member","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"204":{"description":"Deleted. No content is returned."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}},{"name":"memberId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/teams/{teamId}/activity":{"get":{"operationId":"getTeamActivity","summary":"Get team activity","description":"Get team activity","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/teams/{teamId}/join":{"post":{"operationId":"joinTeam","summary":"Join team","description":"Join team","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}],"deprecated":true}},"/v1/teams/{teamId}/leave":{"post":{"operationId":"leaveTeam","summary":"Leave team","description":"Leave team","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}],"deprecated":true}},"/v1/teams/{teamId}/stock-lists":{"get":{"operationId":"getTeamStockLists","summary":"Get team stock lists","description":"Get team stock lists","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"post":{"operationId":"addTeamStockList","summary":"Add team stock list","description":"Add team stock list","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/teams/{teamId}/documents":{"get":{"operationId":"getTeamDocuments","summary":"Get team documents","description":"Get team documents","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"post":{"operationId":"addTeamDocument","summary":"Add team document","description":"Add team document","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/teams/{teamId}/topics":{"get":{"operationId":"getTeamTopics","summary":"Get team topics","description":"Get team topics","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"post":{"operationId":"addTeamTopic","summary":"Add team topic","description":"Add team topic","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/teams/{teamId}/topics/{topicId}":{"get":{"operationId":"getTeamTopic","summary":"Get team topic (nested)","description":"Get team topic (nested)","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}},{"name":"topicId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}},"/v1/teams/{teamId}/topics/{topicId}/comments":{"get":{"operationId":"listTeamTopicComments","summary":"List team topic comments (nested)","description":"List team topic comments (nested)","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:read","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"200":{"description":"Success. Returns a { data, meta } envelope."},"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}},{"name":"topicId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]},"post":{"operationId":"addTeamTopicComment","summary":"Add team topic comment (nested)","description":"Add team topic comment (nested)","tags":["Teams & Collaboration"],"x-fintel-api-family":"Teams & Collaboration","x-fintel-scope":"teams:write","x-fintel-lifecycle-state":"internal","x-fintel-visibility":"internal","responses":{"401":{"description":"Missing or invalid API key (WWW-Authenticate: ApiKey)."},"403":{"description":"Authenticated but not allowed to access this resource."},"404":{"description":"The requested resource was not found."},"201":{"description":"Created. Returns the created resource and a Location header for it."}},"parameters":[{"name":"teamId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}},{"name":"topicId","in":"path","description":"Identifier / key of the resource.","required":true,"schema":{"type":"string"}}]}}}}