{"openapi":"3.1.0","info":{"title":"OpenAPI","version":"1.0.0"},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"apiKey"},"HeaderApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"schemas":{},"parameters":{}},"paths":{"/v2/companies-list":{"get":{"tags":["Companies"],"summary":"[DEPRECATED] Get a list of all companies (use /v3/companies-list instead)","description":"Lists all companies available in the dataset together with basic descriptors and the types of data available for each company. This endpoint is deprecated, please use /v3/companies-list instead.","deprecated":true,"security":[{"ApiKeyAuth":[]}],"operationId":"get_CompaniesList","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"integer","description":"Page number (1-indexed)","example":1},"required":false,"description":"Page number (1-indexed)","name":"pageNumber","in":"query"},{"schema":{"type":"integer","description":"Number of items per page, max 1000","example":1000},"required":false,"description":"Number of items per page, max 1000","name":"pageSize","in":"query"}],"responses":{"200":{"description":"An array of companies","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","description":"Current page number","example":1},"pageSize":{"type":"number","description":"Number of items per page","example":1000},"totalCount":{"type":"number","description":"Total number of companies","example":5432},"totalPages":{"type":"number","description":"Total number of pages","example":6},"hasNextPage":{"type":"boolean","description":"Whether there is a next page","example":true},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page"}},"required":["page","pageSize","totalCount","totalPages","hasNextPage","hasPreviousPage"]},"data":{"type":"array","items":{"type":"object","properties":{"companyKey":{"type":"string","description":"Canonical company key accepted by the companyKey query parameter.","example":"NASDAQ_MSFT"},"name":{"type":"string","example":"Constellation Software Inc."},"ticker":{"type":"string","example":"CSU"},"exchangeName":{"type":"string","example":"Toronto Stock Exchange"},"micCode":{"type":"string","example":"XTSE"},"exchangeSymbol":{"type":"string","example":"TSX"},"tradingStatus":{"type":"string","description":"Active/Inactive","example":"Active"},"isPreIpo":{"type":"boolean","description":"True if the company is not yet publicly trading (pre-IPO). When true, tradingStatus will be 'Inactive'."},"countryName":{"type":"string","example":"Canada"},"countryCode":{"type":"string","example":"CA"},"tradingCurrency":{"type":"string","example":"CAD"},"reportingCurrency":{"type":"string","example":"USD"},"sector":{"type":"string","example":"Information Technology"},"industryGroup":{"type":"string","example":"Software & Services"},"industry":{"type":"string","example":"Software"},"subIndustry":{"type":"string","example":"Application Software"},"reportingTemplate":{"type":"string","example":"Standard"},"availableDatasets":{"type":"array","items":{"type":"string","enum":["financials","segments_and_kpis","stock_prices","adjusted_numbers"],"description":"Dataset type","example":"financials"}},"cik":{"type":"string","description":"SEC Central Index Key (if available)"},"cusip":{"type":"string","description":"CUSIP identifier, requires CUSIP/ISIN license","example":"21037X100"},"isin":{"type":"string","description":"ISIN identifier, requires CUSIP/ISIN license","example":"CA21037X1006"},"figi":{"type":"string","description":"FIGI (Financial Instrument Global Identifier)","example":"BBG000BLNNP0"},"earningsFilingDate":{"type":"string","description":"The latest earnings filing date, formatted as YYYY-MM-DDTHH:mm:ss[Z]."},"updatedAt":{"type":"integer","description":"The last time this company was updated, in Unix timestamp.","example":1759766466}},"required":["companyKey","name","ticker","exchangeName","exchangeSymbol","tradingStatus","isPreIpo","countryName","countryCode","reportingCurrency","sector","industryGroup","industry","subIndustry","reportingTemplate","availableDatasets"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v3/companies-list":{"get":{"tags":["Companies"],"summary":"Get a list of all companies","description":"Lists companies along with their descriptors — display and legal names, sector and industry classification, headquarters and legal domicile, the embedded `primaryListing`, market cap, key identifiers (company & security fiscal identifiers, CIK, and licensed CUSIP/ISIN/FIGI), reporting template, and the datasets available for each company. By default only companies with API-enabled data are returned; pass `allCompanies=true` for the full universe. Results are server-paginated (`pagination.totalCount` reflects the selected set); `updatedAt` and `earningsFilingDate` are always served live. Pass `compact=true` for a reduced payload. Free-plan keys receive only the free-plan companies (a single page), in either shape.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompaniesListV3","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"integer","description":"Page number (1-indexed)","example":1,"default":1},"required":false,"description":"Page number (1-indexed)","name":"pageNumber","in":"query"},{"schema":{"type":"boolean","description":"Return a slimmer row: fewer descriptive fields, all identifiers retained. Defaults to false (full shape). Available on every plan.","example":true},"required":false,"description":"Return a slimmer row: fewer descriptive fields, all identifiers retained. Defaults to false (full shape). Available on every plan.","name":"compact","in":"query"},{"schema":{"type":"boolean","description":"Set true to include the full ~55,000-company universe. Defaults to false — only companies with API-enabled data. Not available on the free plan.","example":true},"required":false,"description":"Set true to include the full ~55,000-company universe. Defaults to false — only companies with API-enabled data. Not available on the free plan.","name":"allCompanies","in":"query"}],"responses":{"200":{"description":"A paginated array of companies with their descriptors and identifiers.","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","example":1},"pageSize":{"type":"number","example":1000},"totalPages":{"type":"number","example":13},"totalCount":{"type":"number","description":"Total companies in the selected set.","example":12013},"hasNextPage":{"type":"boolean","example":true},"hasPreviousPage":{"type":"boolean"}},"required":["page","pageSize","totalPages","totalCount","hasNextPage","hasPreviousPage"]},"data":{"type":"array","items":{"type":"object","properties":{"companyId":{"type":"integer","description":"Not recommended, please use companyFiscalIdentifier instead.","example":2},"companyFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable company identifier.","example":"FSCLC6CGT4DXS597"},"companyKey":{"type":"string","description":"Fiscal.ai company key (exchangeCode_ticker).","example":"NASDAQ_MSFT"},"displayNameEnglish":{"type":"string","description":"Common display name.","example":"Microsoft Corporation"},"legalNameEnglish":{"type":"string","example":"Microsoft Corporation"},"tradeNameEnglish":{"type":"string","example":"Microsoft"},"legalNameNative":{"type":"string","description":"Legal name in the company's native language/script."},"tradeNameNative":{"type":"string"},"companyType":{"type":"string","enum":["operating_company","investment_company","reit","spac","government"],"description":"Company type","example":"operating_company"},"companyStatus":{"type":"string","enum":["active","defunct","dormant","reorganizing","shell"],"description":"Company lifecycle status","example":"active"},"headquartersCountryCode":{"type":"string","description":"Headquarters country (ISO 3166-1 alpha-2)","example":"US"},"headquartersCountryName":{"type":"string","description":"Headquarters country","example":"United States"},"headquartersRegion":{"type":"string","example":"North America"},"legalDomicileCountryCode":{"type":"string","description":"Legal domicile country (ISO 3166-1 alpha-2)","example":"US"},"legalDomicileCountryName":{"type":"string","example":"United States"},"sector":{"type":"string","enum":["Communication Services","Consumer Discretionary","Consumer Staples","Energy","Financials","Health Care","Industrials","Information Technology","Materials","Real Estate","Utilities"],"description":"GICS sector","example":"Information Technology"},"industryGroup":{"type":"string","description":"GICS industry group","example":"Software & Services"},"industry":{"type":"string","description":"GICS industry","example":"Software"},"subIndustry":{"type":"string","description":"GICS sub-industry","example":"Systems Software"},"reportingTemplate":{"type":"string","enum":["Standard","Financials","Capital Markets","Insurance","Real Estate","Utilities"],"description":"Reporting template assigned by GICS sub-industry","example":"Standard"},"cik":{"type":"string","description":"SEC Central Index Key (the company's current CIK — the latest in its CIK history)","example":"789019"},"marketCapUsd":{"type":"number","description":"Latest market capitalization in USD.","example":3110000000000},"primaryListing":{"type":"object","properties":{"listingFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable listing identifier."},"ticker":{"type":"string","example":"MSFT"},"exchangeCode":{"type":"string","description":"Listing exchange code","example":"NASDAQ"},"exchangeName":{"type":"string","example":"Nasdaq Stock Market"},"exchangeCountryCode":{"type":"string","example":"US"},"exchangeCountryName":{"type":"string","example":"United States"},"operatingMic":{"type":"string","description":"Operating MIC of the listing exchange","example":"XNAS"},"segmentMic":{"type":"string","description":"Segment MIC of the listing exchange","example":"XNGS"},"segmentName":{"type":"string","example":"Nasdaq Global Select Market"},"securityFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable security identifier.","example":"FSCLS8TBZ3EGU251"},"securityType":{"type":"string","enum":["common_stock","preferred_stock","depositary_receipt","unit"],"description":"Security type","example":"common_stock"},"tradingCurrency":{"type":"string","example":"USD"},"tradingStatus":{"type":"string","enum":["active","delisted","pre_ipo","suspended"],"description":"Trading status of this listing","example":"active"},"isin":{"type":"string","description":"Only returned with a CUSIP/ISIN license.","example":"US5949181045"},"cusip":{"type":"string","description":"Only returned with a CUSIP/ISIN license.","example":"594918104"},"figi":{"type":"string","description":"Venue-level FIGI of this exchange line.","example":"BBG000BPHFS9"},"figiComposite":{"type":"string","description":"Country-level composite FIGI of the security (the FIGI most databases store).","example":"BBG000BPH459"},"figiShareClass":{"type":"string","description":"Global share-class FIGI of the security.","example":"BBG001S5TD05"}}},"reportingCurrency":{"type":"string","description":"Company reporting currency (ISO 4217)","example":"USD"},"updatedAt":{"type":"integer","description":"Company's last data change (Unix seconds). Injected live, never cached.","example":1759766466},"earningsFilingDate":{"type":"string","description":"Latest earnings filing date (YYYY-MM-DDTHH:mm:ss[Z]). Injected live.","example":"2026-05-01T10:01:00Z"},"availableDatasets":{"type":"array","items":{"type":"string","enum":["filings","financials","adjusted_numbers","stock_prices","ownership","news","logos","segments_and_kpis","events_calendar","investor_relations","fund_letters"],"description":"A dataset available for this company","example":"financials"}}},"required":["companyId","companyKey","primaryListing","availableDatasets"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v2/company/profile":{"get":{"tags":["Companies"],"summary":"[DEPRECATED] Get profile for a single company (use /v3/company/profile instead)","description":"Retrieves a detailed company profile including sector, industry, descriptions and lists the datasets currently available under the Fiscal.ai system. This endpoint is deprecated, please use /v3/company/profile instead.","deprecated":true,"security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyProfile","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"Company profile","content":{"application/json":{"schema":{"type":"object","properties":{"companyKey":{"type":"string","description":"Canonical company key accepted by the companyKey query parameter.","example":"NASDAQ_MSFT"},"name":{"type":"string","example":"Constellation Software Inc."},"ticker":{"type":"string","example":"CSU"},"exchangeName":{"type":"string","example":"Toronto Stock Exchange"},"micCode":{"type":"string","example":"XTSE"},"exchangeSymbol":{"type":"string","example":"TSX"},"tradingStatus":{"type":"string","description":"Active/Inactive","example":"Active"},"isPreIpo":{"type":"boolean","description":"True if the company is not yet publicly trading (pre-IPO). When true, tradingStatus will be 'Inactive'."},"countryName":{"type":"string","example":"Canada"},"countryCode":{"type":"string","example":"CA"},"tradingCurrency":{"type":"string","example":"CAD"},"reportingCurrency":{"type":"string","example":"USD"},"sector":{"type":"string","example":"Information Technology"},"industryGroup":{"type":"string","example":"Software & Services"},"industry":{"type":"string","example":"Software"},"subIndustry":{"type":"string","example":"Application Software"},"reportingTemplate":{"type":"string","example":"Standard"},"availableDatasets":{"type":"array","items":{"type":"string","enum":["financials","segments_and_kpis","stock_prices","adjusted_numbers"],"description":"Dataset type","example":"financials"}},"cik":{"type":"string","description":"SEC Central Index Key (if available)"},"cusip":{"type":"string","description":"CUSIP identifier, requires CUSIP/ISIN license","example":"21037X100"},"isin":{"type":"string","description":"ISIN identifier, requires CUSIP/ISIN license","example":"CA21037X1006"},"figi":{"type":"string","description":"FIGI (Financial Instrument Global Identifier)","example":"BBG000BLNNP0"},"earningsFilingDate":{"type":"string","description":"The latest earnings filing date, formatted as YYYY-MM-DDTHH:mm:ss[Z]."},"updatedAt":{"type":"integer","description":"The last time this company was updated, in Unix timestamp.","example":1759766466},"description":{"type":"string","description":"Constellation Software Inc. acquires, manages, and builds vertical market software businesses."},"shortDescription":{"type":"string","description":"Constellation Software Inc. is a Canadian company that acquires, manages, and builds vertical market software (VMS) businesses. The company operates globally, serving a diverse range of public and private sector customers. Its strategy involves identifying and acquiring small to medium-sized VMS companies with strong market positions and then providing them with the resources and expertise to grow. Constellation Software operates through a decentralized model, allowing its acquired businesses to maintain their unique identities and operational autonomy while benefiting from the parent company's financial strength and best practices. The company's portfolio spans numerous industries, including healthcare, education, public safety, finance, and various industrial sectors, providing mission-critical software solutions. Constellation Software is known for its disciplined acquisition strategy and long-term investment horizon, focusing on generating consistent free cash flow."},"financialPeriodsAvailable":{"type":"array","items":{"type":"string","enum":["annual","quarterly","ltm","semi-annual"],"description":"Financial period type","example":"annual"},"description":"Financial period types with at least one period containing significant financial statement data."}},"required":["companyKey","name","ticker","exchangeName","exchangeSymbol","tradingStatus","isPreIpo","countryName","countryCode","reportingCurrency","sector","industryGroup","industry","subIndustry","reportingTemplate","availableDatasets"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v3/company/profile":{"get":{"tags":["Companies"],"summary":"Get profile for a single company","description":"Retrieves a detailed company profile — legal and trade names, sector and industry classification, headquarters and legal domicile, leadership, founding and IPO years, market cap, key identifiers (company & security fiscal identifiers, CIK, and licensed CUSIP/ISIN/FIGI), and long- and short-form business descriptions. Includes the `primaryListing`, all `secondaryListings` across other exchanges, and the company's `peers` (the former /v1/company/peers endpoint, now embedded here).","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyProfileV3Route","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"The company profile, including its listings and peers.","content":{"application/json":{"schema":{"type":"object","properties":{"companyId":{"type":"integer","description":"Not recommended, please use companyFiscalIdentifier instead.","example":2},"companyFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable company identifier.","example":"FSCLC6CGT4DXS597"},"companyKey":{"type":"string","description":"Fiscal.ai company key (exchangeCode_ticker).","example":"NASDAQ_MSFT"},"displayNameEnglish":{"type":"string","description":"Common display name.","example":"Microsoft Corporation"},"legalNameEnglish":{"type":"string","example":"Microsoft Corporation"},"tradeNameEnglish":{"type":"string","example":"Microsoft"},"legalNameNative":{"type":"string","description":"Legal name in the company's native language/script."},"tradeNameNative":{"type":"string"},"companyType":{"type":"string","enum":["operating_company","investment_company","reit","spac","government"],"description":"Company type","example":"operating_company"},"companyStatus":{"type":"string","enum":["active","defunct","dormant","reorganizing","shell"],"description":"Company lifecycle status","example":"active"},"headquartersCountryCode":{"type":"string","description":"Headquarters country (ISO 3166-1 alpha-2)","example":"US"},"headquartersCountryName":{"type":"string","description":"Headquarters country","example":"United States"},"headquartersRegion":{"type":"string","example":"North America"},"legalDomicileCountryCode":{"type":"string","description":"Legal domicile country (ISO 3166-1 alpha-2)","example":"US"},"legalDomicileCountryName":{"type":"string","example":"United States"},"descriptionShort":{"type":"string","description":"Short-form company description."},"descriptionLong":{"type":"string","description":"Long-form company description."},"chiefExecutiveOfficer":{"type":"string","example":"Satya Nadella"},"foundingYear":{"type":"integer","example":1975},"ipoYear":{"type":"integer","example":1986},"sector":{"type":"string","enum":["Communication Services","Consumer Discretionary","Consumer Staples","Energy","Financials","Health Care","Industrials","Information Technology","Materials","Real Estate","Utilities"],"description":"GICS sector","example":"Information Technology"},"industryGroup":{"type":"string","description":"GICS industry group","example":"Software & Services"},"industry":{"type":"string","description":"GICS industry","example":"Software"},"subIndustry":{"type":"string","description":"GICS sub-industry","example":"Systems Software"},"reportingTemplate":{"type":"string","enum":["Standard","Financials","Capital Markets","Insurance","Real Estate","Utilities"],"description":"Reporting template assigned by GICS sub-industry","example":"Standard"},"cik":{"type":"string","description":"SEC Central Index Key (the company's current CIK — the latest in its CIK history)","example":"789019"},"marketCapUsd":{"type":"number","description":"Latest market capitalization in USD.","example":3110000000000},"primaryListing":{"type":"object","properties":{"listingFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable listing identifier."},"ticker":{"type":"string","example":"MSFT"},"exchangeCode":{"type":"string","description":"Listing exchange code","example":"NASDAQ"},"exchangeName":{"type":"string","example":"Nasdaq Stock Market"},"exchangeCountryCode":{"type":"string","example":"US"},"exchangeCountryName":{"type":"string","example":"United States"},"operatingMic":{"type":"string","description":"Operating MIC of the listing exchange","example":"XNAS"},"segmentMic":{"type":"string","description":"Segment MIC of the listing exchange","example":"XNGS"},"segmentName":{"type":"string","example":"Nasdaq Global Select Market"},"securityFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable security identifier.","example":"FSCLS8TBZ3EGU251"},"securityType":{"type":"string","enum":["common_stock","preferred_stock","depositary_receipt","unit"],"description":"Security type","example":"common_stock"},"tradingCurrency":{"type":"string","example":"USD"},"tradingStatus":{"type":"string","enum":["active","delisted","pre_ipo","suspended"],"description":"Trading status of this listing","example":"active"},"isin":{"type":"string","description":"Only returned with a CUSIP/ISIN license.","example":"US5949181045"},"cusip":{"type":"string","description":"Only returned with a CUSIP/ISIN license.","example":"594918104"},"figi":{"type":"string","description":"Venue-level FIGI of this exchange line.","example":"BBG000BPHFS9"},"figiComposite":{"type":"string","description":"Country-level composite FIGI of the security (the FIGI most databases store).","example":"BBG000BPH459"},"figiShareClass":{"type":"string","description":"Global share-class FIGI of the security.","example":"BBG001S5TD05"}}},"secondaryListings":{"type":"array","items":{"type":"object","properties":{"listingFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable listing identifier."},"ticker":{"type":"string","example":"MSFT"},"exchangeCode":{"type":"string","description":"Listing exchange code","example":"NASDAQ"},"exchangeName":{"type":"string","example":"Nasdaq Stock Market"},"exchangeCountryCode":{"type":"string","example":"US"},"exchangeCountryName":{"type":"string","example":"United States"},"operatingMic":{"type":"string","description":"Operating MIC of the listing exchange","example":"XNAS"},"segmentMic":{"type":"string","description":"Segment MIC of the listing exchange","example":"XNGS"},"segmentName":{"type":"string","example":"Nasdaq Global Select Market"},"securityFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable security identifier.","example":"FSCLS8TBZ3EGU251"},"securityType":{"type":"string","enum":["common_stock","preferred_stock","depositary_receipt","unit"],"description":"Security type","example":"common_stock"},"tradingCurrency":{"type":"string","example":"USD"},"tradingStatus":{"type":"string","enum":["active","delisted","pre_ipo","suspended"],"description":"Trading status of this listing","example":"active"},"isin":{"type":"string","description":"Only returned with a CUSIP/ISIN license.","example":"US5949181045"},"cusip":{"type":"string","description":"Only returned with a CUSIP/ISIN license.","example":"594918104"},"figi":{"type":"string","description":"Venue-level FIGI of this exchange line.","example":"BBG000BPHFS9"},"figiComposite":{"type":"string","description":"Country-level composite FIGI of the security (the FIGI most databases store).","example":"BBG000BPH459"},"figiShareClass":{"type":"string","description":"Global share-class FIGI of the security.","example":"BBG001S5TD05"}}},"description":"The company's listings on all other exchanges (every non-primary listing)."},"peers":{"type":"array","items":{"type":"object","properties":{"peerRelationship":{"type":"string","enum":["direct_competitor","business_model_peer","industry_peer"],"description":"Nature of the peer relationship.","example":"direct_competitor"},"peerMarketSegment":{"type":"string","description":"Business segment the peer competes in (segment-level relationships).","example":"Cloud Infrastructure"},"peerReasoning":{"type":"string","description":"Why this company is considered a peer."},"companyId":{"type":"integer","description":"Not recommended, please use companyFiscalIdentifier instead.","example":2},"companyFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable company identifier.","example":"FSCLC6CGT4DXS597"},"companyKey":{"type":"string","description":"Fiscal.ai company key (exchangeCode_ticker).","example":"NASDAQ_MSFT"},"displayNameEnglish":{"type":"string","description":"Common display name.","example":"Microsoft Corporation"},"companyType":{"type":"string","enum":["operating_company","investment_company","reit","spac","government"],"description":"Company type","example":"operating_company"},"headquartersCountryCode":{"type":"string","description":"Headquarters country (ISO 3166-1 alpha-2)","example":"US"},"headquartersCountryName":{"type":"string","description":"Headquarters country","example":"United States"},"headquartersRegion":{"type":"string","example":"North America"},"sector":{"type":"string","enum":["Communication Services","Consumer Discretionary","Consumer Staples","Energy","Financials","Health Care","Industrials","Information Technology","Materials","Real Estate","Utilities"],"description":"GICS sector","example":"Information Technology"},"industryGroup":{"type":"string","description":"GICS industry group","example":"Software & Services"},"industry":{"type":"string","description":"GICS industry","example":"Software"},"subIndustry":{"type":"string","description":"GICS sub-industry","example":"Systems Software"},"marketCapUsd":{"type":"number","description":"Latest market capitalization in USD.","example":3110000000000},"cik":{"type":"string","description":"SEC Central Index Key (the company's current CIK — the latest in its CIK history)","example":"789019"},"primaryListing":{"type":"object","properties":{"listingFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable listing identifier."},"ticker":{"type":"string","example":"MSFT"},"exchangeCode":{"type":"string","description":"Listing exchange code","example":"NASDAQ"},"exchangeName":{"type":"string","example":"Nasdaq Stock Market"},"operatingMic":{"type":"string","description":"Operating MIC of the listing exchange","example":"XNAS"},"securityFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable security identifier.","example":"FSCLS8TBZ3EGU251"},"isin":{"type":"string","description":"Only returned with a CUSIP/ISIN license.","example":"US5949181045"},"cusip":{"type":"string","description":"Only returned with a CUSIP/ISIN license.","example":"594918104"},"figi":{"type":"string","description":"Venue-level FIGI of this exchange line.","example":"BBG000BPHFS9"},"figiComposite":{"type":"string","description":"Country-level composite FIGI of the security (the FIGI most databases store).","example":"BBG000BPH459"},"figiShareClass":{"type":"string","description":"Global share-class FIGI of the security.","example":"BBG001S5TD05"}}}},"required":["peerRelationship","companyId","companyKey","primaryListing"]},"description":"Companies this company is benchmarked against, closest first."},"financialPeriodsAvailable":{"type":"array","items":{"type":"string","enum":["annual","quarterly","ltm","semi-annual"],"description":"Financial period type","example":"annual"},"description":"Financial period types with at least one period containing significant financial statement data."},"reportingCurrency":{"type":"string","description":"Company reporting currency (ISO 4217)","example":"USD"},"updatedAt":{"type":"integer","description":"Company's last data change (Unix seconds). Injected live, never cached.","example":1759766466},"earningsFilingDate":{"type":"string","description":"Latest earnings filing date (YYYY-MM-DDTHH:mm:ss[Z]). Injected live.","example":"2026-05-01T10:01:00Z"},"availableDatasets":{"type":"array","items":{"type":"string","enum":["filings","financials","adjusted_numbers","stock_prices","ownership","news","logos","segments_and_kpis","events_calendar","investor_relations","fund_letters"],"description":"A dataset available for this company","example":"financials"}}},"required":["companyId","companyKey","primaryListing","secondaryListings","peers","availableDatasets"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v2/company/logo":{"get":{"tags":["Companies"],"summary":"Get a published company logo asset","description":"Returns a published company logo as image bytes. Supports icon, logo (light), logo-dark, and tile variants.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyLogo","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","default":"icon","description":"Logo variant. One of: icon (square app icon / avatar), logo (logomark for light surfaces), logo-dark (logomark for dark surfaces), tile (square brand tile). Defaults to icon.","example":"icon"},"required":false,"description":"Logo variant. One of: icon (square app icon / avatar), logo (logomark for light surfaces), logo-dark (logomark for dark surfaces), tile (square brand tile). Defaults to icon.","name":"variant","in":"query"}],"responses":{"200":{"description":"Logo image bytes","content":{"image/png":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"string"},"format":{"type":"string","example":"binary"}},"required":["type","format"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/news":{"get":{"tags":["News"],"summary":"Get company news","description":"Returns company news.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyNews","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","default":"2026-04-18","description":"Start date of the inclusive UTC date range. Must be supplied together with endDate. If both are omitted, returns the latest 14 UTC dates.","example":"2026-04-18"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","default":"2026-05-01","description":"End date of the inclusive UTC date range. Must be supplied together with startDate. Range cannot exceed 31 days. If both are omitted, returns the latest 14 UTC dates.","example":"2026-05-01"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string","enum":["earnings","guidance","dividend","stock_split","buyback","ma","partnership","product_launch","expansion","regulatory","legal","executive","restructuring","financing","technology","esg","analyst","market_commentary","other"],"description":"Optional filter to a single normalized event type. For multiple event types, use /v1/top-news (comma-separated eventType).","example":"earnings"},"required":false,"name":"eventType","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":5,"description":"Optional filter to a single exact importance score (1-5). For multiple levels or a range, use /v1/top-news (minImportance/maxImportance).","example":2},"required":false,"name":"importance","in":"query"}],"responses":{"200":{"description":"Company news articles sorted newest first by UTC file date, then collection timestamp.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"UTC date of the stored news file.","example":"2026-04-29"},"title":{"type":"string","example":"Company announces strategic acquisition"},"description":{"type":"string","example":"A short description of the material news event."},"summary":{"type":"string","example":"A concise summary of the news and why it matters for the company."},"eventType":{"type":"string","description":"News event category.","example":"ma"},"importance":{"type":"integer","description":"Relative importance score. Scores run from 1 to 5: 1 = Major Event, 2 = Measurable Impact, 3 = Notable Update, 4 = Minor Mention, 5 = Routine Event.","example":2},"sourceUrl":{"type":"string","example":"https://example.com/news/company-announces-acquisition"},"collectedAt":{"type":"string","description":"UTC timestamp when the article was collected.","example":"2026-04-29T01:47:11Z"}},"required":["date","title","description","summary","eventType","importance","sourceUrl","collectedAt"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/top-news":{"get":{"tags":["News"],"summary":"Get top news across companies","description":"Returns a paginated top-news feed across all covered companies.\n\nDefault behavior\n\nWhen no filters are supplied, the endpoint returns articles from the latest 7 UTC days with importance 1 (Major Event) or 2 (Measurable Impact), restricted to companies with a market cap of at least $1B USD. Results are sorted by importance first, then newest collection timestamp. pageSize defaults to 250. The default view is optimized for high-signal monitoring, not as a complete relevance cutoff; include importance 3 or a wider range when you need a broader news view.\n\nFiltering\n\nUse importance for one exact level, or minImportance and maxImportance for an inclusive range. These modes are mutually exclusive. The scale runs from 1 (most material) to 5 (least material): use minImportance=1&maxImportance=3 to include Notable Update articles, or minImportance=1&maxImportance=5 to include every level.\n\neventType accepts one event type or a comma-separated list, for example eventType=earnings,ma.\n\nUse minMarketCap and/or maxMarketCap (absolute USD) to filter by company market cap. The cross-company feed defaults to a $1B USD floor (minMarketCap=1000000000); pass minMarketCap=0 to disable it. These size filters apply to the cross-company feed only — supplying companyKey returns that company's news directly and ignores minMarketCap/maxMarketCap.","security":[{"ApiKeyAuth":[]}],"operationId":"get_TopNews","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Optional. When provided, returns top news for this company only. Must be canonical EXCHANGE_TICKER form (e.g. NASDAQ_AAPL).","example":"NASDAQ_AAPL"},"required":false,"name":"companyKey","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","default":"2026-05-05","description":"Optional start date of the inclusive UTC date range (YYYY-MM-DD). If supplied, endDate must also be supplied. If both are omitted, returns the latest 7 UTC days.","example":"2026-05-05"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","default":"2026-05-11","description":"Optional end date of the inclusive UTC date range (YYYY-MM-DD). If supplied, startDate must also be supplied. Range cannot exceed 7 days. If both are omitted, returns the latest 7 UTC days.","example":"2026-05-11"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"string","description":"Optional. One or more event types, comma-separated. Defaults to all event types. Allowed: earnings, guidance, dividend, stock_split, buyback, ma, partnership, product_launch, expansion, regulatory, legal, executive, restructuring, financing, technology, esg, analyst, market_commentary, other.","example":"earnings,ma"},"required":false,"name":"eventType","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":5,"description":"Optional. Exact importance level (1-5) to return. Mutually exclusive with minImportance/maxImportance. Scale: 1=Major Event, 2=Measurable Impact, 3=Notable Update, 4=Minor Mention, 5=Routine Event.","example":2},"required":false,"name":"importance","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":5,"description":"Optional. Inclusive lower bound on the importance value (1-5). Defaults to 1. Mutually exclusive with `importance`. Note the scale: 1 is the MOST significant tier; larger numbers are less significant.","example":1},"required":false,"name":"minImportance","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":5,"description":"Optional. Inclusive upper bound on the importance value (1-5). Defaults to 5. Mutually exclusive with `importance`. Example: `minImportance=1&maxImportance=2` returns the two most significant tiers (Major Event + Measurable Impact).","example":3},"required":false,"name":"maxImportance","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"description":"Optional. Inclusive lower bound on company USD market cap (absolute units, e.g. 1000000000 = $1B). Applies to the cross-company feed only (ignored when companyKey is supplied). Defaults to 1000000000 ($1B); pass minMarketCap=0 to disable the floor.","example":1000000000},"required":false,"name":"minMarketCap","in":"query"},{"schema":{"type":["number","null"],"minimum":0,"description":"Optional. Inclusive upper bound on company USD market cap (absolute units). Applies to the cross-company feed only (ignored when companyKey is supplied). Defaults to no upper bound.","example":50000000000},"required":false,"name":"maxMarketCap","in":"query"},{"schema":{"type":"integer","minimum":1,"description":"Optional. Page number (1-indexed). Defaults to 1.","example":1},"required":false,"name":"pageNumber","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":1000,"description":"Optional. Number of articles per page. Defaults to 250, max 1000.","example":250},"required":false,"name":"pageSize","in":"query"}],"responses":{"200":{"description":"Paginated top news articles sorted by importance (ascending) then collection timestamp (newest first).","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","description":"Current page number (1-indexed).","example":1},"pageSize":{"type":"number","description":"Number of items per page.","example":250},"totalCount":{"type":"number","description":"Total number of deduped articles matching the filters.","example":2150},"totalPages":{"type":"number","description":"Total number of pages.","example":9},"hasNextPage":{"type":"boolean","description":"Whether there is a next page.","example":true},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page."}},"required":["page","pageSize","totalCount","totalPages","hasNextPage","hasPreviousPage"]},"data":{"type":"array","items":{"type":"object","properties":{"companyKey":{"type":"string","description":"EXCHANGE_TICKER for the article's company.","example":"NASDAQ_AAPL"},"date":{"type":"string","description":"UTC date of the stored news file.","example":"2026-04-29"},"title":{"type":"string","example":"Company announces strategic acquisition"},"description":{"type":"string","example":"A short description of the material news event."},"summary":{"type":"string","example":"A concise summary of the news and why it matters for the company."},"eventType":{"type":"string","description":"News event category.","example":"ma"},"importance":{"type":"integer","description":"Relative importance score. Scores run from 1 to 5: 1 = Major Event, 2 = Measurable Impact, 3 = Notable Update, 4 = Minor Mention, 5 = Routine Event.","example":2},"sourceUrl":{"type":"string","example":"https://example.com/news/company-announces-acquisition"},"collectedAt":{"type":"string","description":"UTC timestamp when the article was collected.","example":"2026-04-29T01:47:11Z"}},"required":["companyKey","date","title","description","summary","eventType","importance","sourceUrl","collectedAt"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/ownership/insider/holders":{"get":{"tags":["Ownership"],"summary":"Get insider holders for a company","description":"Returns insider holders with their security and vehicle holdings.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyInsiderHolders","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"boolean","description":"Set to `true` to include insiders who are no longer actively affiliated with the company. Defaults to excluding them."},"required":false,"description":"Set to `true` to include insiders who are no longer actively affiliated with the company. Defaults to excluding them.","name":"includeInactive","in":"query"},{"schema":{"type":"integer","description":"Page number (1-indexed)","example":1},"required":false,"description":"Page number (1-indexed)","name":"pageNumber","in":"query"},{"schema":{"type":"integer","description":"Number of records per page, max 1000","example":1000},"required":false,"description":"Number of records per page, max 1000","name":"pageSize","in":"query"}],"responses":{"200":{"description":"Insider holders","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","description":"Current page number","example":1},"pageSize":{"type":"number","description":"Number of items per page","example":1000},"totalCount":{"type":"number","description":"Total number of records","example":142},"totalPages":{"type":"number","description":"Total number of pages","example":1},"hasNextPage":{"type":"boolean","description":"Whether there is a next page"},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page"}},"required":["page","pageSize","totalCount","totalPages","hasNextPage","hasPreviousPage"]},"data":{"type":"array","items":{"type":"object","properties":{"holderId":{"type":"string","example":"9df95a60-4b3a-41f7-8dc1-4042f935ce95"},"holderName":{"type":"string","example":"Tim Cook"},"cik":{"type":"string","example":"1214156"},"title":{"type":"string","example":"Chief Executive Officer"},"relationship":{"type":"array","items":{"type":"string","example":"officer"}},"isActive":{"type":"boolean","example":true},"sharesHeldTotal":{"type":"number","example":3280180},"valueTotal":{"type":"number","example":614847000},"percentOfSharesOutstanding":{"type":"number","example":0.42},"currency":{"type":"string","example":"USD"},"holdings":{"type":"array","items":{"type":"object","properties":{"securityName":{"type":"string","example":"Common Stock"},"ownershipVehicle":{"type":"string","example":"Family Trust"},"sharesHeld":{"type":"number","example":125000},"filingDate":{"type":"string","example":"2025-04-15"},"value":{"type":"number","description":"Market value of this holding in the company's trading currency: main-class-equivalent shares × latest price. Present when shares-outstanding and latest-price data are available.","example":24500000},"percentOfSharesOutstanding":{"type":"number","description":"This holding's main-class-equivalent shares as a percentage of total shares outstanding, on a 0–100 scale. Present when shares-outstanding data is available.","example":0.31},"sources":{"type":"array","items":{"type":"object","properties":{"document":{"type":"string","example":"https://api.fiscal.ai/v1/company/ownership/filing/0000320193-25-000073/pdf?companyKey=NASDAQ_AAPL"},"pageNumber":{"type":"integer","example":84}},"required":["document"]}}},"required":["securityName","sources"]}}},"required":["holderId","relationship","isActive","holdings"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/ownership/insider/transactions":{"get":{"tags":["Ownership"],"summary":"Get insider transactions for a company","description":"Returns insider transaction rows for the requested company. Transactions from holders flagged as `is_removed` via analyst override are always hidden. Transactions from holders flagged `is_active = false` are hidden by default; pass `includeInactive=true` to include them — matching the `/insider/holders` endpoint semantics.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyInsiderTransactions","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"boolean","description":"Set to `true` to include insiders who are no longer actively affiliated with the company. Defaults to excluding them."},"required":false,"description":"Set to `true` to include insiders who are no longer actively affiliated with the company. Defaults to excluding them.","name":"includeInactive","in":"query"},{"schema":{"type":"integer","description":"Page number (1-indexed)","example":1},"required":false,"description":"Page number (1-indexed)","name":"pageNumber","in":"query"},{"schema":{"type":"integer","description":"Number of records per page, max 1000","example":1000},"required":false,"description":"Number of records per page, max 1000","name":"pageSize","in":"query"}],"responses":{"200":{"description":"Insider transactions","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","description":"Current page number","example":1},"pageSize":{"type":"number","description":"Number of items per page","example":1000},"totalCount":{"type":"number","description":"Total number of records","example":142},"totalPages":{"type":"number","description":"Total number of pages","example":1},"hasNextPage":{"type":"boolean","description":"Whether there is a next page"},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page"}},"required":["page","pageSize","totalCount","totalPages","hasNextPage","hasPreviousPage"]},"data":{"type":"array","items":{"type":"object","properties":{"holderId":{"type":"string","example":"9df95a60-4b3a-41f7-8dc1-4042f935ce95"},"holderName":{"type":"string","example":"Tim Cook"},"filingDate":{"type":"string","example":"2025-04-15"},"relationship":{"type":"array","items":{"type":"string","example":"officer"}},"title":{"type":"string","example":"Chief Executive Officer"},"transactionDate":{"type":"string","example":"2025-04-10"},"transactionType":{"type":"string","description":"One of: Open Market Purchase, Open Market Sale, Sale to Issuer, Grant or Award, Tax Withholding, Derivative Exercise, Gift or Inheritance, Tender of Shares, Other.","example":"Open Market Sale"},"acquiredDisposed":{"type":"string","description":"Either \"acquired\" or \"disposed\".","example":"disposed"},"shares":{"type":"number","example":25000},"priceLow":{"type":"number","example":197.5},"priceHigh":{"type":"number","example":199.1},"transactionValue":{"type":"number","example":4937500},"currency":{"type":"string","example":"USD"},"sharesAfter":{"type":"number","example":3280180},"securityName":{"type":"string","example":"Common Stock"},"sources":{"type":"array","items":{"type":"object","properties":{"document":{"type":"string","example":"https://api.fiscal.ai/v1/company/ownership/filing/0000320193-25-000073/pdf?companyKey=NASDAQ_AAPL"}},"required":["document"]}}},"required":["holderId","relationship","transactionDate","transactionType","currency","sources"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v2/company/ownership/insider/transactions":{"get":{"tags":["Ownership"],"summary":"Get insider transactions for a company","description":"Returns insider transaction rows for the requested company, including issuer buyback rows (`transactionKind: \"buyback\"`) and derivative-security activity where the regulator discloses them (Canada/SEDI). Amended filings are tagged (`amendmentMarker`: \"O\" original, \"A\" amendment) and replaced originals are retained as `superseded` history rows for a complete auditable record. Transactions from holders flagged as `is_removed` via analyst override are always hidden. Transactions from holders flagged `is_active = false` are hidden by default; pass `includeInactive=true` to include them — matching the `/insider/holders` endpoint semantics. `transactionType` and `securityType` filter rows before pagination; the buyback `summary` ignores both filters.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyInsiderTransactionsV2","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"boolean","description":"Set to `true` to include insiders who are no longer actively affiliated with the company. Defaults to excluding them."},"required":false,"description":"Set to `true` to include insiders who are no longer actively affiliated with the company. Defaults to excluding them.","name":"includeInactive","in":"query"},{"schema":{"type":"string","description":"Filter rows by their `transactionType` label, case-insensitive. Comma-separate multiple values (e.g. \"Share Repurchase,Open Market Purchase\"). Unknown values match nothing.","example":"Share Repurchase"},"required":false,"description":"Filter rows by their `transactionType` label, case-insensitive. Comma-separate multiple values (e.g. \"Share Repurchase,Open Market Purchase\"). Unknown values match nothing.","name":"transactionType","in":"query"},{"schema":{"type":"string","description":"Filter rows by `securityType`. Comma-separate multiple values from: common, preferred, debt, options, share_units, warrants, rights, other.","example":"common"},"required":false,"description":"Filter rows by `securityType`. Comma-separate multiple values from: common, preferred, debt, options, share_units, warrants, rights, other.","name":"securityType","in":"query"},{"schema":{"type":"integer","description":"Page number (1-indexed)","example":1},"required":false,"description":"Page number (1-indexed)","name":"pageNumber","in":"query"},{"schema":{"type":"integer","description":"Number of records per page, max 1000","example":1000},"required":false,"description":"Number of records per page, max 1000","name":"pageSize","in":"query"}],"responses":{"200":{"description":"Insider transactions","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","description":"Current page number","example":1},"pageSize":{"type":"number","description":"Number of items per page","example":1000},"totalCount":{"type":"number","description":"Total number of records","example":142},"totalPages":{"type":"number","description":"Total number of pages","example":1},"hasNextPage":{"type":"boolean","description":"Whether there is a next page"},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page"}},"required":["page","pageSize","totalCount","totalPages","hasNextPage","hasPreviousPage"]},"summary":{"type":"object","properties":{"year":{"type":"integer","example":2026},"asOfDate":{"type":"string","description":"Latest transaction date in the tape.","example":"2026-07-31"},"ytdBuybackValue":{"type":"number","description":"Sum of shares × price over priced repurchase legs in the window.","example":1250000000},"ytdBuybackShares":{"type":"number","description":"Sum of shares over repurchase legs in the window, priced or not.","example":4200000},"currency":{"type":"string","example":"CAD"}},"required":["year","asOfDate","ytdBuybackValue","ytdBuybackShares","currency"]},"data":{"type":"array","items":{"type":"object","properties":{"holderId":{"type":"string","example":"9df95a60-4b3a-41f7-8dc1-4042f935ce95"},"holderName":{"type":"string","example":"Tim Cook"},"filingDate":{"type":"string","example":"2025-04-15"},"relationship":{"type":"array","items":{"type":"string","example":"officer"}},"title":{"type":"string","example":"Chief Executive Officer"},"transactionDate":{"type":"string","example":"2025-04-10"},"transactionType":{"type":"string","description":"Display label for the filing's transaction code. US rows resolve to one of: Open Market Purchase, Open Market Sale, Sale to Issuer, Grant or Award, Tax Withholding, Derivative Exercise, Gift or Inheritance, Tender of Shares, Other. Canadian (SEDI) rows resolve to labels from the SEDI nature-of-transaction vocabulary — issuer buyback rows label as Share Repurchase or Shares Cancelled.","example":"Open Market Sale"},"acquiredDisposed":{"type":"string","description":"Either \"acquired\" or \"disposed\".","example":"disposed"},"shares":{"type":"number","example":25000},"priceLow":{"type":"number","example":197.5},"priceHigh":{"type":"number","example":199.1},"transactionValue":{"type":"number","example":4937500},"currency":{"type":"string","example":"USD"},"sharesAfter":{"type":"number","example":3280180},"securityName":{"type":"string","example":"Common Stock"},"sources":{"type":"array","items":{"type":"object","properties":{"document":{"type":"string","example":"https://api.fiscal.ai/v1/company/ownership/filing/0000320193-25-000073/pdf?companyKey=NASDAQ_AAPL"}},"required":["document"]}},"transactionKind":{"type":"string","description":"Present only on issuer buyback rows (value \"buyback\") — the company transacting in its own securities (repurchases, cancellations, redemptions). Absent on insider rows.","example":"buyback"},"securityType":{"type":"string","description":"Security-designation category. One of: common, preferred, debt, options, share_units, warrants, rights, other.","example":"common"},"titles":{"type":"array","items":{"type":"string","example":"Chief Executive Officer"},"description":"Every title the filing disclosed, in filing order (an insider can hold several at once — Director and CEO). `title` stays the primary. Absent on rows consolidated before this field existed."},"amendmentMarker":{"type":"string","description":"Filing kind per the regulator's own convention: \"O\" original, \"A\" amendment. Absent on rows consolidated before this field existed.","example":"O"},"superseded":{"type":"boolean","description":"Present (true) on history rows an amendment replaced — retained for the auditable record. The amendment row carries the corrected values; superseded rows never carry a closing balance and are excluded from the buyback summary.","example":true}},"required":["holderId","relationship","transactionDate","transactionType","currency","sources","securityType"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/ownership/institutional/holders":{"get":{"tags":["Ownership"],"summary":"Get institutional holdings for a company","description":"Returns institutional holder positions for a company. Defaults to the latest reported quarter; use year + quarter for history.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyInstitutionalHolders","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"integer","description":"Calendar year for a historical quarter. Must be supplied with quarter.","example":2025},"required":false,"description":"Calendar year for a historical quarter. Must be supplied with quarter.","name":"year","in":"query"},{"schema":{"type":"integer","description":"Calendar quarter for a historical period. Must be supplied with year.","example":4},"required":false,"description":"Calendar quarter for a historical period. Must be supplied with year.","name":"quarter","in":"query"},{"schema":{"type":"integer","description":"Page number (1-indexed)","example":1},"required":false,"description":"Page number (1-indexed)","name":"pageNumber","in":"query"},{"schema":{"type":"integer","description":"Number of records per page, max 1000","example":1000},"required":false,"description":"Number of records per page, max 1000","name":"pageSize","in":"query"}],"responses":{"200":{"description":"Institutional holdings for a company","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","description":"Current page number","example":1},"pageSize":{"type":"number","description":"Number of items per page","example":1000},"totalCount":{"type":"number","description":"Total number of records","example":142},"totalPages":{"type":"number","description":"Total number of pages","example":1},"hasNextPage":{"type":"boolean","description":"Whether there is a next page"},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page"}},"required":["page","pageSize","totalCount","totalPages","hasNextPage","hasPreviousPage"]},"data":{"type":"array","items":{"type":"object","properties":{"holderId":{"type":"string","example":"88b0adf8-ff23-4540-8f15-56d930a71050"},"holderName":{"type":"string","example":"Vanguard Group Inc"},"cik":{"type":"string","example":"102909"},"reportDate":{"type":"string","example":"2025-12-31"},"filingDate":{"type":"string","example":"2026-02-14"},"shares":{"type":"number","example":1354289280},"currency":{"type":"string","example":"USD"},"value":{"type":"number","example":339120000000},"sharesChange":{"type":"number","example":1250000},"sharesChangePercent":{"type":"number","example":9},"valueChange":{"type":"number","example":420000000},"percentOfSharesOutstanding":{"type":"number","example":8.71},"sources":{"type":"array","items":{"type":"object","properties":{"document":{"type":"string","example":"https://api.fiscal.ai/v1/company/ownership/filing/0000320193-25-000073/pdf?companyKey=NASDAQ_AAPL"}},"required":["document"]}}},"required":["holderId","reportDate","filingDate","shares","currency","sources"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/short-interest":{"get":{"tags":["Short Interest"],"summary":"Get short interest history for a company","description":"Returns the company's bi-monthly consolidated short interest reports (FINRA), newest first. Float fields are served as null until float data ships.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyShortInterest","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"number","description":"Only the N most recent reports (default: full published history)","example":24},"required":false,"description":"Only the N most recent reports (default: full published history)","name":"limit","in":"query"}],"responses":{"200":{"description":"Short interest","content":{"application/json":{"schema":{"type":"object","properties":{"companyKey":{"type":"string","example":"NASDAQ_MSFT"},"floatShares":{"type":"object","properties":{"type":{"type":"array","items":{"type":"string","example":"number"}},"examples":{"type":"array","items":{"type":"string"}},"description":{"type":"string","example":"Public float in shares. Always null until float is served."}},"required":["type","examples","description"]},"shortInterest":{"type":"array","items":{"type":"object","properties":{"settlementDate":{"type":"string","example":"2026-07-31"},"shortInterestShares":{"type":"number","example":81311791},"previousShortInterestShares":{"type":"object","properties":{"type":{"type":"array","items":{"type":"string","example":"number"}},"examples":{"type":"array","items":{"type":"number","example":92373474}},"description":{"type":"string","example":"Short interest at the previous settlement date. Null on a symbol's first report."}},"required":["type","examples","description"]},"changePercent":{"type":"object","properties":{"type":{"type":"array","items":{"type":"string","example":"number"}},"examples":{"type":"array","items":{"type":"number","example":-11.97}},"description":{"type":"string","example":"Percent change in short interest versus the previous settlement date."}},"required":["type","examples","description"]},"averageDailyVolume":{"type":"object","properties":{"type":{"type":"array","items":{"type":"string","example":"number"}},"examples":{"type":"array","items":{"type":"number","example":40018336}}},"required":["type","examples"]},"daysToCover":{"type":"object","properties":{"type":{"type":"array","items":{"type":"string","example":"number"}},"examples":{"type":"array","items":{"type":"number","example":2.03}},"description":{"type":"string","example":"Short interest divided by average daily volume, floored at 1 by FINRA."}},"required":["type","examples","description"]},"shortPercentOfFloat":{"type":"object","properties":{"type":{"type":"array","items":{"type":"string","example":"number"}},"examples":{"type":"array","items":{"type":"string"}},"description":{"type":"string","example":"Short interest as a percent of public float. Always null until float is served."}},"required":["type","examples","description"]}},"required":["settlementDate","shortInterestShares","previousShortInterestShares","changePercent","averageDailyVolume","daysToCover","shortPercentOfFloat"]}}},"required":["companyKey","floatShares","shortInterest"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/ownership/institutional/holdings":{"get":{"tags":["Ownership"],"summary":"Get holdings for an institutional holder","description":"Returns a holder-centric portfolio. Defaults to the latest reported quarter; use year + quarter for history. Free-trial keys can read the holders listed by /v1/ownership/institutional/holders; other holders return 403.","security":[{"ApiKeyAuth":[]}],"operationId":"get_HolderInstitutionalHoldings","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Ownership holder UUID. Provide either `holderId` or `cik`.","example":"4ae4ea51-1b9e-4cc2-ae6e-d22ef324b171"},"required":false,"description":"Ownership holder UUID. Provide either `holderId` or `cik`.","name":"holderId","in":"query"},{"schema":{"type":"string","description":"SEC CIK of the holder (with or without leading zeros). Provide either `holderId` or `cik`.","example":"1350694"},"required":false,"description":"SEC CIK of the holder (with or without leading zeros). Provide either `holderId` or `cik`.","name":"cik","in":"query"},{"schema":{"type":"integer","description":"Calendar year for a historical quarter. Must be supplied with quarter.","example":2025},"required":false,"description":"Calendar year for a historical quarter. Must be supplied with quarter.","name":"year","in":"query"},{"schema":{"type":"integer","description":"Calendar quarter for a historical period. Must be supplied with year.","example":4},"required":false,"description":"Calendar quarter for a historical period. Must be supplied with year.","name":"quarter","in":"query"},{"schema":{"type":"integer","description":"Page number (1-indexed)","example":1},"required":false,"description":"Page number (1-indexed)","name":"pageNumber","in":"query"},{"schema":{"type":"integer","description":"Number of records per page, max 1000","example":1000},"required":false,"description":"Number of records per page, max 1000","name":"pageSize","in":"query"}],"responses":{"200":{"description":"Institutional holdings for a holder","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","description":"Current page number","example":1},"pageSize":{"type":"number","description":"Number of items per page","example":1000},"totalCount":{"type":"number","description":"Total number of records","example":142},"totalPages":{"type":"number","description":"Total number of pages","example":1},"hasNextPage":{"type":"boolean","description":"Whether there is a next page"},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page"}},"required":["page","pageSize","totalCount","totalPages","hasNextPage","hasPreviousPage"]},"data":{"type":"array","items":{"type":"object","properties":{"holderId":{"type":"string","example":"88b0adf8-ff23-4540-8f15-56d930a71050"},"holdingType":{"type":"string","description":"Either \"company\" or \"fund\". When \"company\", the `company` object is present; when \"fund\", the `fund` object is present.","example":"company"},"company":{"type":"object","properties":{"companyId":{"type":"integer","example":1234},"name":{"type":"string","example":"Apple Inc."},"ticker":{"type":"string","example":"AAPL"},"exchangeSymbol":{"type":"string","example":"NASDAQ"}},"required":["companyId","name","ticker","exchangeSymbol"]},"fund":{"type":"object","properties":{"fundId":{"type":"string","example":"88b0adf8-ff23-4540-8f15-56d930a71050"},"name":{"type":"string","example":"SPDR S&P 500 ETF Trust"},"ticker":{"type":"string","example":"SPY"},"exchangeSymbol":{"type":"string","example":"ARCA"}},"required":["fundId","name","ticker"]},"reportDate":{"type":"string","example":"2025-12-31"},"filingDate":{"type":"string","example":"2026-02-14"},"shares":{"type":"number","example":1354289280},"currency":{"type":"string","example":"USD"},"value":{"type":"number","example":339120000000},"sharesChange":{"type":"number","example":1250000},"sharesChangePercent":{"type":"number","example":9},"valueChange":{"type":"number","example":420000000},"percentOfPortfolio":{"type":"number","description":"Percentage of the holder's total portfolio value, on a 0–100 scale.","example":4.32},"sources":{"type":"array","items":{"type":"object","properties":{"document":{"type":"string","example":"https://api.fiscal.ai/v1/company/ownership/filing/0000320193-25-000073/pdf?companyKey=NASDAQ_AAPL"}},"required":["document"]}}},"required":["holderId","holdingType","reportDate","filingDate","shares","currency","sources"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/ownership/institutional/holders":{"get":{"tags":["Ownership"],"summary":"List all institutional holders","description":"Returns the directory of institutional holders with holder ID, normalized name, and SEC CIK when available. Free-trial keys receive the holders included in the trial rather than the full directory.","security":[{"ApiKeyAuth":[]}],"operationId":"get_InstitutionalHoldersList","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Optional SEC CIK filter (with or without leading zeros).","example":"1350694"},"required":false,"description":"Optional SEC CIK filter (with or without leading zeros).","name":"cik","in":"query"},{"schema":{"type":"integer","description":"Page number (1-indexed)","example":1},"required":false,"description":"Page number (1-indexed)","name":"pageNumber","in":"query"},{"schema":{"type":"integer","description":"Number of records per page, max 1000","example":1000},"required":false,"description":"Number of records per page, max 1000","name":"pageSize","in":"query"}],"responses":{"200":{"description":"Institutional holders directory","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","description":"Current page number","example":1},"pageSize":{"type":"number","description":"Number of items per page","example":1000},"totalCount":{"type":"number","description":"Total number of records","example":142},"totalPages":{"type":"number","description":"Total number of pages","example":1},"hasNextPage":{"type":"boolean","description":"Whether there is a next page"},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page"}},"required":["page","pageSize","totalCount","totalPages","hasNextPage","hasPreviousPage"]},"data":{"type":"array","items":{"type":"object","properties":{"holderId":{"type":"string","example":"88b0adf8-ff23-4540-8f15-56d930a71050"},"holderName":{"type":"string","example":"Vanguard Group Inc"},"cik":{"type":"string","example":"102909"}},"required":["holderId","holderName"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/ownership/filing/{filingId}/pdf":{"get":{"tags":["Ownership"],"summary":"Get the full PDF of a company-scoped ownership filing","description":"Downloads the PDF of an ownership filing for a specific company. Mirrors `/v1/filing/:filingId/pdf` but reads from the ownership storage path.","security":[{"ApiKeyAuth":[]}],"operationId":"get_OwnershipFilingPdfCompany","parameters":[{"schema":{"type":"string","description":"Filing ID","example":"0000320193-25-000073"},"required":true,"description":"Filing ID","name":"filingId","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"Ownership filing PDF","content":{"application/pdf":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"string"},"format":{"type":"string","example":"binary"}},"required":["type","format"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/ownership/filing/{filingId}/pdf":{"get":{"tags":["Ownership"],"summary":"Get the full PDF of a holder-scoped institutional filing","description":"Downloads the PDF of an ownership filing keyed by holder UUID rather than company. Free-trial keys can read the filings of the holders listed by /v1/ownership/institutional/holders; other holders return 403.","security":[{"ApiKeyAuth":[]}],"operationId":"get_OwnershipFilingPdfHolder","parameters":[{"schema":{"type":"string","description":"Filing ID","example":"0001350694-26-000002"},"required":true,"description":"Filing ID","name":"filingId","in":"path"},{"schema":{"type":"string","description":"Ownership holder UUID. Provide either `holderId` or `cik`.","example":"4ae4ea51-1b9e-4cc2-ae6e-d22ef324b171"},"required":false,"description":"Ownership holder UUID. Provide either `holderId` or `cik`.","name":"holderId","in":"query"},{"schema":{"type":"string","description":"SEC CIK of the holder (with or without leading zeros). Provide either `holderId` or `cik`.","example":"1350694"},"required":false,"description":"SEC CIK of the holder (with or without leading zeros). Provide either `holderId` or `cik`.","name":"cik","in":"query"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"}],"responses":{"200":{"description":"Holder filing PDF","content":{"application/pdf":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"string"},"format":{"type":"string","example":"binary"}},"required":["type","format"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/financials/{statementType}/as-reported":{"get":{"tags":["Financials"],"summary":"Get as-reported financials for a company","description":"Returns raw financial statement line items exactly as disclosed by the company, including source document links for traceability.","security":[{"ApiKeyAuth":[]}],"operationId":"get_AsReported","parameters":[{"schema":{"type":"string","enum":["income-statement","balance-sheet","cash-flow-statement"],"description":"Financial statement category","example":"income-statement"},"required":true,"description":"Financial statement category","name":"statementType","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","default":"annual","description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","example":"annual,quarterly"},"required":false,"description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","name":"periodType","in":"query"},{"schema":{"type":"string","pattern":"^[a-zA-Z]{3,4}$","description":"ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be 3-4 letters. Defaults to company's reporting currency.","example":"CAD"},"required":false,"name":"currency","in":"query"}],"responses":{"200":{"description":"As-reported financial data","content":{"application/json":{"schema":{"type":"object","properties":{"metrics":{"type":"array","items":{"type":"object","properties":{"asReportedMetricId":{"type":"string","example":"1_IS_65961"},"metricName":{"type":"string","example":"Products"},"headers":{"type":"array","items":{"type":"string","example":"Net Sales"}},"metricFormat":{"type":"string","example":"number"},"isPointInTime":{"type":"boolean"},"isCurrency":{"type":"boolean","example":true},"isPerShare":{"type":"boolean"},"isKeyMetric":{"type":"boolean"}},"required":["asReportedMetricId","metricName","headers","metricFormat","isPointInTime","isCurrency","isPerShare","isKeyMetric"]}},"data":{"type":"array","items":{"type":"object","properties":{"periodId":{"type":"string","example":"3_Quarterly_2025-04-27"},"periodType":{"type":"string","enum":["Annual","Quarterly","Semi-Annual","LTM","YTD"],"example":"Quarterly"},"reportDate":{"type":"string","example":"2025-04-27"},"periodDuration":{"type":"string","example":"3 months"},"calendarYear":{"type":"number","example":2025},"calendarQuarter":{"type":"number","example":2},"fiscalYear":{"type":"number","example":2026},"fiscalQuarter":{"type":"number","example":1},"isStubPeriod":{"type":"boolean","description":"Whether this is a stub/transition period"},"stubType":{"type":"string","enum":["fye","inception"],"description":"Stub type: fye (fiscal year-end change) or inception (first reporting period)","example":"fye"},"stubDuration":{"type":"number","description":"Actual duration of the stub period in days","example":214},"earningsDate":{"type":"string","example":"2025-08-27"},"earningsTimeOfDay":{"type":"string","example":"16:22:14Z"},"lastSourceFilingDate":{"type":"string","example":"2025-08-27"},"lastSourceFilingTimeOfDay":{"type":"string","example":"16:22:14Z"},"isRestated":{"type":"boolean","description":"Whether this period contains restated data (data differs from original filing)"},"metricsValues":{"type":"object","properties":{"1_IS_65961":{"type":"object","properties":{"value":{"type":"number","example":264258909200},"unit":{"type":"string","example":"M"},"currency":{"type":"string","example":"EUR"},"isCalculated":{"type":"boolean","description":"Whether the value is calculated from other periods."},"originalValue":{"type":"number","description":"Original value before currency conversion","example":294866000000},"originalCurrency":{"type":"string","description":"Currency the value is reported in","example":"USD"},"appliedExchangeRate":{"type":"number","description":"Exchange rate applied for conversion","example":0.8962},"sources":{"type":"array","items":{"type":"object","properties":{"document":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ"},"image":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ"},"pageNumber":{"type":"number","example":32},"originalSourceUrl":{"type":"string","description":"The source to the original document, for now supports SEC only.","example":"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"}},"required":["document"]}}},"required":["value","unit","currency","isCalculated","sources"]}},"required":["1_IS_65961"]}},"required":["periodId","periodType","reportDate","periodDuration","calendarYear","calendarQuarter","metricsValues"]}}},"required":["metrics","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/standardized-metrics-list/{templateType}/{statementType}":{"get":{"tags":["Standardized"],"summary":"Get the list of all standardized metrics.","description":"Returns the list of all standardized metrics.","security":[{"ApiKeyAuth":[]}],"operationId":"get_StandardizedMetricsList","parameters":[{"schema":{"type":"string","enum":["standard","capital-markets","financials","insurance","utilities","real-estate"],"description":"Reporting template category","example":"standard"},"required":true,"description":"Reporting template category","name":"templateType","in":"path"},{"schema":{"type":"string","enum":["income-statement","balance-sheet","cash-flow-statement"],"description":"Financial statement category","example":"income-statement"},"required":true,"description":"Financial statement category","name":"statementType","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"}],"responses":{"200":{"description":"Standardized metrics list","content":{"application/json":{"schema":{"type":"object","properties":{"reportingTemplate":{"type":"string","enum":["Standard","Capital Markets","Financials","Insurance","Utilities","Real Estate"],"example":"Standard"},"metrics":{"type":"array","items":{"type":"object","properties":{"standardizedMetricId":{"type":"string","example":"income_statement_total_revenues"},"metricName":{"type":"string","example":"Total Revenues"},"metricFormat":{"type":"string","example":"number"},"isPointInTime":{"type":"boolean"},"isCurrency":{"type":"boolean","example":true},"isTotal":{"type":"boolean"},"headers":{"type":"array","items":{"type":"string","example":"Income"}},"definition":{"type":"string","example":"The total amount of income generated from the sale of goods or services."},"subComponents":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"number","example":1001},"metricId":{"type":"string","example":"income_statement_gross_profit"},"metricName":{"type":"string","example":"Gross Profit"},"operation":{"type":"string","example":"+"}},"required":["uid","metricId","metricName","operation"]}}},"required":["standardizedMetricId","metricName","metricFormat","isPointInTime","isCurrency","isTotal","headers","definition","subComponents"]}}},"required":["reportingTemplate","metrics"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/standardized-metrics-list":{"get":{"tags":["Standardized"],"summary":"Get the list of all standardized metrics across all reporting templates.","description":"Returns every unique standardized metric, with an array indicating which reporting templates each metric belongs to.","security":[{"ApiKeyAuth":[]}],"operationId":"get_AllStandardizedMetricsList","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"}],"responses":{"200":{"description":"Standardized metrics list","content":{"application/json":{"schema":{"type":"object","properties":{"metrics":{"type":"array","items":{"type":"object","properties":{"standardizedMetricId":{"type":"string","example":"income_statement_total_revenues"},"metricName":{"type":"string","example":"Total Revenues"},"metricFormat":{"type":"string","example":"number"},"statementType":{"type":"string","example":"Income Statement"},"isPointInTime":{"type":"boolean"},"isCurrency":{"type":"boolean","example":true},"headers":{"type":"array","items":{"type":"string","example":"Income"}},"reportingTemplates":{"type":"array","items":{"type":"string","example":"Standard"}}},"required":["standardizedMetricId","metricName","metricFormat","statementType","isPointInTime","isCurrency","headers","reportingTemplates"]}}},"required":["metrics"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/financials/{statementType}/standardized":{"get":{"tags":["Financials"],"summary":"Get standardized financials for a company","description":"Returns standardized financial statements where line items are mapped to a common schema, enabling apples-to-apples comparison across companies.","security":[{"ApiKeyAuth":[]}],"operationId":"get_Standardized","parameters":[{"schema":{"type":"string","enum":["income-statement","balance-sheet","cash-flow-statement"],"description":"Financial statement category","example":"income-statement"},"required":true,"description":"Financial statement category","name":"statementType","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","default":"annual","description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","example":"annual,quarterly"},"required":false,"description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","name":"periodType","in":"query"},{"schema":{"type":"string","pattern":"^[a-zA-Z]{3,4}$","description":"ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be 3-4 letters. Defaults to company's reporting currency.","example":"CAD"},"required":false,"name":"currency","in":"query"},{"schema":{"type":"boolean","description":"Include reportingTemplates metadata for each standardized metric"},"required":false,"description":"Include reportingTemplates metadata for each standardized metric","name":"includeReportingTemplates","in":"query"},{"schema":{"type":"boolean","description":"Include non-selected direct/composite as-reported audit trails without duplicating the selected asReportedValues trail"},"required":false,"description":"Include non-selected direct/composite as-reported audit trails without duplicating the selected asReportedValues trail","name":"includeMappingAlternatives","in":"query"}],"responses":{"200":{"description":"Standardized financial data","content":{"application/json":{"schema":{"type":"object","properties":{"reportingTemplate":{"type":"string","example":"Standard"},"metrics":{"type":"array","items":{"type":"object","properties":{"standardizedMetricId":{"type":"string","example":"income_statement_total_revenues"},"metricName":{"type":"string","example":"Total Revenues"},"metricFormat":{"type":"string","example":"number"},"isPointInTime":{"type":"boolean"},"isCurrency":{"type":"boolean","example":true},"isTotal":{"type":"boolean"},"headers":{"type":"array","items":{"type":"string","example":"Revenues"}},"reportingTemplates":{"type":"array","items":{"type":"string","example":"Standard"}},"asReportedMetrics":{"type":"array","items":{"type":"object","properties":{"asReportedMetricId":{"type":"string","example":"1_IS_65961"},"metricName":{"type":"string","example":"Products"},"headers":{"type":"array","items":{"type":"string","example":"Net Sales"}},"metricFormat":{"type":"string","example":"number"},"isPointInTime":{"type":"boolean"},"isCurrency":{"type":"boolean","example":true},"isPerShare":{"type":"boolean"},"isKeyMetric":{"type":"boolean"},"operation":{"type":"string","example":"+"}},"required":["asReportedMetricId","metricName","headers","metricFormat","isPointInTime","isCurrency","isPerShare","isKeyMetric","operation"]}}},"required":["standardizedMetricId","metricName","metricFormat","isPointInTime","isCurrency","isTotal","headers","asReportedMetrics"]}},"data":{"type":"array","items":{"type":"object","properties":{"periodId":{"type":"string","example":"3_Quarterly_2025-04-27"},"periodType":{"type":"string","enum":["Annual","Quarterly","Semi-Annual","LTM","YTD"],"example":"Quarterly"},"reportDate":{"type":"string","example":"2025-04-27"},"periodDuration":{"type":"string","example":"3 months"},"calendarYear":{"type":"number","example":2025},"calendarQuarter":{"type":"number","example":2},"fiscalYear":{"type":"number","example":2026},"fiscalQuarter":{"type":"number","example":1},"isStubPeriod":{"type":"boolean","description":"Whether this is a stub/transition period"},"stubType":{"type":"string","enum":["fye","inception"],"description":"Stub type: fye (fiscal year-end change) or inception (first reporting period)","example":"fye"},"stubDuration":{"type":"number","description":"Actual duration of the stub period in days","example":214},"earningsDate":{"type":"string","example":"2025-08-27"},"earningsTimeOfDay":{"type":"string","example":"16:22:14Z"},"lastSourceFilingDate":{"type":"string","example":"2025-08-27"},"lastSourceFilingTimeOfDay":{"type":"string","example":"16:22:14Z"},"isRestated":{"type":"boolean","description":"Whether this period contains restated data (data differs from original filing)"},"metricsValues":{"type":"object","properties":{"income_statement_total_revenues":{"type":"object","properties":{"value":{"type":"number","example":391035000000},"isCalculated":{"type":"boolean","description":"Whether the standardized value uses calculated data or a synthetic fallback/copy. Composite mappings of filed rows and parser-sourced shares measurements do not make this true. Returned as false for null values."},"calcType":{"type":"string","enum":["reported","derived_lineitem","derived_period"],"description":"Standardization provenance (broader than isCalculated). 'reported': a direct filed value. 'derived_lineitem': the standardized value uses a multi-line or subtractive mapping, a calculated source row, or currency conversion. 'derived_period': the period itself was not filed and was back-solved from other periods (for example, H2 = Annual - H1). Omitted when value is null.","example":"reported"},"mappingType":{"type":"string","enum":["direct","composite","total"],"description":"Mapping used for this period's standardized value. 'direct' uses a direct as-reported mapping, 'composite' combines mapped as-reported rows, and 'total' aggregates standardized sub-components. Omitted when the selected mapping cannot be attributed, including null values.","example":"direct"},"unit":{"type":"string","description":"Unit of measurement (inherited from first as-reported value)","example":"M"},"currency":{"type":"string","description":"Currency of the standardized metric value (target currency after conversion)","example":"USD"},"originalValue":{"type":"number","description":"Original standardized value before currency conversion (computed by applying operations to as-reported originalValues). For EPS/WASO on ADR companies, this is the ordinary share value in the original currency.","example":334218000000},"originalCurrency":{"type":"string","description":"Original currency before conversion (typically the company's reporting currency)","example":"EUR"},"appliedExchangeRate":{"type":"number","description":"Exchange rate applied for conversion (standardized value / original standardized value)","example":1.17},"ordinaryShareConversion":{"type":"object","properties":{"value":{"type":"number","description":"EPS/WASO value in ordinary share terms and in target currency"},"originalValue":{"type":"number","description":"Ordinary share value in ordinary share terms and in original currency (before FX conversion)"},"conversionFactor":{"type":"number","description":"Ratio of 1 ADS to ordinary shares (e.g., 5 means 1 ADS = 5 ordinary shares). For EPS: ADS = ordinary * factor. For WASO: ADS = ordinary / factor."}},"required":["value","conversionFactor"],"description":"Ordinary share conversion. Only present for EPS/WASO (income_statement_basic_eps, income_statement_diluted_eps, income_statement_basic_weighted_average_shares_outstanding, and income_statement_diluted_weighted_average_shares_outstanding) on ADR companies with conversion factor ≠ 1. The main 'value' is the ADS value (matches stock price). Use ordinaryShareConversion.value for per-ordinary-share figures."},"asReportedValues":{"type":"array","items":{"type":"object","properties":{"asReportedMetricId":{"type":"string","example":"1_IS_65961"},"metricName":{"type":"string","example":"Products"},"headers":{"type":"array","items":{"type":"string","example":"Net Sales"}},"operation":{"type":"string","example":"+"},"value":{"type":"number","example":294866000000},"unit":{"type":"string","example":"M"},"currency":{"type":"string","example":"USD"},"isCalculated":{"type":"boolean","description":"Whether this underlying as-reported row was calculated or is a synthetic fallback/copy rather than a direct parser measurement."},"originalValue":{"type":"number","description":"Original value before currency conversion","example":251340000000},"originalCurrency":{"type":"string","description":"Original currency before conversion","example":"EUR"},"appliedExchangeRate":{"type":"number","description":"Exchange rate applied for conversion","example":1.17},"sources":{"type":"array","items":{"type":"object","properties":{"document":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ"},"image":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ"},"pageNumber":{"type":"number","example":32}},"required":["document"]}}},"required":["asReportedMetricId","metricName","headers","operation","value","unit","currency","isCalculated"]}},"alternativeAsReportedValues":{"type":"object","properties":{"direct":{"type":"array","items":{"type":"object","properties":{"asReportedMetricId":{"type":"string","example":"1_IS_65961"},"metricName":{"type":"string","example":"Products"},"headers":{"type":"array","items":{"type":"string","example":"Net Sales"}},"operation":{"type":"string","example":"+"},"value":{"type":"number","example":294866000000},"unit":{"type":"string","example":"M"},"currency":{"type":"string","example":"USD"},"isCalculated":{"type":"boolean","description":"Whether this underlying as-reported row was calculated or is a synthetic fallback/copy rather than a direct parser measurement."},"originalValue":{"type":"number","description":"Original value before currency conversion","example":251340000000},"originalCurrency":{"type":"string","description":"Original currency before conversion","example":"EUR"},"appliedExchangeRate":{"type":"number","description":"Exchange rate applied for conversion","example":1.17},"sources":{"type":"array","items":{"type":"object","properties":{"document":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ"},"image":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ"},"pageNumber":{"type":"number","example":32}},"required":["document"]}}},"required":["asReportedMetricId","metricName","headers","operation","value","unit","currency","isCalculated"]}},"composite":{"type":"array","items":{"type":"object","properties":{"asReportedMetricId":{"type":"string","example":"1_IS_65961"},"metricName":{"type":"string","example":"Products"},"headers":{"type":"array","items":{"type":"string","example":"Net Sales"}},"operation":{"type":"string","example":"+"},"value":{"type":"number","example":294866000000},"unit":{"type":"string","example":"M"},"currency":{"type":"string","example":"USD"},"isCalculated":{"type":"boolean","description":"Whether this underlying as-reported row was calculated or is a synthetic fallback/copy rather than a direct parser measurement."},"originalValue":{"type":"number","description":"Original value before currency conversion","example":251340000000},"originalCurrency":{"type":"string","description":"Original currency before conversion","example":"EUR"},"appliedExchangeRate":{"type":"number","description":"Exchange rate applied for conversion","example":1.17},"sources":{"type":"array","items":{"type":"object","properties":{"document":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ"},"image":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ"},"pageNumber":{"type":"number","example":32}},"required":["document"]}}},"required":["asReportedMetricId","metricName","headers","operation","value","unit","currency","isCalculated"]}}},"description":"Non-selected direct or composite audit trails. Returned only when includeMappingAlternatives=true. The selected trail remains in asReportedValues, so it is not duplicated here."}},"required":["value","isCalculated","asReportedValues"]}},"required":["income_statement_total_revenues"]}},"required":["periodId","periodType","reportDate","periodDuration","calendarYear","calendarQuarter","metricsValues"]}}},"required":["reportingTemplate","metrics","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/ratios-list":{"get":{"tags":["Ratios"],"summary":"Get the list of all ratios.","description":"Returns the list of all ratios.","security":[{"ApiKeyAuth":[]}],"operationId":"get_RatiosList","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"}],"responses":{"200":{"description":"Ratios list","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"ratioId":{"type":"string","example":"price_to_earnings"},"metricName":{"type":"string","example":"Price to Earnings"},"category":{"type":"string","example":"Valuation"},"isCurrency":{"type":"boolean"},"metricFormat":{"type":"string","example":"ratio"},"hasDailyData":{"type":"boolean","example":true},"formulaHuman":{"type":"string","example":"Market Price per Share / Earnings per Share"}},"required":["ratioId","metricName","category","isCurrency","metricFormat","hasDailyData"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/ratios":{"get":{"tags":["Ratios"],"summary":"Get all ratios time series for a company","description":"Calculates and returns all supported financial ratios for the specified company across the selected period types.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyRatios","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","default":"annual","description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","example":"annual,quarterly"},"required":false,"description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","name":"periodType","in":"query"},{"schema":{"type":"string","pattern":"^[a-zA-Z]{3,4}$","description":"ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be 3-4 letters. Defaults to company's reporting currency.","example":"CAD"},"required":false,"name":"currency","in":"query"},{"schema":{"type":"string","description":"Return only these ratio IDs. Can be provided multiple times or as a comma-separated list.","example":"ratio_price_to_earnings,ratio_price_to_sales"},"required":false,"description":"Return only these ratio IDs. Can be provided multiple times or as a comma-separated list.","name":"ratioId","in":"query"}],"responses":{"200":{"description":"All ratios time series","content":{"application/json":{"schema":{"type":"object","properties":{"metrics":{"type":"array","items":{"type":"object","properties":{"ratioId":{"type":"string","example":"price_to_earnings"},"metricName":{"type":"string","example":"Price to Earnings"},"category":{"type":"string","example":"Valuation"},"isCurrency":{"type":"boolean"},"metricFormat":{"type":"string","example":"ratio"},"hasDailyData":{"type":"boolean","example":true}},"required":["ratioId","metricName","category","isCurrency","metricFormat","hasDailyData"]}},"data":{"type":"array","items":{"type":"object","properties":{"periodId":{"type":"string","example":"3_Quarterly_2025-04-27"},"periodType":{"type":"string","enum":["Annual","Quarterly","Semi-Annual","LTM","YTD"],"example":"Quarterly"},"reportDate":{"type":"string","example":"2025-04-27"},"periodDuration":{"type":"string","example":"3 months"},"calendarYear":{"type":"number","example":2025},"calendarQuarter":{"type":"number","example":2},"fiscalYear":{"type":"number","example":2026},"fiscalQuarter":{"type":"number","example":1},"isStubPeriod":{"type":"boolean","description":"Whether this is a stub/transition period"},"stubType":{"type":"string","enum":["fye","inception"],"description":"Stub type: fye (fiscal year-end change) or inception (first reporting period)","example":"fye"},"stubDuration":{"type":"number","description":"Actual duration of the stub period in days","example":214},"metricValues":{"type":"object","properties":{"market_data_share_price":{"type":"number","example":108.73},"market_data_total_shares_outstanding":{"type":"number","example":24388000000},"calculated_market_cap":{"type":"number","example":2651707240000},"ratio_price_to_sales":{"type":"number","example":60.18},"ratio_price_to_earnings":{"type":"number","example":143.07}},"required":["market_data_share_price","market_data_total_shares_outstanding","calculated_market_cap","ratio_price_to_sales","ratio_price_to_earnings"]},"tradingCurrency":{"type":"object","properties":{"currency":{"type":"string","description":"Currency used for market data values. Defaults to the exact listing's trading currency unless overridden by the currency parameter.","example":"USD"},"originalCurrency":{"type":"string","description":"Currency before conversion.","example":"CAD"},"appliedExchangeRate":{"type":"number","description":"Exchange rate applied (CAD to USD) for market cap and enterprise value.","example":0.71}},"required":["currency","originalCurrency","appliedExchangeRate"],"description":"Currency metadata for market cap, enterprise value, and price. Without an explicit currency parameter, these values remain in the exact listing's trading currency."},"reportingCurrency":{"type":"object","properties":{"currency":{"type":"string","description":"Defaults to the company's reporting currency unless overridden by the currency parameter. Financials are converted to this currency.","example":"USD"},"originalCurrency":{"type":"string","description":"Currency before conversion.","example":"CAD"},"appliedExchangeRate":{"type":"number","description":"Exchange rate applied (CAD to USD) for financials.","example":0.71}},"required":["currency","originalCurrency","appliedExchangeRate"],"description":"Reporting currency applies to financials. If the reporting currency differs from the company's reporting currency or the currency parameter, financials will be converted to that currency."}},"required":["periodId","periodType","reportDate","periodDuration","calendarYear","calendarQuarter","metricValues","tradingCurrency","reportingCurrency"]}}},"required":["metrics","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/ratios/daily/{ratioId}":{"get":{"tags":["Ratios"],"summary":"Get daily ratio time-series for a company","description":"Returns a daily time-series for the specified ratio. Stock Price mirrors the stock-prices endpoint's served closing-price series exactly when no currency override is requested. Other ratios are recomputed for each trading day using that closing price and the most recently reported fundamental inputs available as of that date.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyDailyRatios","parameters":[{"schema":{"type":"string","description":"ID of the ratio (e.g. ratio_price_to_earnings)","example":"ratio_price_to_earnings"},"required":true,"description":"ID of the ratio (e.g. ratio_price_to_earnings)","name":"ratioId","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","pattern":"^[a-zA-Z]{3,4}$","description":"ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be 3-4 letters. Defaults to company's reporting currency.","example":"CAD"},"required":false,"name":"currency","in":"query"}],"responses":{"200":{"description":"Daily ratio series","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","example":"2025-07-10"},"ratio":{"type":"number","example":25.34}},"required":["date","ratio"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/shares-outstanding":{"get":{"tags":["Shares Outstanding"],"summary":"Get the latest shares outstanding for a company","description":"Returns the total number of shares outstanding and detailed share-class breakdown as of the latest available filing for the company.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanySharesOutstanding","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"Shares outstanding","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","example":"2025-09-30"},"totalSharesOutstanding":{"type":"object","properties":{"type":{"type":"array","items":{"type":"string","example":"number"}},"examples":{"type":"array","items":{"type":"number","example":2319000000}},"description":{"type":"string","example":"Total shares outstanding. Null when the split-adjusted count is corrupted (< 1 share)."}},"required":["type","examples","description"]},"ordinaryTotalSharesOutstanding":{"type":"number","description":"Total shares in ordinary-share terms. Only present for ADR companies with a conversion factor.","example":18552000000},"shareClasses":{"type":"array","items":{"type":"object","properties":{"shareClass":{"type":"string","example":"Common Stock"},"isMainShareClass":{"type":"boolean","example":true},"sharesOutstanding":{"type":"number","example":2319000000},"conversionRate":{"type":"number","example":1},"ordinaryShareConversion":{"type":"object","properties":{"conversionFactor":{"type":"number","description":"Ratio of 1 ADS to ordinary shares (e.g., 8 means 1 ADS = 8 ordinary shares)."},"ordinarySharesOutstanding":{"type":"number","description":"Share count in ordinary-share terms."}},"required":["conversionFactor","ordinarySharesOutstanding"],"description":"Only present for ADR companies with a conversion factor. The main sharesOutstanding is in ADS terms; use ordinaryShareConversion.ordinarySharesOutstanding for ordinary-share figures."},"sourceDocument":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0001141391-25-000090/pdf?ticker=MA&exchange=NYSE"}},"required":["shareClass","isMainShareClass","sharesOutstanding","sourceDocument"]}}},"required":["date","totalSharesOutstanding","shareClasses"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/adjusted-metrics":{"get":{"tags":["Adjusted Metrics"],"summary":"Get the latest adjusted metrics for a company","description":"Returns the adjusted metrics for a company.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyAdjustedMetrics","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","default":"annual","description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","example":"annual,quarterly"},"required":false,"description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","name":"periodType","in":"query"},{"schema":{"type":"string","pattern":"^[a-zA-Z]{3,4}$","description":"ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be 3-4 letters. Defaults to company's reporting currency.","example":"CAD"},"required":false,"name":"currency","in":"query"}],"responses":{"200":{"description":"Adjusted metrics","content":{"application/json":{"schema":{"type":"object","properties":{"metrics":{"type":"array","items":{"type":"object","properties":{"metricId":{"type":"string","example":"adjusted_revenue"},"metricName":{"type":"string","example":"Adjusted Revenue"},"metricFormat":{"type":"string","example":"number"},"isCurrency":{"type":"boolean","example":true},"isPerShare":{"type":"boolean"},"isKeyMetric":{"type":"boolean"}},"required":["metricId","metricName","metricFormat","isCurrency","isPerShare","isKeyMetric"]}},"data":{"type":"array","items":{"type":"object","properties":{"periodId":{"type":"string","example":"3_Quarterly_2025-04-27"},"periodType":{"type":"string","enum":["Annual","Quarterly","Semi-Annual","LTM","YTD"],"example":"Quarterly"},"reportDate":{"type":"string","example":"2025-04-27"},"periodDuration":{"type":"string","example":"3 months"},"calendarYear":{"type":"number","example":2025},"calendarQuarter":{"type":"number","example":2},"fiscalYear":{"type":"number","example":2026},"fiscalQuarter":{"type":"number","example":1},"isStubPeriod":{"type":"boolean","description":"Whether this is a stub/transition period"},"stubType":{"type":"string","enum":["fye","inception"],"description":"Stub type: fye (fiscal year-end change) or inception (first reporting period)","example":"fye"},"stubDuration":{"type":"number","description":"Actual duration of the stub period in days","example":214},"earningsDate":{"type":"string","example":"2025-08-27"},"earningsTimeOfDay":{"type":"string","example":"16:22:14Z"},"lastSourceFilingDate":{"type":"string","example":"2025-08-27"},"lastSourceFilingTimeOfDay":{"type":"string","example":"16:22:14Z"},"isRestated":{"type":"boolean","description":"Whether this period contains restated data (data differs from original filing)"},"metricValues":{"type":"object","properties":{"value":{"type":"number","example":264258909200},"unit":{"type":"string","example":"M"},"currency":{"type":"string","example":"EUR"},"adjusted":{"type":"boolean","example":true},"originalValue":{"type":"number","description":"Original value before currency conversion","example":294866000000},"originalCurrency":{"type":"string","description":"Currency the value is reported in","example":"USD"},"appliedExchangeRate":{"type":"number","description":"Exchange rate applied for conversion","example":0.8962},"sources":{"type":"array","items":{"type":"object","properties":{"document":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ"},"image":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ"},"pageNumber":{"type":"number","example":32},"originalSourceUrl":{"type":"string","description":"The source to the original document, for now supports SEC only.","example":"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"}},"required":["document"]}}},"required":["value","unit","currency","adjusted","sources"]}},"required":["periodId","periodType","reportDate","periodDuration","calendarYear","calendarQuarter","metricValues"]}}},"required":["metrics","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/segments-and-kpis":{"get":{"tags":["Financials"],"summary":"Get segments and KPIs for a company","description":"Legacy v1 segments and KPIs endpoint. V1 returns name-derived metric IDs; use `/v2/company/segments-and-kpis` for new integrations because v2 returns stable numeric KPI identifiers.","security":[{"ApiKeyAuth":[]}],"operationId":"get_SegmentsAndKpis","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","default":"annual","description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","example":"annual,quarterly"},"required":false,"description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","name":"periodType","in":"query"},{"schema":{"type":"string","pattern":"^[a-zA-Z]{3,4}$","description":"ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be 3-4 letters. Defaults to company's reporting currency.","example":"CAD"},"required":false,"name":"currency","in":"query"}],"responses":{"200":{"description":"Segments and KPIs","content":{"application/json":{"schema":{"type":"object","properties":{"reportingCurrency":{"type":"string","example":"USD"},"currency":{"type":"string","example":"USD"},"metrics":{"type":"array","items":{"type":"object","properties":{"metricId":{"type":"string","example":"total_transaction_volume"},"metricName":{"type":"string","example":"Total Transaction Volume"},"metricType":{"type":"string","enum":["Segment","KPI"],"example":"KPI"},"metricFormat":{"type":"string","enum":["number","%","ratio"],"example":"number"},"isCurrency":{"type":"boolean","example":true},"isImportant":{"type":"boolean","example":true},"isDiscontinued":{"type":"object","properties":{"Annual":{"type":"boolean"},"Quarterly":{"type":"boolean"},"LTM":{"type":"boolean"},"Semi-Annual":{"type":"boolean","example":true}},"required":["Annual","Quarterly","LTM","Semi-Annual"]}},"required":["metricId","metricName","metricType","metricFormat","isCurrency","isImportant","isDiscontinued"]}},"segmentGroups":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","example":"Revenue"},"metrics":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"Payment Network Revenue"},"isRollup":{"type":"boolean"}},"required":["name","isRollup"]}}},"required":["title","metrics"]}},"data":{"type":"array","items":{"type":"object","properties":{"periodId":{"type":"string","example":"3_Quarterly_2025-04-27"},"periodType":{"type":"string","enum":["Annual","Quarterly","Semi-Annual","LTM","YTD"],"example":"Quarterly"},"reportDate":{"type":"string","example":"2025-04-27"},"periodDuration":{"type":"string","example":"3 months"},"calendarYear":{"type":"number","example":2025},"calendarQuarter":{"type":"number","example":2},"fiscalYear":{"type":"number","example":2026},"fiscalQuarter":{"type":"number","example":1},"isStubPeriod":{"type":"boolean","description":"Whether this is a stub/transition period"},"stubType":{"type":"string","enum":["fye","inception"],"description":"Stub type: fye (fiscal year-end change) or inception (first reporting period)","example":"fye"},"stubDuration":{"type":"number","description":"Actual duration of the stub period in days","example":214},"metricsValues":{"type":"object","additionalProperties":{"type":"number"},"example":{"total_transaction_volume":9884000000000}}},"required":["periodId","periodType","reportDate","periodDuration","calendarYear","calendarQuarter","metricsValues"]}}},"required":["reportingCurrency","currency","metrics","segmentGroups","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v2/company/segments-and-kpis":{"get":{"tags":["Financials"],"summary":"Get segments and KPIs for a company","description":"Recommended segments and KPIs endpoint. V2 returns stable numeric KPI identifiers. In v2, `metricId` and the `metricsValues` object keys use the stable KPI ID instead of the name-derived identifier returned by v1.","security":[{"ApiKeyAuth":[]}],"operationId":"get_SegmentsAndKpisV2","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","default":"annual","description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","example":"annual,quarterly"},"required":false,"description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","name":"periodType","in":"query"},{"schema":{"type":"string","pattern":"^[a-zA-Z]{3,4}$","description":"ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be 3-4 letters. Defaults to company's reporting currency.","example":"CAD"},"required":false,"name":"currency","in":"query"}],"responses":{"200":{"description":"Segments and KPIs","content":{"application/json":{"schema":{"type":"object","properties":{"reportingCurrency":{"type":"string","example":"USD"},"currency":{"type":"string","example":"USD"},"metrics":{"type":"array","items":{"type":"object","properties":{"metricId":{"type":"string","description":"Stable KPI identifier. This is the canonical ID to key off instead of the metric name.","example":"7310_KPIS_37474"},"metricName":{"type":"string","example":"Total Transaction Volume"},"metricType":{"type":"string","enum":["Segment","KPI"],"example":"KPI"},"metricFormat":{"type":"string","enum":["number","%","ratio"],"example":"number"},"isCurrency":{"type":"boolean","example":true},"isImportant":{"type":"boolean","example":true},"isDiscontinued":{"type":"object","properties":{"Annual":{"type":"boolean"},"Quarterly":{"type":"boolean"},"LTM":{"type":"boolean"},"Semi-Annual":{"type":"boolean","example":true}},"required":["Annual","Quarterly","LTM","Semi-Annual"]}},"required":["metricId","metricName","metricType","metricFormat","isCurrency","isImportant","isDiscontinued"]}},"segmentGroups":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","example":"Revenue by Geography"},"metrics":{"type":"array","items":{"type":"object","properties":{"metricId":{"type":"string","example":"7310_KPIS_37474"},"metricName":{"type":"string","example":"The Netherlands Revenue"},"isRollup":{"type":"boolean"},"rollupMetrics":{"type":"array","items":{"type":"object","properties":{"metricId":{"type":"string","example":"7310_KPIS_67618"},"metricLabel":{"type":"string","example":"Wafer Revenue"},"isRollup":{"type":"boolean"}},"required":["metricId","metricLabel","isRollup"]}}},"required":["metricId","metricName","isRollup"]}}},"required":["title","metrics"]}},"data":{"type":"array","items":{"type":"object","properties":{"periodId":{"type":"string","example":"7310_Annual_2025-12-31"},"periodType":{"type":"string","example":"Annual"},"reportDate":{"type":"string","example":"2025-12-31"},"periodDuration":{"type":"string","example":"12 Months"},"calendarYear":{"type":"number","example":2025},"calendarQuarter":{"type":"number","example":4},"fiscalYear":{"type":"number","example":2026},"fiscalQuarter":{"type":"number","example":1},"metricsValues":{"type":"object","additionalProperties":{"type":"number"},"example":{"7310_KPIS_37474":689253000}}},"required":["periodId","periodType","reportDate","periodDuration","calendarYear","calendarQuarter","metricsValues"]}}},"required":["reportingCurrency","currency","metrics","segmentGroups","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/fund-letters":{"get":{"tags":["Fund Letters"],"summary":"List fund letters","description":"Lists the published fund letters for one calendar year (optionally one quarter) — quarterly, annual and interim letters from hedge funds, mutual funds, investment partnerships and other professional investors, with extracted per-company theses available via the letter detail endpoint.\n\nRows are sorted by reporting period, newest first. Narrow further with quarter, or with investorId/fundId from the investors endpoints (an investor's complete letter feed across all years is on /v1/fund-letters/investors/{investorId}). Every row carries the companies the letter discusses (companyKeys), so the list is also a cheap way to scan a period's coverage. A period with no published letters returns an empty page, not an error.\n\nThe corpus is curated: only complete, quality-checked letters from 2020 onward are published, and each letter appears once (the same letter distributed through multiple channels is deduplicated). Identifiers are permanent; counts can drift slightly between daily publishes as new letters arrive and the company universe evolves.\n\nFree-trial keys receive the letters of the investors listed by /v1/fund-letters/investors.","security":[{"ApiKeyAuth":[]}],"operationId":"get_FundLettersList","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"integer","minimum":2020,"maximum":2100,"description":"Calendar year of the reporting period (2020 or later). Required.","example":2026},"required":true,"name":"year","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":4,"description":"Optional. Calendar quarter (1-4) within the year. Omit for the whole year.","example":1},"required":false,"name":"quarter","in":"query"},{"schema":{"type":"string","description":"Optional. Only letters from this investor (fscl_investor_… identifier).","example":"fscl_investor_4SZX6KKJ822"},"required":false,"name":"investorId","in":"query"},{"schema":{"type":"string","description":"Optional. Only letters from this fund (fscl_fund_… identifier).","example":"fscl_fund_9YFY9ZQK323"},"required":false,"name":"fundId","in":"query"},{"schema":{"type":"integer","minimum":1,"description":"Optional. Page number (1-indexed). Defaults to 1.","example":1},"required":false,"name":"pageNumber","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":1000,"description":"Optional. Rows per page. Defaults to 250, max 1000.","example":250},"required":false,"name":"pageSize","in":"query"}],"responses":{"200":{"description":"Paginated fund letters, newest reporting period first.","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","description":"Current page number (1-indexed).","example":1},"pageSize":{"type":"number","description":"Number of items per page.","example":250},"totalCount":{"type":"number","description":"Total number of rows matching the request.","example":512},"totalPages":{"type":"number","description":"Total number of pages.","example":3},"hasNextPage":{"type":"boolean","description":"Whether there is a next page.","example":true},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page."}},"required":["page","pageSize","totalCount","totalPages","hasNextPage","hasPreviousPage"]},"data":{"type":"array","items":{"type":"object","properties":{"letterId":{"type":"string","description":"Permanent identifier of this fund letter. Stable across publishes — use it to fetch the letter detail and PDF.","example":"fscl_document_9GDB7GDZ834"},"investorId":{"type":"string","description":"Permanent identifier of the investment firm that published the letter.","example":"fscl_investor_4SZX6KKJ822"},"fundId":{"type":"string","description":"Permanent identifier of the specific fund/vehicle the letter reports on.","example":"fscl_fund_9YFY9ZQK323"},"investorName":{"type":"string","description":"Canonical investment-firm name.","example":"Harris Associates / Oakmark"},"fundName":{"type":"string","description":"Canonical fund/vehicle name.","example":"Oakmark Fund"},"fundType":{"type":"string","description":"Normalized fund vehicle classification (e.g. hedge_fund, mutual_fund, investment_partnership, closed_end_fund, etf, holding_company).","example":"mutual_fund"},"title":{"type":"string","description":"Letter title as published. Nullable.","example":"Oakmark Fund Quarterly Commentary - March 31, 2026"},"reportPeriod":{"type":"string","description":"Canonical reporting period as a YYYYQn key — the same format as firstPeriod/latestPeriod everywhere in this API.","example":"2026Q1"},"reportPeriodYear":{"type":"number","description":"Calendar year of the reporting period.","example":2026},"reportPeriodQuarter":{"type":"number","description":"Calendar quarter (1-4) of the reporting period. Annual letters are assigned the quarter their period ends in.","example":1},"reportPeriodType":{"type":"string","description":"Reporting cadence: annual, semiannual, quarterly, monthly, other, or unknown.","example":"quarterly"},"periodLabel":{"type":"string","description":"The reporting period exactly as the letter states it (free text). Nullable.","example":"Quarter Ended March 31, 2026"},"publicationDate":{"type":"string","description":"Publication date (YYYY-MM-DD) when the letter states one. Nullable.","example":"2026-04-15"},"letterType":{"type":"string","description":"Normalized document type (e.g. quarterly_letter, annual_letter, monthly_commentary, shareholder_letter, fund_commentary).","example":"quarterly_letter"},"thesisCount":{"type":"number","description":"Number of company theses extracted from this letter (0 for pure macro letters).","example":11},"keyTopics":{"type":"array","items":{"type":"string","example":"artificial_intelligence"},"description":"Normalized topics the letter discusses beyond individual companies."},"companyKeys":{"type":"array","items":{"type":"string","example":"NYSE_DT"},"description":"Company keys (EXCHANGE_TICKER) of every company with a thesis in this letter."},"companyTickers":{"type":"array","items":{"type":"string","example":"DT"},"description":"Primary-listing tickers matching companyKeys, in the same order."}},"required":["letterId","investorId","fundId","investorName","fundName","fundType","title","reportPeriod","reportPeriodYear","reportPeriodQuarter","reportPeriodType","periodLabel","publicationDate","letterType","thesisCount","keyTopics","companyKeys","companyTickers"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/fund-letters/investors":{"get":{"tags":["Fund Letters"],"summary":"List fund-letter investors","description":"Lists every investment firm with published fund letters, with coverage stats (letters, funds, companies, theses, period range) and the firm's style/sector/geography profile from its most recent letters.\n\nSorted by coverage (letterCount) descending. Use investorId with /v1/fund-letters/investors/{investorId} for the full profile and letter feed, or as a filter on /v1/fund-letters.\n\nFree-trial keys receive the investors included in the trial rather than the full list.","security":[{"ApiKeyAuth":[]}],"operationId":"get_FundLetterInvestorsList","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"integer","minimum":1,"description":"Optional. Page number (1-indexed). Defaults to 1.","example":1},"required":false,"name":"pageNumber","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":1000,"description":"Optional. Rows per page. Defaults to 250, max 1000.","example":250},"required":false,"name":"pageSize","in":"query"}],"responses":{"200":{"description":"Paginated investors, most-covered first.","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","description":"Current page number (1-indexed).","example":1},"pageSize":{"type":"number","description":"Number of items per page.","example":250},"totalCount":{"type":"number","description":"Total number of rows matching the request.","example":512},"totalPages":{"type":"number","description":"Total number of pages.","example":3},"hasNextPage":{"type":"boolean","description":"Whether there is a next page.","example":true},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page."}},"required":["page","pageSize","totalCount","totalPages","hasNextPage","hasPreviousPage"]},"data":{"type":"array","items":{"type":"object","properties":{"investorId":{"type":"string","description":"Permanent investment-firm identifier.","example":"fscl_investor_4SZX6KKJ822"},"investorName":{"type":"string","description":"Canonical investment-firm name.","example":"Harris Associates / Oakmark"},"investorType":{"type":"string","description":"Normalized firm type (e.g. hedge_fund, asset_manager, mutual_fund, investment_partnership, activist, wealth_manager, ria).","example":"asset_manager"},"fundCount":{"type":"number","description":"Distinct funds with published letters.","example":12},"letterCount":{"type":"number","description":"Published letters across all the firm's funds.","example":128},"companyCount":{"type":"number","description":"Distinct companies with at least one thesis.","example":210},"thesisCount":{"type":"number","description":"Total company theses across all letters.","example":940},"firstPeriod":{"type":"string","description":"Earliest covered reporting period (YYYYQn).","example":"2020Q1"},"latestPeriod":{"type":"string","description":"Latest covered reporting period (YYYYQn).","example":"2026Q1"},"styleTags":{"type":"array","items":{"type":"string","example":"growth"},"description":"Normalized style tags from the firm's most recent letters."},"sectorFocus":{"type":"array","items":{"type":"string","example":"information_technology"},"description":"Sector focus from the firm's most recent letters."},"geographicFocus":{"type":"array","items":{"type":"string","example":"united_states"},"description":"Geographic focus from the firm's most recent letters."},"principalNames":{"type":"array","items":{"type":"string","example":"Bill Nygren"},"description":"Named principals/portfolio managers, when letters disclose them."}},"required":["investorId","investorName","investorType","fundCount","letterCount","companyCount","thesisCount","firstPeriod","latestPeriod","styleTags","sectorFocus","geographicFocus","principalNames"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/fund-letters/investors/{investorId}":{"get":{"tags":["Fund Letters"],"summary":"Get a fund-letter investor","description":"Returns an investment firm's full fund-letters profile: identity and principals, the strategy/style/focus profile evidenced across its letters, coverage stats, every fund with published letters, and the complete letter feed (newest first).\n\nInvestor identifiers are permanent. When two investor records are ever discovered to be the same firm they are merged rather than deleted, so a previously returned investorId keeps resolving.\n\nFree-trial keys can read the investors listed by /v1/fund-letters/investors; other investors return 403.","security":[{"ApiKeyAuth":[]}],"operationId":"get_FundLetterInvestorDetail","parameters":[{"schema":{"type":"string","description":"Investor identifier (fscl_investor_…).","example":"fscl_investor_4SZX6KKJ822"},"required":true,"description":"Investor identifier (fscl_investor_…).","name":"investorId","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"}],"responses":{"200":{"description":"The investor detail.","content":{"application/json":{"schema":{"type":"object","properties":{"investor":{"type":"object","properties":{"investorId":{"type":"string","example":"fscl_investor_4SZX6KKJ822"},"investorName":{"type":"string","example":"Harris Associates / Oakmark"},"investorType":{"type":"string","example":"asset_manager"},"principalNames":{"type":"array","items":{"type":"string","example":"Bill Nygren"}}},"required":["investorId","investorName","investorType","principalNames"]},"profile":{"type":"object","properties":{"overview":{"type":"string","description":"Narrative profile of the firm, built from its letters. Nullable."},"whyFollow":{"type":"string","description":"Why this investor's letters are worth reading. Nullable."},"concerns":{"type":"string","description":"Known caveats when reading this investor. Nullable."},"strategy":{"type":"string","description":"Investment strategy as evidenced across letters. Nullable."},"styleTags":{"type":"array","items":{"type":"string","example":"growth"}},"assetClassFocus":{"type":"array","items":{"type":"string","example":"public_equities"}},"geographicFocus":{"type":"array","items":{"type":"string","example":"united_states"}},"sectorFocus":{"type":"array","items":{"type":"string","example":"information_technology"}},"decisionProcess":{"type":"string","description":"How the firm describes its own process. Nullable."}},"required":["overview","whyFollow","concerns","strategy","styleTags","assetClassFocus","geographicFocus","sectorFocus","decisionProcess"]},"stats":{"type":"object","properties":{"letterCount":{"type":"number","example":128},"fundCount":{"type":"number","example":12},"companyCount":{"type":"number","example":210},"thesisCount":{"type":"number","example":940},"firstPeriod":{"type":"string","example":"2020Q1"},"latestPeriod":{"type":"string","example":"2026Q1"}},"required":["letterCount","fundCount","companyCount","thesisCount","firstPeriod","latestPeriod"]},"funds":{"type":"array","items":{"type":"object","properties":{"fundId":{"type":"string","example":"fscl_fund_9YFY9ZQK323"},"fundName":{"type":"string","example":"Oakmark Fund"},"fundType":{"type":"string","example":"mutual_fund"},"letterCount":{"type":"number","example":24},"firstPeriod":{"type":"string","example":"2020Q1"},"latestPeriod":{"type":"string","example":"2026Q1"}},"required":["fundId","fundName","fundType","letterCount","firstPeriod","latestPeriod"]},"description":"Every fund of this investor with published letters, most-covered first."},"letters":{"type":"array","items":{"type":"object","properties":{"letterId":{"type":"string","example":"fscl_document_9GDB7GDZ834"},"title":{"type":"string","example":"Oakmark Fund Quarterly Commentary - March 31, 2026"},"fundId":{"type":"string","example":"fscl_fund_9YFY9ZQK323"},"fundName":{"type":"string","example":"Oakmark Fund"},"reportPeriod":{"type":"string","description":"Canonical reporting period (YYYYQn).","example":"2026Q1"},"reportPeriodYear":{"type":"number","example":2026},"reportPeriodQuarter":{"type":"number","example":1},"letterType":{"type":"string","example":"quarterly_letter"},"thesisCount":{"type":"number","example":11}},"required":["letterId","title","fundId","fundName","reportPeriod","reportPeriodYear","reportPeriodQuarter","letterType","thesisCount"]},"description":"Every published letter of this investor, newest period first."}},"required":["investor","profile","stats","funds","letters"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/fund-letters/companies":{"get":{"tags":["Fund Letters"],"summary":"List companies covered by fund letters","description":"Lists every company with at least one published fund-letter thesis, with the resolved company block (identifiers, listing, classification, market cap) and coverage stats.\n\nSorted by coverage (letterCount) descending. Use /v1/company/fund-letters for a specific company's full thesis feed — it accepts every standard company identifier.","security":[{"ApiKeyAuth":[]}],"operationId":"get_FundLetterCompaniesList","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"integer","minimum":1,"description":"Optional. Page number (1-indexed). Defaults to 1.","example":1},"required":false,"name":"pageNumber","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":1000,"description":"Optional. Rows per page. Defaults to 250, max 1000.","example":250},"required":false,"name":"pageSize","in":"query"}],"responses":{"200":{"description":"Paginated companies, most-covered first.","content":{"application/json":{"schema":{"type":"object","properties":{"pagination":{"type":"object","properties":{"page":{"type":"number","description":"Current page number (1-indexed).","example":1},"pageSize":{"type":"number","description":"Number of items per page.","example":250},"totalCount":{"type":"number","description":"Total number of rows matching the request.","example":512},"totalPages":{"type":"number","description":"Total number of pages.","example":3},"hasNextPage":{"type":"boolean","description":"Whether there is a next page.","example":true},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page."}},"required":["page","pageSize","totalCount","totalPages","hasNextPage","hasPreviousPage"]},"data":{"type":"array","items":{"type":"object","properties":{"companyFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable company identifier (usable with every company endpoint).","example":"FSCLC8VCN8ECR698"},"companyKey":{"type":"string","description":"Fiscal.ai company key (exchangeCode_ticker).","example":"NYSE_DT"},"displayNameEnglish":{"type":"string","description":"Common display name.","example":"Dynatrace, Inc."},"sector":{"type":"string","description":"GICS sector","example":"Information Technology"},"industryGroup":{"type":"string","description":"GICS industry group","example":"Software & Services"},"industry":{"type":"string","description":"GICS industry","example":"Software"},"subIndustry":{"type":"string","description":"GICS sub-industry","example":"Application Software"},"headquartersCountryCode":{"type":"string","description":"Headquarters country (ISO 3166-1 alpha-2)","example":"US"},"headquartersCountryName":{"type":"string","description":"Headquarters country","example":"United States"},"marketCapUsd":{"type":"number","description":"USD market cap as of the latest publish — served only when computed from shares outstanding × prices (as on the v3 companies list); null otherwise.","example":12798700000},"primaryListing":{"type":"object","properties":{"ticker":{"type":"string","example":"DT"},"exchangeCode":{"type":"string","description":"Listing exchange code","example":"NYSE"},"exchangeName":{"type":"string","example":"New York Stock Exchange"},"operatingMic":{"type":"string","description":"Operating MIC of the listing exchange","example":"XNYS"}},"required":["ticker","exchangeCode","exchangeName","operatingMic"]},"letterCount":{"type":"number","description":"Published letters with a thesis on this company.","example":42},"investorCount":{"type":"number","description":"Distinct investors discussing this company.","example":18},"fundCount":{"type":"number","description":"Distinct funds discussing this company.","example":25},"firstPeriod":{"type":"string","description":"Earliest reporting period with a thesis (YYYYQn).","example":"2020Q1"},"latestPeriod":{"type":"string","description":"Latest reporting period with a thesis (YYYYQn).","example":"2026Q1"}},"required":["companyFiscalIdentifier","companyKey","displayNameEnglish","sector","industryGroup","industry","subIndustry","headquartersCountryCode","headquartersCountryName","marketCapUsd","primaryListing","letterCount","investorCount","fundCount","firstPeriod","latestPeriod"]}}},"required":["pagination","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/fund-letters/{letterId}/pdf":{"get":{"tags":["Fund Letters"],"summary":"Get the original PDF of a fund letter","description":"Downloads the original letter document as published by the investor. Letters sourced as web pages are rendered to PDF at ingestion, so every letter has one. Free-trial keys can read the letters of the investors listed by /v1/fund-letters/investors; other letters return 403.","security":[{"ApiKeyAuth":[]}],"operationId":"get_FundLetterPdf","parameters":[{"schema":{"type":"string","description":"Letter identifier (fscl_document_…).","example":"fscl_document_9GDB7GDZ834"},"required":true,"description":"Letter identifier (fscl_document_…).","name":"letterId","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"}],"responses":{"200":{"description":"Letter PDF","content":{"application/pdf":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"string"},"format":{"type":"string","example":"binary"}},"required":["type","format"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/fund-letters/{letterId}":{"get":{"tags":["Fund Letters"],"summary":"Get a fund letter","description":"Returns the full extracted content of one fund letter: identity (investor, fund), the reporting period, letter-level narratives (market backdrop, portfolio positioning, performance summary), structured performance figures, and a thesis for every security the letter materially discusses — each with the resolved company attached.\n\nThesis fields are extracted verbatim-faithful from the letter (the sourceQuote field carries a representative quote). The original document is available at /v1/fund-letters/{letterId}/pdf.\n\nFree-trial keys can read the letters of the investors listed by /v1/fund-letters/investors; other letters return 403.","security":[{"ApiKeyAuth":[]}],"operationId":"get_FundLetterDetail","parameters":[{"schema":{"type":"string","description":"Letter identifier (fscl_document_…).","example":"fscl_document_9GDB7GDZ834"},"required":true,"description":"Letter identifier (fscl_document_…).","name":"letterId","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"}],"responses":{"200":{"description":"The letter detail.","content":{"application/json":{"schema":{"type":"object","properties":{"letterId":{"type":"string","example":"fscl_document_9GDB7GDZ834"},"investor":{"type":"object","properties":{"investorId":{"type":"string","example":"fscl_investor_4SZX6KKJ822"},"investorName":{"type":"string","example":"Harris Associates / Oakmark"},"investorType":{"type":"string","example":"asset_manager"}},"required":["investorId","investorName","investorType"]},"fund":{"type":"object","properties":{"fundId":{"type":"string","example":"fscl_fund_9YFY9ZQK323"},"fundName":{"type":"string","example":"Oakmark Fund"},"fundType":{"type":"string","example":"mutual_fund"}},"required":["fundId","fundName","fundType"]},"title":{"type":"string","example":"Oakmark Fund Quarterly Commentary - March 31, 2026"},"reportPeriod":{"type":"string","description":"Canonical reporting period (YYYYQn).","example":"2026Q1"},"reportPeriodYear":{"type":"number","example":2026},"reportPeriodQuarter":{"type":"number","example":1},"reportPeriodType":{"type":"string","example":"quarterly"},"periodLabel":{"type":"string","description":"Period as stated. Nullable.","example":"Quarter Ended March 31, 2026"},"publicationDate":{"type":"string","description":"Nullable.","example":"2026-04-15"},"letterType":{"type":"string","example":"quarterly_letter"},"keyTopics":{"type":"array","items":{"type":"string","example":"artificial_intelligence"}},"marketBackdrop":{"type":"string","description":"The letter's market commentary, summarized. Nullable."},"portfolioPositioning":{"type":"string","description":"How the letter says the portfolio is positioned. Nullable."},"performanceSummary":{"type":"string","description":"The letter's own performance narrative, summarized. Nullable."},"performanceFigures":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string","description":"Period label for the figure, as stated. Nullable.","example":"Q1 2026"},"fundReturnPercent":{"type":"number","description":"Fund return for the period, in percent. Nullable.","example":3.4},"benchmarkReturnPercent":{"type":"number","description":"Benchmark return, in percent. Nullable.","example":2.1},"excessReturnPercent":{"type":"number","description":"Fund minus benchmark, in percent. Nullable.","example":1.3},"benchmarkName":{"type":"string","description":"Benchmark used. Nullable.","example":"Russell 2000 Growth Index"},"basis":{"type":"string","description":"Return basis: net, gross, nav, price, or unknown. Nullable.","example":"net"}},"required":["period","fundReturnPercent","benchmarkReturnPercent","excessReturnPercent","benchmarkName","basis"]},"description":"Structured performance figures stated in the letter."},"theses":{"type":"array","items":{"type":"object","properties":{"materialityBasis":{"type":"array","items":{"type":"string","example":"substantive_thesis"},"description":"Why this company discussion is material: substantive_thesis, performance_attribution, portfolio_action, meaningful_position_size, valuation_discussion, catalyst_discussion, risk_or_bear_case, substantive_negative_view, mistake_or_exit_review."},"relationship":{"type":"string","description":"The investor's relationship to the company in this letter: long, short, new_position, added, trimmed, sold, exited, watchlist, negative_research, or issuer.","example":"long"},"stance":{"type":"string","description":"Overall stance: bullish, bearish, mixed, or neutral.","example":"bullish"},"conviction":{"type":"string","description":"Conviction the letter expresses: high, medium, low, or unknown.","example":"high"},"positionSizePercent":{"type":"number","description":"Disclosed position size in percent, only when the letter states it for this security individually. Nullable.","example":3.7},"positionSizeBasis":{"type":"string","description":"What the percentage is measured against (portfolio, fund, nav, aum, net, gross, other). Nullable.","example":"net"},"positionSizeDescription":{"type":"string","description":"Qualitative sizing language when no number is disclosed. Nullable.","example":"top-five position"},"timeHorizon":{"type":"string","description":"Stated investment horizon: short_term, medium_term, or long_term. Nullable.","example":"long_term"},"thesisSummary":{"type":"string","description":"Concise summary of the investment thesis as argued in the letter.","example":"Category leader in observability with durable 25%+ ARR growth as AI workloads expand."},"sourceQuote":{"type":"string","description":"Representative verbatim quote from the letter. Nullable.","example":"We added to Dynatrace on weakness; observability spend is early in its AI-driven expansion."},"variantPerception":{"type":"string","description":"Where the investor believes they differ from consensus. Nullable."},"riskSummary":{"type":"string","description":"Risks the letter itself flags for this position. Nullable."},"catalystSummary":{"type":"string","description":"Catalysts the letter identifies. Nullable."},"valuationSummary":{"type":"string","description":"The letter's valuation argument. Nullable."},"businessQualitySummary":{"type":"string","description":"The letter's view on business quality/moat. Nullable."},"managementAssessment":{"type":"string","description":"The letter's assessment of management. Nullable."},"capitalAllocationSummary":{"type":"string","description":"The letter's view on capital allocation. Nullable."},"financialExpectations":{"type":"string","description":"Financial expectations the letter states (growth, margins, earnings power). Nullable."},"performanceOrActionSummary":{"type":"string","description":"What the position did for performance and/or what action the investor took. Nullable."},"decisionRelevantTakeaways":{"type":"array","items":{"type":"string"},"description":"Decision-relevant takeaways extracted from the discussion."},"monitoringPoints":{"type":"array","items":{"type":"string"},"description":"What the investor says they are watching from here."},"company":{"type":"object","properties":{"companyFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable company identifier (usable with every company endpoint).","example":"FSCLC8VCN8ECR698"},"companyKey":{"type":"string","description":"Fiscal.ai company key (exchangeCode_ticker).","example":"NYSE_DT"},"displayNameEnglish":{"type":"string","description":"Common display name.","example":"Dynatrace, Inc."},"sector":{"type":"string","description":"GICS sector","example":"Information Technology"},"industryGroup":{"type":"string","description":"GICS industry group","example":"Software & Services"},"industry":{"type":"string","description":"GICS industry","example":"Software"},"subIndustry":{"type":"string","description":"GICS sub-industry","example":"Application Software"},"headquartersCountryCode":{"type":"string","description":"Headquarters country (ISO 3166-1 alpha-2)","example":"US"},"headquartersCountryName":{"type":"string","description":"Headquarters country","example":"United States"},"marketCapUsd":{"type":"number","description":"USD market cap as of the latest publish — served only when computed from shares outstanding × prices (as on the v3 companies list); null otherwise.","example":12798700000},"primaryListing":{"type":"object","properties":{"ticker":{"type":"string","example":"DT"},"exchangeCode":{"type":"string","description":"Listing exchange code","example":"NYSE"},"exchangeName":{"type":"string","example":"New York Stock Exchange"},"operatingMic":{"type":"string","description":"Operating MIC of the listing exchange","example":"XNYS"}},"required":["ticker","exchangeCode","exchangeName","operatingMic"]}},"required":["companyFiscalIdentifier","companyKey","displayNameEnglish","sector","industryGroup","industry","subIndustry","headquartersCountryCode","headquartersCountryName","marketCapUsd","primaryListing"]}},"required":["materialityBasis","relationship","stance","conviction","positionSizePercent","positionSizeBasis","positionSizeDescription","timeHorizon","thesisSummary","sourceQuote","variantPerception","riskSummary","catalystSummary","valuationSummary","businessQualitySummary","managementAssessment","capitalAllocationSummary","financialExpectations","performanceOrActionSummary","decisionRelevantTakeaways","monitoringPoints","company"]},"description":"One entry per security the letter materially discusses, with the resolved company attached."}},"required":["letterId","investor","fund","title","reportPeriod","reportPeriodYear","reportPeriodQuarter","reportPeriodType","periodLabel","publicationDate","letterType","keyTopics","marketBackdrop","portfolioPositioning","performanceSummary","performanceFigures","theses"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/fund-letters":{"get":{"tags":["Fund Letters"],"summary":"Get fund-letter theses for a company","description":"Returns everything professional investors' letters say about one company: the resolved company block, coverage stats, and every published thesis (newest reporting period first) — each with its stance, conviction, position sizing, thesis/risk/catalyst/valuation summaries, a representative source quote, and a reference to the investor, fund and letter it came from.\n\nAccepts every standard company identifier (companyKey, ticker + exchange/micCode, CUSIP, ISIN, FIGI, CIK, or the Fiscal.ai company identifier). Returns 404 for companies without fund-letter coverage — /v1/fund-letters/companies lists the covered universe.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyFundLetters","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"The company's fund-letter thesis feed.","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object","properties":{"companyFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable company identifier (usable with every company endpoint).","example":"FSCLC8VCN8ECR698"},"companyKey":{"type":"string","description":"Fiscal.ai company key (exchangeCode_ticker).","example":"NYSE_DT"},"displayNameEnglish":{"type":"string","description":"Common display name.","example":"Dynatrace, Inc."},"sector":{"type":"string","description":"GICS sector","example":"Information Technology"},"industryGroup":{"type":"string","description":"GICS industry group","example":"Software & Services"},"industry":{"type":"string","description":"GICS industry","example":"Software"},"subIndustry":{"type":"string","description":"GICS sub-industry","example":"Application Software"},"headquartersCountryCode":{"type":"string","description":"Headquarters country (ISO 3166-1 alpha-2)","example":"US"},"headquartersCountryName":{"type":"string","description":"Headquarters country","example":"United States"},"marketCapUsd":{"type":"number","description":"USD market cap as of the latest publish — served only when computed from shares outstanding × prices (as on the v3 companies list); null otherwise.","example":12798700000},"primaryListing":{"type":"object","properties":{"ticker":{"type":"string","example":"DT"},"exchangeCode":{"type":"string","description":"Listing exchange code","example":"NYSE"},"exchangeName":{"type":"string","example":"New York Stock Exchange"},"operatingMic":{"type":"string","description":"Operating MIC of the listing exchange","example":"XNYS"}},"required":["ticker","exchangeCode","exchangeName","operatingMic"]}},"required":["companyFiscalIdentifier","companyKey","displayNameEnglish","sector","industryGroup","industry","subIndustry","headquartersCountryCode","headquartersCountryName","marketCapUsd","primaryListing"]},"stats":{"type":"object","properties":{"letterCount":{"type":"number","example":42},"investorCount":{"type":"number","example":18},"fundCount":{"type":"number","example":25},"firstPeriod":{"type":"string","example":"2020Q1"},"latestPeriod":{"type":"string","example":"2026Q1"}},"required":["letterCount","investorCount","fundCount","firstPeriod","latestPeriod"]},"theses":{"type":"array","items":{"type":"object","properties":{"materialityBasis":{"type":"array","items":{"type":"string","example":"substantive_thesis"},"description":"Why this company discussion is material: substantive_thesis, performance_attribution, portfolio_action, meaningful_position_size, valuation_discussion, catalyst_discussion, risk_or_bear_case, substantive_negative_view, mistake_or_exit_review."},"relationship":{"type":"string","description":"The investor's relationship to the company in this letter: long, short, new_position, added, trimmed, sold, exited, watchlist, negative_research, or issuer.","example":"long"},"stance":{"type":"string","description":"Overall stance: bullish, bearish, mixed, or neutral.","example":"bullish"},"conviction":{"type":"string","description":"Conviction the letter expresses: high, medium, low, or unknown.","example":"high"},"positionSizePercent":{"type":"number","description":"Disclosed position size in percent, only when the letter states it for this security individually. Nullable.","example":3.7},"positionSizeBasis":{"type":"string","description":"What the percentage is measured against (portfolio, fund, nav, aum, net, gross, other). Nullable.","example":"net"},"positionSizeDescription":{"type":"string","description":"Qualitative sizing language when no number is disclosed. Nullable.","example":"top-five position"},"timeHorizon":{"type":"string","description":"Stated investment horizon: short_term, medium_term, or long_term. Nullable.","example":"long_term"},"thesisSummary":{"type":"string","description":"Concise summary of the investment thesis as argued in the letter.","example":"Category leader in observability with durable 25%+ ARR growth as AI workloads expand."},"sourceQuote":{"type":"string","description":"Representative verbatim quote from the letter. Nullable.","example":"We added to Dynatrace on weakness; observability spend is early in its AI-driven expansion."},"variantPerception":{"type":"string","description":"Where the investor believes they differ from consensus. Nullable."},"riskSummary":{"type":"string","description":"Risks the letter itself flags for this position. Nullable."},"catalystSummary":{"type":"string","description":"Catalysts the letter identifies. Nullable."},"valuationSummary":{"type":"string","description":"The letter's valuation argument. Nullable."},"businessQualitySummary":{"type":"string","description":"The letter's view on business quality/moat. Nullable."},"managementAssessment":{"type":"string","description":"The letter's assessment of management. Nullable."},"capitalAllocationSummary":{"type":"string","description":"The letter's view on capital allocation. Nullable."},"financialExpectations":{"type":"string","description":"Financial expectations the letter states (growth, margins, earnings power). Nullable."},"performanceOrActionSummary":{"type":"string","description":"What the position did for performance and/or what action the investor took. Nullable."},"decisionRelevantTakeaways":{"type":"array","items":{"type":"string"},"description":"Decision-relevant takeaways extracted from the discussion."},"monitoringPoints":{"type":"array","items":{"type":"string"},"description":"What the investor says they are watching from here."},"investor":{"type":"object","properties":{"investorId":{"type":"string","example":"fscl_investor_4SZX6KKJ822"},"investorName":{"type":"string","example":"Harris Associates / Oakmark"}},"required":["investorId","investorName"]},"fund":{"type":"object","properties":{"fundId":{"type":"string","example":"fscl_fund_9YFY9ZQK323"},"fundName":{"type":"string","example":"Oakmark Fund"}},"required":["fundId","fundName"]},"letter":{"type":"object","properties":{"letterId":{"type":"string","example":"fscl_document_9GDB7GDZ834"},"title":{"type":"string","example":"Oakmark Fund Quarterly Commentary - March 31, 2026"},"reportPeriod":{"type":"string","description":"Canonical reporting period (YYYYQn).","example":"2026Q1"},"reportPeriodYear":{"type":"number","example":2026},"reportPeriodQuarter":{"type":"number","example":1}},"required":["letterId","title","reportPeriod","reportPeriodYear","reportPeriodQuarter"]}},"required":["materialityBasis","relationship","stance","conviction","positionSizePercent","positionSizeBasis","positionSizeDescription","timeHorizon","thesisSummary","sourceQuote","variantPerception","riskSummary","catalystSummary","valuationSummary","businessQualitySummary","managementAssessment","capitalAllocationSummary","financialExpectations","performanceOrActionSummary","decisionRelevantTakeaways","monitoringPoints","investor","fund","letter"]},"description":"Every published thesis on this company, newest reporting period first."}},"required":["company","stats","theses"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/stock-splits":{"get":{"tags":["Stock splits"],"summary":"Get the stock splits for a company","description":"Provides all historical stock split and stock dividend events for the requested company, including split ratio and relevant dates.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyStockSplits","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"NVDA"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_NVDA"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"67066G104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US67066G1040"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BBK0R0"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"1045810"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC7FEP8CEG645"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"Stock splits","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"announceDate":{"type":"string","example":"2023-01-15"},"recordDate":{"type":"string","example":"2023-02-01"},"exDate":{"type":"string","example":"2023-02-05"},"payDate":{"type":"string","example":"2023-02-10"},"splitType":{"type":"string","enum":["Stock Split","Reverse Stock Split","Stock Dividend"],"example":"Stock Split"},"rate":{"type":"number","example":2}},"required":["splitType","rate"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v3/company/stock-prices":{"get":{"tags":["Stock prices"],"summary":"Get the stock prices for a company","description":"Returns the daily stock price series for the specified company, including open price, close price, and volume, in reverse chronological order (most recent first). Prices are quoted in the listing's trading currency and adjusted using the company's split history (the primary listing's corporate actions); listing-specific actions such as ADR ratio changes are not yet applied to secondary series. When the request denotes a secondary listing, that listing's own price series is returned; if it is unavailable, the primary listing's prices are returned as a fallback. Unlike /v2, the response identifies the exact listing the prices belong to (`listingFiscalIdentifier`, `ticker`, `exchangeCode`, `tradingCurrency`, `tradingStatus`), so callers always know whether they received the primary or a secondary listing.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyStockPricesV3","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Filter prices from this date onwards (YYYY-MM-DD format)","example":"2024-01-01"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Filter prices up to and including this date (YYYY-MM-DD format)","example":"2024-12-31"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"boolean","description":"If true, returns only the most recent stock price"},"required":false,"description":"If true, returns only the most recent stock price","name":"latest","in":"query"}],"responses":{"200":{"description":"Stock prices, with the identity of the listing they belong to","content":{"application/json":{"schema":{"type":"object","properties":{"listingFiscalIdentifier":{"type":"string","description":"Fiscal.ai stable identifier of the listing these prices belong to.","example":"FSCLL8TBZ3EGU251"},"ticker":{"type":"string","description":"Ticker of the listing these prices belong to.","example":"MSFT"},"exchangeCode":{"type":"string","description":"Exchange code of the listing these prices belong to.","example":"NASDAQ"},"operatingMic":{"type":"string","description":"Operating MIC of the listing exchange.","example":"XNAS"},"segmentMic":{"type":"string","description":"Segment MIC of the listing exchange.","example":"XNGS"},"tradingCurrency":{"type":"string","description":"Currency the prices are quoted in.","example":"USD"},"tradingStatus":{"type":"string","enum":["active","delisted","pre_ipo","suspended"],"description":"Trading status of the listing these prices belong to.","example":"active"},"prices":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","example":"2025-07-10"},"openPrice":{"type":["number","null"],"example":193.12},"closePrice":{"type":"number","example":195.38},"volume":{"type":"number","example":5432100}},"required":["date","openPrice","closePrice","volume"]},"description":"Daily split-adjusted price series, most recent first."}},"required":["ticker","exchangeCode","prices"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v2/company/stock-prices":{"get":{"tags":["Deprecated"],"summary":"[DEPRECATED] Get the stock prices for a company (use /v3/company/stock-prices instead)","description":"Returns the daily stock price series for the specified company, including open price, close price, and volume. Prices are split-adjusted, expressed in the company reporting currency where applicable, and returned in reverse chronological order (most recent first). Secondary listings return their own price series; if unavailable, the primary listing's prices are returned as a fallback — but the response does not indicate which listing was returned. This endpoint is deprecated, please use /v3/company/stock-prices instead, which identifies the exact listing the prices belong to.","deprecated":true,"security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyStockPricesV2","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Filter prices from this date onwards (YYYY-MM-DD format)","example":"2024-01-01"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Filter prices up to and including this date (YYYY-MM-DD format)","example":"2024-12-31"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"boolean","description":"If true, returns only the most recent stock price"},"required":false,"description":"If true, returns only the most recent stock price","name":"latest","in":"query"}],"responses":{"200":{"description":"Stock prices","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","example":"2025-07-10"},"open_price":{"type":["number","null"],"example":193.12},"close_price":{"type":"number","example":195.38},"volume":{"type":"number","example":5432100}},"required":["date","open_price","close_price","volume"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/stock-prices/intraday":{"get":{"tags":["Stock prices"],"summary":"Get the intraday stock prices for a company","description":"Returns the intraday stock price series for the specified company, with datetime and price for each trade. Prices are split-adjusted and rounded to 2 decimal places.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyIntradayStockPrices","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Filter prices from this date onwards (YYYY-MM-DD format)","example":"2024-01-01"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Filter prices up to and including this date (YYYY-MM-DD format)","example":"2024-12-31"},"required":false,"name":"endDate","in":"query"}],"responses":{"200":{"description":"Intraday stock prices","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"datetime":{"type":"string","example":"2026-04-14T04:19:17"},"price":{"type":"number","example":123.12}},"required":["datetime","price"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v2/company/filings":{"get":{"tags":["Companies"],"summary":"Get filings for a company","description":"Retrieves a list of filings for the specified company from the last 20 years. Currently supports:\n- Annual Report\n- Interim Report\n- Earnings Press Release\n- Current Report\n- Initial Registration Statement\n\nThe fiscal year, quarter, and report date are only available if there was financial data extracted from the filing.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyGlobalFilings","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"An array of filings","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"filingId":{"type":"string","description":"Unique filing identifier","example":"0000002208-25-4901693"},"documentType":{"type":"string","enum":["Annual Report","Annual Report (Amended)","Interim Report","Interim Report (Amended)","Earnings Press Release","Earnings Press Release (Amended)","Initial Registration Statement","Initial Registration Statement (Amended)","Current Report","Current Report (Amended)"],"description":"Type of document: Annual Report, Annual Report (Amended), Interim Report, Interim Report (Amended), Earnings Press Release, Earnings Press Release (Amended), Initial Registration Statement, Initial Registration Statement (Amended), Current Report, Current Report (Amended)","example":"Earnings Press Release"},"secFormType":{"type":"string","description":"The SEC form type of the filing","example":"10-K"},"secExhibitType":{"type":"string","description":"The SEC exhibit type of the filing (e.g., EX-99.1 for earnings press releases)","example":"EX-99.1"},"filingDate":{"type":"string","description":"The date the filing was filed at","example":"2025-02-26"},"reportDate":{"type":"string","description":"If the report is an Annual Report, Interim Report, or an Earnings Press Release, the company's reporting date.","example":"2024-12-31"},"fiscalYear":{"type":"integer","description":"If the report is an Annual Report, Interim Report, or an Earnings Press Release, the company's reporting fiscal year.","example":2024},"fiscalQuarter":{"type":"integer","description":"If the report is an Annual Report, Interim Report, or an Earnings Press Release, the company's reporting fiscal quarter.","example":4},"pdfUrl":{"type":"string","description":"URL to the PDF of the filing","example":"https://api.fiscal.ai/v1/filing/0000002208-25-4901693/pdf?companyKey=TSX_TOI"},"sourceUrl":{"type":"string","description":"The source to the original document, for now supports SEC only.","example":"https://www.sedarplus.ca/csa-party/records/document.html?id=34628a35c29576e2221ea35daaba7999b10cd4c4604b19f72b3c4620508ca224"}},"required":["filingId","documentType","filingDate","pdfUrl"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/filing/{filingId}/page/{pageNumber}/image":{"get":{"tags":["Filings"],"summary":"Get an image of a filing page","description":"Fetches a high-resolution JPEG image of the specified page from the original SEC filing document. Suitable for embedding in client applications for source traceability.","security":[{"ApiKeyAuth":[]}],"operationId":"get_SourceImage","parameters":[{"schema":{"type":"string","description":"Filing ID","example":"0000950170-25-061046"},"required":true,"description":"Filing ID","name":"filingId","in":"path"},{"schema":{"type":"number","description":"Page number","example":3},"required":true,"description":"Page number","name":"pageNumber","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"Page image","content":{"image/jpeg":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"string"},"format":{"type":"string","example":"binary"}},"required":["type","format"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/filing/{filingId}/pdf":{"get":{"tags":["Filings"],"summary":"Get the full PDF of a filing","description":"Downloads the complete PDF version of the filing referenced by its accession number. Served with the 'financials_sourcing' or 'filings' features; with only 'ir_events', serves exactly the documents the /v1/company/ir-events endpoint references (interim/annual reports, slide decks, press releases).","security":[{"ApiKeyAuth":[]}],"operationId":"get_SourcePdf","parameters":[{"schema":{"type":"string","description":"Filing ID","example":"0000950170-25-061046"},"required":true,"description":"Filing ID","name":"filingId","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"Filing PDF","content":{"application/pdf":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"string"},"format":{"type":"string","example":"binary"}},"required":["type","format"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/ir-events":{"get":{"tags":["IR Events"],"summary":"Get a company's IR events (currently earnings events)","description":"Lists the resources attached to a company's IR events — currently earnings events, with more event types to come. Rows that share a fiscal period belong to the same event: the interim/annual report(s), the slide deck, the press release, and — when a call was held — the transcript and audio recording.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyIrEvents","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"An array of IR event resources","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"eventType":{"type":"string","description":"The IR event type. Currently only 'earnings'.","example":"earnings"},"eventDate":{"type":"string","description":"The event date (call date when known).","example":"2026-04-29"},"fiscalYear":{"type":"integer","description":"Fiscal year of the event.","example":2026},"fiscalQuarter":{"type":"integer","description":"Fiscal quarter (annual report = 4).","example":3},"resourceType":{"type":"string","enum":["document","transcript","audio"],"description":"The type of resource attached to the event.","example":"document"},"role":{"type":"string","description":"interim_report | annual_report | slide_deck | press_release | transcript | audio","example":"slide_deck"},"resourceId":{"type":"string","description":"For documents: the filing_id — resolve the PDF via /v1/filing/{filing_id}/pdf. For transcript/audio: the event key.","example":"0000000849-26-32024663"},"url":{"type":"string","description":"The fiscal.ai URL that serves this resource.","example":"https://api.fiscal.ai/v1/filing/0000000849-26-32024663/pdf?companyKey=NASDAQ_MSFT"}},"required":["eventType","resourceType","role","resourceId","url"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/ir-events/transcript/{eventKey}":{"get":{"tags":["IR Events"],"summary":"Get the transcript for an earnings event","description":"Returns the structured transcript for an earnings event: event fiscal identity, speaker mapping (label, name, role, company, speaker type), transcript text, paragraphs, sentence timestamps, Q&A section timing, and summary counts. `eventKey` is the q{quarter}-{year} key from the /v1/company/ir-events list.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyIrEventTranscript","parameters":[{"schema":{"type":"string","description":"Event key (q{quarter}-{year})","example":"q3-2026"},"required":true,"description":"Event key (q{quarter}-{year})","name":"eventKey","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"The event transcript, including speakers, paragraphs, sentence timings, and sections.","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"eventKey":{"type":"string","description":"Event key (q{quarter}-{year}; annual events use q4).","example":"q3-2026"},"fiscalYear":{"type":"integer","example":2026},"fiscalQuarter":{"type":"integer","example":3},"eventDate":{"type":"string","description":"The call date when known.","example":"2026-04-29"}},"required":["eventKey"]},"speakers":{"type":"array","items":{"type":"object","properties":{"speaker":{"type":"integer","description":"Speaker number referenced by paragraphs and sentences.","example":3},"label":{"type":"string","description":"The label used in the transcript text.","example":"Satya Nadella"},"name":{"type":"string","example":"Satya Nadella"},"role":{"type":"string","example":"Chairman and Chief Executive Officer"},"company":{"type":"string","example":"Microsoft Corporation"},"speakerType":{"type":"string","description":"operator | company_management | analyst | other | unknown","example":"company_management"}}}},"transcript":{"type":"object","properties":{"text":{"type":"string","description":"The full transcript text with [seconds] timestamps and speaker labels.","example":"[1.70s] Operator: Greetings and welcome to the Microsoft Fiscal Year 2026 Third Quarter Earnings Conference Call. …"},"paragraphs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"p-0"},"text":{"type":"string","example":"Greetings and welcome to the Microsoft Fiscal Year 2026 Third Quarter Earnings Conference Call. At this time, all participants are in a listen-only mode."},"start":{"type":"number","description":"Start time in seconds from the start of the call.","example":1.702},"end":{"type":"number","description":"End time in seconds from the start of the call.","example":32.116},"speaker":{"type":"integer","description":"Speaker number, resolved via the speakers list.","example":1},"sentences":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"s-0"},"text":{"type":"string","example":"Greetings and welcome to the Microsoft Fiscal Year 2026 Third Quarter Earnings Conference Call."},"start":{"type":"number","description":"Start time in seconds from the start of the call.","example":1.702},"end":{"type":"number","description":"End time in seconds from the start of the call.","example":7.982},"speaker":{"type":"integer","description":"Speaker number, resolved via the speakers list.","example":1}},"required":["text"]}}},"required":["text","sentences"]}}},"required":["text","paragraphs"]},"sections":{"type":"array","items":{"type":"object","properties":{"sectionType":{"type":"string","description":"Call section type. Currently 'qa' (the Q&A portion).","example":"qa"},"start":{"type":"number","description":"Section start in seconds.","example":2143.8},"end":{"type":"number","description":"Section end in seconds.","example":3723.93}},"required":["sectionType"]}},"stats":{"type":"object","properties":{"speakerCount":{"type":"integer","example":11},"paragraphCount":{"type":"integer","example":100},"sentenceCount":{"type":"integer","example":516}},"required":["speakerCount","paragraphCount","sentenceCount"]}},"required":["event","speakers","transcript","sections","stats"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/ir-events/audio/{eventKey}":{"get":{"tags":["IR Events"],"summary":"Get the audio recording for an earnings event","description":"Streams the recording of an earnings event's call — audio, or for some events a video file; the response Content-Type reflects the stored recording. `eventKey` is the q{quarter}-{year} key from the /v1/company/ir-events list.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyIrEventAudio","parameters":[{"schema":{"type":"string","description":"Event key (q{quarter}-{year})","example":"q3-2026"},"required":true,"description":"Event key (q{quarter}-{year})","name":"eventKey","in":"path"},{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"Event call audio","content":{"audio/mpeg":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"string"},"format":{"type":"string","example":"binary"}},"required":["type","format"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/companies-list":{"get":{"tags":["Deprecated"],"summary":"[DEPRECATED] Get a list of all companies (use /v3/companies-list instead)","description":"Lists all companies available in the dataset together with basic descriptors and the types of data available for each company. This endpoint is deprecated, please use /v3/companies-list instead.","deprecated":true,"security":[{"ApiKeyAuth":[]}],"operationId":"get_LegacyCompaniesList","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"}],"responses":{"200":{"description":"An array of companies","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"Visa Inc."},"ticker":{"type":"string","example":"V"},"cik":{"type":"string","example":"1403161"},"exchangeName":{"type":"string","example":"New York Stock Exchange"},"exchangeSymbol":{"type":"string","example":"NYSE"},"country":{"type":"string","example":"United States"},"countryCode":{"type":"string","example":"US"},"sector":{"type":"string","example":"Financials"},"industryGroup":{"type":"string","example":"Financial Services"},"industry":{"type":"string","example":"Financial Services"},"subIndustry":{"type":"string","example":"Transaction & Payment Processing Services"},"reportingTemplate":{"type":"string","example":"Standard"},"dataAvailable":{"type":"array","items":{"type":"string","example":"financials"}},"isReadyForTerminal":{"type":"boolean"},"cusip":{"type":"array","items":{"type":"string","example":"92826C839"}},"isin":{"type":"array","items":{"type":"string","example":"US92826C8394"}}},"required":["name","ticker","exchangeName","exchangeSymbol","country","countryCode","sector","industryGroup","industry","subIndustry","reportingTemplate","dataAvailable","cusip","isin"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/profile":{"get":{"tags":["Deprecated"],"summary":"[DEPRECATED] Get profile for a single company (use /v3/company/profile instead)","description":"Retrieves a detailed company profile including sector, industry, descriptions and lists the datasets currently available under the Fiscal.ai system. This endpoint is deprecated, please use /v3/company/profile instead.","deprecated":true,"security":[{"ApiKeyAuth":[]}],"operationId":"get_LegacyCompanyProfile","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"Company profile","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","example":"Visa Inc."},"ticker":{"type":"string","example":"V"},"cik":{"type":"string","example":"1403161"},"exchangeName":{"type":"string","example":"New York Stock Exchange"},"exchangeSymbol":{"type":"string","example":"NYSE"},"countryName":{"type":"string","example":"United States"},"countryCode":{"type":"string","example":"US"},"sector":{"type":"string","example":"Financials"},"industryGroup":{"type":"string","example":"Financial Services"},"industry":{"type":"string","example":"Financial Services"},"subIndustry":{"type":"string","example":"Transaction & Payment Processing Services"},"reportingTemplate":{"type":"string","example":"Standard"},"reportingCurrency":{"type":"string","example":"USD"},"tradingCurrency":{"type":"string","example":"USD"},"dataAvailable":{"type":"array","items":{"type":"string","example":"financials"}},"description":{"type":"string","example":"Visa Inc. is a global payments technology company that facilitates electronic fund transfers among consumers, merchants, financial institutions, and governments in over 200 countries and territories..."},"shortDescription":{"type":"string","example":"Visa Inc. is a global payments technology company based in Foster City, California, that processes electronic transactions in over 200 countries..."},"isReadyForTerminal":{"type":"boolean"},"cusip":{"type":"array","items":{"type":"string","example":"92826C839"}},"isin":{"type":"array","items":{"type":"string","example":"US92826C8394"}}},"required":["name","ticker","exchangeName","exchangeSymbol","countryName","countryCode","sector","industryGroup","industry","subIndustry","reportingTemplate","reportingCurrency","dataAvailable","description","shortDescription","cusip","isin"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/filings":{"get":{"tags":["Deprecated"],"summary":"[DEPRECATED] Get filings for a company (use /v2/company/filings instead)","description":"Retrieves a list of filings for the specified company from the last 20 years. This endpoint is deprecated, please use /v2/company/filings instead.","deprecated":true,"security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanySecFilings","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"A list of filings","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"filing_id":{"type":"string","description":"Unique filing identifier","example":"0000950170-25-100235"},"document_type":{"type":"string","description":"Type of document: Annual Report, Quarterly Report, Press Release, or Other","example":"Annual Report"},"filing_date":{"type":"string","description":"Date the filing was submitted","example":"2025-08-01"},"report_date":{"type":"string","description":"Date of the report","example":"2025-06-28"},"pdf_url":{"type":"string","description":"URL to the PDF of the filing","example":"https://api.fiscal.ai/v1/filing/0000950170-25-100235/pdf?ticker=MSFT&exchange=NASDAQ"}},"required":["filing_id","document_type","filing_date","report_date","pdf_url"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/stock-prices":{"get":{"tags":["Deprecated"],"summary":"[DEPRECATED] Get the stock prices for a company (use /v2/company/stock-prices instead)","description":"Returns the daily closing share price series for the specified company in reverse chronological order (most recent first). This endpoint is deprecated, please use /v2/company/stock-prices instead.","deprecated":true,"security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyStockPrices","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Filter prices from this date onwards (YYYY-MM-DD format)","example":"2024-01-01"},"required":false,"name":"startDate","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Filter prices up to and including this date (YYYY-MM-DD format)","example":"2024-12-31"},"required":false,"name":"endDate","in":"query"},{"schema":{"type":"boolean","description":"If true, returns only the most recent stock price"},"required":false,"description":"If true, returns only the most recent stock price","name":"latest","in":"query"}],"responses":{"200":{"description":"Stock prices","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","example":"2025-07-10"},"price":{"type":"number","example":195.38}},"required":["date","price"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/events-calendar":{"get":{"tags":["Events Calendar"],"summary":"Get past and upcoming company events","description":"Returns company earnings events. Omit company identifiers to retrieve the global calendar, or provide one or more comma-separated identifiers of a single type to filter the calendar by company. Results are sorted by eventDate in ascending order. Use page and pageSize to paginate large result sets.","security":[{"ApiKeyAuth":[]},{"HeaderApiKeyAuth":[]}],"operationId":"get_EventsCalendar","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"One or more comma-separated Fiscal.ai company, listing, or security identifiers (FSCLC, FSCLL, or FSCLS); each resolves to its canonical company.","example":"FSCLC4VNY8NEQ478"},"required":false,"description":"One or more comma-separated Fiscal.ai company, listing, or security identifiers (FSCLC, FSCLL, or FSCLS); each resolves to its canonical company.","name":"fscl","in":"query"},{"schema":{"type":"string","description":"One or more comma-separated company keys.","example":"NASDAQ_AAPL"},"required":false,"description":"One or more comma-separated company keys.","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"One or more comma-separated company tickers. Use alone for US tickers, or pair with exchange or micCode.","example":"AAPL"},"required":false,"description":"One or more comma-separated company tickers. Use alone for US tickers, or pair with exchange or micCode.","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Exchange code used with ticker. Supply one value for all tickers or a comma-separated value for each ticker.","example":"NASDAQ"},"required":false,"description":"Exchange code used with ticker. Supply one value for all tickers or a comma-separated value for each ticker.","name":"exchange","in":"query"},{"schema":{"type":"string","description":"MIC used with ticker. Supply one value for all tickers or a comma-separated value for each ticker.","example":"XNAS"},"required":false,"description":"MIC used with ticker. Supply one value for all tickers or a comma-separated value for each ticker.","name":"micCode","in":"query"},{"schema":{"type":"string","description":"One or more comma-separated CUSIPs. Requires the CUSIP/ISIN license.","example":"037833100"},"required":false,"description":"One or more comma-separated CUSIPs. Requires the CUSIP/ISIN license.","name":"cusip","in":"query"},{"schema":{"type":"string","description":"One or more comma-separated ISINs. Requires the CUSIP/ISIN license.","example":"US0378331005"},"required":false,"description":"One or more comma-separated ISINs. Requires the CUSIP/ISIN license.","name":"isin","in":"query"},{"schema":{"type":"string","description":"One or more comma-separated Financial Instrument Global Identifiers (FIGIs).","example":"BBG000B9XRY4"},"required":false,"description":"One or more comma-separated Financial Instrument Global Identifiers (FIGIs).","name":"figi","in":"query"},{"schema":{"type":"string","description":"One or more comma-separated SEC Central Index Keys (CIKs).","example":"0000320193"},"required":false,"description":"One or more comma-separated SEC Central Index Keys (CIKs).","name":"cik","in":"query"},{"schema":{"type":"string","description":"Filter by ISO country code of the company's headquarters (case-insensitive, e.g. US, GB).","example":"US"},"required":false,"description":"Filter by ISO country code of the company's headquarters (case-insensitive, e.g. US, GB).","name":"country","in":"query"},{"schema":{"type":"string","description":"Filter by GICS sector (case-insensitive exact match).","example":"Information Technology"},"required":false,"description":"Filter by GICS sector (case-insensitive exact match).","name":"sector","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive lower bound (YYYY-MM-DD). Non-projected events compare eventDate; projected events match when dateWindow overlaps the requested range.","example":"2026-05-01"},"required":false,"description":"Inclusive lower bound (YYYY-MM-DD). Non-projected events compare eventDate; projected events match when dateWindow overlaps the requested range.","name":"startDate","in":"query"},{"schema":{"type":"string","format":"date","description":"Inclusive upper bound (YYYY-MM-DD). Non-projected events compare eventDate; projected events match when dateWindow overlaps the requested range.","example":"2026-05-31"},"required":false,"description":"Inclusive upper bound (YYYY-MM-DD). Non-projected events compare eventDate; projected events match when dateWindow overlaps the requested range.","name":"endDate","in":"query"},{"schema":{"type":"string","enum":["confirmed","estimated","projected","reported"],"description":"Filter by event status: confirmed (company-stated date), estimated (source-derived specific date), projected (cadence-derived window), or reported (occurred).","example":"confirmed"},"required":false,"description":"Filter by event status: confirmed (company-stated date), estimated (source-derived specific date), projected (cadence-derived window), or reported (occurred).","name":"status","in":"query"},{"schema":{"type":"integer","minimum":1,"description":"1-based page number. Requires pageSize.","example":1},"required":false,"description":"1-based page number. Requires pageSize.","name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":1000,"description":"Page size (1-1000). Without it, a result over 1000 rows is rejected — paginate or narrow filters.","example":250},"required":false,"description":"Page size (1-1000). Without it, a result over 1000 rows is rejected — paginate or narrow filters.","name":"pageSize","in":"query"}],"responses":{"200":{"description":"Object containing a data array of company events plus pagination meta","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"companyFiscalIdentifier":{"type":["string","null"],"examples":["FSCLC4VNY8NEQ478"]},"companyKey":{"type":"string","examples":["NASDAQ_AAPL"]},"displayNameEnglish":{"type":["string","null"],"examples":["Apple Inc."]},"sector":{"type":["string","null"],"examples":["Information Technology"]},"headquartersCountryCode":{"type":["string","null"],"examples":["US"]},"marketCapUsd":{"type":["number","null"],"examples":[4618730000000]},"primaryListing":{"type":["object","null"],"properties":{"ticker":{"type":["string","null"],"examples":["AAPL"]},"exchangeCode":{"type":["string","null"],"examples":["NASDAQ"]},"exchangeName":{"type":["string","null"],"examples":["Nasdaq Stock Market"]},"operatingMic":{"type":["string","null"],"examples":["XNAS"]}},"required":["ticker","exchangeCode","exchangeName","operatingMic"]},"eventType":{"type":"string","enum":["earnings"],"examples":["earnings"]},"eventRole":{"type":"string","enum":["financial_results_release","earnings_call_for_results","periodic_financial_report","scheduled_trading_or_revenue_update"],"examples":["earnings_call_for_results"],"description":"Function of the event within its type, in the producer's vocabulary — e.g. financial_results_release, earnings_call_for_results, periodic_financial_report, scheduled_trading_or_revenue_update."},"title":{"type":["string","null"],"examples":["Q3 2026 Earnings Call"]},"fiscalYear":{"type":["integer","null"],"examples":[2026]},"fiscalQuarter":{"type":["integer","null"],"enum":[1,2,3,4,null],"examples":[3]},"periodLabel":{"type":["string","null"],"examples":["Q3 2026"],"description":"Period label as published on the company's calendar (producer-normalized formatting)."},"periodType":{"type":["string","null"],"enum":["quarterly","semi_annual","ytd","annual","transition",null],"examples":["quarterly"]},"periodDuration":{"type":["object","null"],"description":"Actual span reported by the company, rather than the canonical calculation duration used by Financials.","properties":{"amount":{"type":"integer","minimum":1,"examples":[15]},"unit":{"type":"string","enum":["day","week","month","year"],"examples":["month"]}},"required":["amount","unit"]},"reportDate":{"type":["string","null"],"format":"date","examples":["2026-03-31"],"description":"End date of the reported fiscal period, matching the Financials reportDate convention."},"eventStatus":{"type":["string","null"],"enum":["confirmed","estimated","projected","reported",null],"examples":["confirmed"],"description":"confirmed = company-stated date, estimated = source-derived specific date, projected = cadence-derived window, reported = occurred."},"eventDate":{"type":"string","format":"date","examples":["2026-07-30"]},"dateWindow":{"type":["object","null"],"description":"Non-null iff eventStatus=projected.","properties":{"start":{"type":"string","format":"date","examples":["2027-01-19"]},"end":{"type":"string","format":"date","examples":["2027-02-02"]}},"required":["start","end"]},"eventSession":{"type":["string","null"],"enum":["before_open","during_market","after_close",null],"examples":["before_open"],"description":"Market session of the event on the company's primary listing venue: stated by the source, or derived from the venue's trading hours when only an exact time is known. Null when neither is available."},"eventTime":{"type":["string","null"],"format":"time","examples":["14:00:00"]},"eventTimezone":{"type":["string","null"],"examples":["America/Los_Angeles"],"description":"Canonical IANA timezone name for eventTime."},"eventDatetimeUtc":{"type":["string","null"],"format":"date-time","examples":["2026-07-30T21:00:00Z"]},"eventId":{"type":["string","null"],"examples":["85339f8b8a082040"]},"eventGroupId":{"type":["string","null"],"examples":["c1b017a1dea50848"]}},"required":["companyFiscalIdentifier","companyKey","displayNameEnglish","sector","headquartersCountryCode","marketCapUsd","primaryListing","eventType","eventRole","title","fiscalYear","fiscalQuarter","periodLabel","periodType","periodDuration","reportDate","eventStatus","eventDate","dateWindow","eventSession","eventTime","eventTimezone","eventDatetimeUtc","eventId","eventGroupId"]}},"meta":{"type":"object","properties":{"page":{"type":"integer","examples":[1]},"pageSize":{"type":"integer","examples":[100]},"totalCount":{"type":"integer","examples":[8940]},"returnedCount":{"type":"integer","examples":[100]},"hasMore":{"type":"boolean","examples":[true]},"nextPage":{"type":"integer","examples":[2]},"publicationVersion":{"type":"string","examples":["1784289600~20260717T120000000000Z~history-20260717~1784289000"]}},"required":["page","pageSize","totalCount","returnedCount","hasMore","publicationVersion"]}},"required":["data","meta"],"example":{"data":[{"companyFiscalIdentifier":"FSCLC4VNY8NEQ478","companyKey":"NASDAQ_AAPL","displayNameEnglish":"Apple Inc.","sector":"Information Technology","headquartersCountryCode":"US","marketCapUsd":4618730000000,"primaryListing":{"ticker":"AAPL","exchangeCode":"NASDAQ","exchangeName":"Nasdaq Stock Market","operatingMic":"XNAS"},"eventType":"earnings","eventRole":"financial_results_release","title":"Q3 2026 Earnings Release","fiscalYear":2026,"fiscalQuarter":3,"periodLabel":"Q3 2026","periodType":"quarterly","periodDuration":{"amount":3,"unit":"month"},"reportDate":"2026-06-27","eventStatus":"confirmed","eventDate":"2026-07-30","dateWindow":null,"eventSession":"after_close","eventTime":null,"eventTimezone":null,"eventDatetimeUtc":null,"eventId":"46e66399b9e63243","eventGroupId":"c1b017a1dea50848"},{"companyFiscalIdentifier":"FSCLC4VNY8NEQ478","companyKey":"NASDAQ_AAPL","displayNameEnglish":"Apple Inc.","sector":"Information Technology","headquartersCountryCode":"US","marketCapUsd":4618730000000,"primaryListing":{"ticker":"AAPL","exchangeCode":"NASDAQ","exchangeName":"Nasdaq Stock Market","operatingMic":"XNAS"},"eventType":"earnings","eventRole":"earnings_call_for_results","title":"Q3 2026 Earnings Call","fiscalYear":2026,"fiscalQuarter":3,"periodLabel":"Q3 2026","periodType":"quarterly","periodDuration":{"amount":3,"unit":"month"},"reportDate":"2026-06-27","eventStatus":"confirmed","eventDate":"2026-07-30","dateWindow":null,"eventSession":"after_close","eventTime":"14:00:00","eventTimezone":"America/Los_Angeles","eventDatetimeUtc":"2026-07-30T21:00:00Z","eventId":"85339f8b8a082040","eventGroupId":"c1b017a1dea50848"}],"meta":{"page":1,"pageSize":2,"totalCount":2,"returnedCount":2,"hasMore":false}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","examples":["startDate must be a valid calendar date in YYYY-MM-DD format"]}}}}}}}}},"403":{"description":"Missing feature","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","examples":["Events calendar access requires the `fiscal_earnings_calendar` feature. Contact sales at https://fiscal.ai/contact-sales."]}}}}}}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","examples":["Company not found. Use the /v3/companies-list endpoint to see available companies."]}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","examples":["Rate limit exceeded for free trial."]}}}}}}}}},"500":{"description":"Calendar data temporarily unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","examples":["Events calendar is temporarily unavailable. Please try again later."]}}}}}}}}},"503":{"description":"Company directory temporarily unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","examples":["Events calendar is temporarily unavailable. Please try again later."]}}}}}}}}}}}},"/v1/company/earnings-summary":{"get":{"tags":["Earnings"],"summary":"Get the latest earnings summary for a company","description":"Returns the latest quarterly EPS and revenue figures as reported by the company, mimicking a typical earnings calendar payload.","security":[{"ApiKeyAuth":[]}],"operationId":"get_EarningsSummary","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"}],"responses":{"200":{"description":"Earnings summary","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"date":{"type":"string"},"period":{"type":"string"},"epsActual":{"type":"number"},"revenueActual":{"type":"number"}},"required":["symbol","date","period"]}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}},"/v1/company/adjusted-numbers":{"get":{"tags":["Adjusted Metrics"],"summary":"Get the latest adjusted metrics for a company","description":"Returns the adjusted metrics for a company.","security":[{"ApiKeyAuth":[]}],"operationId":"get_CompanyAdjustedNumbers","parameters":[{"schema":{"type":"string","description":"API Key (alternatively send via X-Api-Key header)"},"required":false,"description":"API Key (alternatively send via X-Api-Key header)","name":"apiKey","in":"query"},{"schema":{"type":"string","description":"Company ticker, use with mic or alone for US tickers","example":"MSFT"},"required":false,"description":"Company ticker, use with mic or alone for US tickers","name":"ticker","in":"query"},{"schema":{"type":"string","description":"Company MIC, use with ticker","example":"XNAS"},"required":false,"description":"Company MIC, use with ticker","name":"micCode","in":"query"},{"schema":{"type":"string","description":"Company exchange code, use with ticker","example":"NASDAQ"},"required":false,"description":"Company exchange code, use with ticker","name":"exchange","in":"query"},{"schema":{"type":"string","description":"Company key (alternative to ticker/micCode/exchange)","example":"NASDAQ_MSFT"},"required":false,"description":"Company key (alternative to ticker/micCode/exchange)","name":"companyKey","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","example":"594918104"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP","name":"cusip","in":"query"},{"schema":{"type":"string","description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","example":"US5949181045"},"required":false,"description":"Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN","name":"isin","in":"query"},{"schema":{"type":"string","description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","example":"BBG000BPH459"},"required":false,"description":"FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.","name":"figi","in":"query"},{"schema":{"type":"string","description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","example":"789019"},"required":false,"description":"Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.","name":"cik","in":"query"},{"schema":{"type":"string","description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","example":"FSCLC6CGT4DXS597"},"required":false,"description":"Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.","name":"fscl","in":"query"},{"schema":{"type":"string","default":"annual","description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","example":"annual,quarterly"},"required":false,"description":"Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.","name":"periodType","in":"query"},{"schema":{"type":"string","pattern":"^[a-zA-Z]{3,4}$","description":"ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be 3-4 letters. Defaults to company's reporting currency.","example":"CAD"},"required":false,"name":"currency","in":"query"}],"responses":{"200":{"description":"Adjusted metrics","content":{"application/json":{"schema":{"type":"object","properties":{"metrics":{"type":"array","items":{"type":"object","properties":{"metricId":{"type":"string","example":"adjusted_revenue"},"metricName":{"type":"string","example":"Adjusted Revenue"},"metricFormat":{"type":"string","example":"number"},"isCurrency":{"type":"boolean","example":true},"isPerShare":{"type":"boolean"},"isKeyMetric":{"type":"boolean"}},"required":["metricId","metricName","metricFormat","isCurrency","isPerShare","isKeyMetric"]}},"data":{"type":"array","items":{"type":"object","properties":{"periodId":{"type":"string","example":"3_Quarterly_2025-04-27"},"periodType":{"type":"string","enum":["Annual","Quarterly","Semi-Annual","LTM","YTD"],"example":"Quarterly"},"reportDate":{"type":"string","example":"2025-04-27"},"periodDuration":{"type":"string","example":"3 months"},"calendarYear":{"type":"number","example":2025},"calendarQuarter":{"type":"number","example":2},"fiscalYear":{"type":"number","example":2026},"fiscalQuarter":{"type":"number","example":1},"isStubPeriod":{"type":"boolean","description":"Whether this is a stub/transition period"},"stubType":{"type":"string","enum":["fye","inception"],"description":"Stub type: fye (fiscal year-end change) or inception (first reporting period)","example":"fye"},"stubDuration":{"type":"number","description":"Actual duration of the stub period in days","example":214},"earningsDate":{"type":"string","example":"2025-08-27"},"earningsTimeOfDay":{"type":"string","example":"16:22:14Z"},"lastSourceFilingDate":{"type":"string","example":"2025-08-27"},"lastSourceFilingTimeOfDay":{"type":"string","example":"16:22:14Z"},"isRestated":{"type":"boolean","description":"Whether this period contains restated data (data differs from original filing)"},"metricValues":{"type":"object","properties":{"value":{"type":"number","example":264258909200},"unit":{"type":"string","example":"M"},"currency":{"type":"string","example":"EUR"},"adjusted":{"type":"boolean","example":true},"originalValue":{"type":"number","description":"Original value before currency conversion","example":294866000000},"originalCurrency":{"type":"string","description":"Currency the value is reported in","example":"USD"},"appliedExchangeRate":{"type":"number","description":"Exchange rate applied for conversion","example":0.8962},"sources":{"type":"array","items":{"type":"object","properties":{"document":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/pdf?ticker=AAPL&exchange=NASDAQ"},"image":{"type":"string","example":"https://api.fiscal.ai/v1/filing/0000320193-24-000123/page/32/image?ticker=AAPL&exchange=NASDAQ"},"pageNumber":{"type":"number","example":32},"originalSourceUrl":{"type":"string","description":"The source to the original document, for now supports SEC only.","example":"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"}},"required":["document"]}}},"required":["value","unit","currency","adjusted","sources"]}},"required":["periodId","periodType","reportDate","periodDuration","calendarYear","calendarQuarter","metricValues"]}}},"required":["metrics","data"]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Missing required parameters: either Company Key, CUSIP, ISIN, or Ticker + Exchange"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Invalid api key"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"errors":{"type":"object","properties":{"type":{"type":"string","example":"array"},"items":{"type":"object","properties":{"type":{"type":"string","example":"object"},"properties":{"type":"object","properties":{"message":{"type":"object","properties":{"type":{"type":"string","example":"string"},"example":{"type":"string","example":"Not Found"}},"required":["type","example"]}},"required":["message"]}},"required":["type","properties"]}},"required":["type","items"]}},"required":["errors"]}},"required":["type","properties"]}}}}}}}},"webhooks":{}}