{ "opencollection": "1.0.0", "info": { "name": "Factset Analytics Datastore About Financial Statements API", "version": "1.0.0" }, "request": { "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "items": [ { "info": { "name": "Financial Statements", "type": "folder" }, "items": [ { "info": { "name": "Factset Returns Company Fundamental Data.", "type": "http" }, "http": { "method": "GET", "url": "https://api.factset.com/fundamentals", "params": [ { "name": "ids", "value": "", "type": "query", "description": "The requested list of security identifiers. Accepted ID types include Market Tickers, SEDOL, ISINs, CUSIPs, or FactSet Permanent Ids. Limit of 1,000 per non-batch request / 2,000 per batch request (GET) or 30,000 per batch request (POST)." }, { "name": "metrics", "value": "", "type": "query", "description": "Requested list of Financial Statement Items or Ratios. Use the `/metrics` endpoint for a complete list of available FF_* metric items. When requesting multiple metrics, you cannot mix metric data types (e.g. strings and floats). Limit of 1,600 per request." }, { "name": "periodicity", "value": "", "type": "query", "description": "Periodicity or frequency of the fiscal periods. ANN = Annual Original, ANN_R = Annual Latest (includes restatements), QTR = Quarterly Original, QTR_R = Quarterly Latest, SEMI = Semi-Annual, SEMI_R = Semi-Annual Latest, LTM = Last Twelve Months, LTM_R = Last Twelve Months Latest, LTMSG = Last Twelve Months Global, LTM_SEMI = Last Twelve Months Semi-Annual, YTD = Year-to-date." }, { "name": "fiscalPeriodStart", "value": "", "type": "query", "description": "The fiscal period start expressed as YYYY-MM-DD. Calendar date that will fall back to the most recent completed period during resolution." }, { "name": "fiscalPeriodEnd", "value": "", "type": "query", "description": "The fiscal period end expressed as YYYY-MM-DD. Calendar date that will fall back to the most recently completed period during resolution." }, { "name": "currency", "value": "", "type": "query", "description": "Currency code for currency values. For a list of currency ISO codes, visit Online Assistant Page 1470. Use \"DOC\" for reporting currency. Defaults to LOCAL." }, { "name": "updateType", "value": "", "type": "query", "description": "Update status flag. RP = Include preliminary data, RF = Only final data." }, { "name": "batch", "value": "", "type": "query", "description": "Enables asynchronous batch processing, supporting long-running requests up to 20 minutes. Upon requesting batch=Y, the service will respond with HTTP 202. Use batch-status to check completion and batch-result to retrieve results." } ] }, "docs": "Retrieves FactSet Fundamental standardized data for specified securities. Use the `/metrics` endpoint to retrieve a full list of valid metrics or data items.\n\nThe `/fundamentals` endpoint currently supports Long Running asynchronous requests up to **20 minutes** via batch parameter. Id limits are increased to 2000 ids per request when using batch capability. This 2000 id limit has been derived based on single metric for one day." }, { "info": { "name": "Factset Returns Company Fundamental Data for a List of Identifiers.", "type": "http" }, "http": { "method": "POST", "url": "https://api.factset.com/fundamentals", "body": { "type": "json", "data": "{}" } }, "docs": "Retrieves FactSet Fundamental standardized data for specified securities using a POST request body. Use the `/metrics` endpoint to retrieve a full list of valid metrics or data items.\n\nThe `/fundamentals` endpoint currently supports Long Running asynchronous requests up to **20 minutes** via batch parameter. Id limits are increased to 30,000 ids per request when using batch capability. This 30,000 id limit has been derived based on single metric for one day." }, { "info": { "name": "Factset Returns Financial Statement Line Items.", "type": "http" }, "http": { "method": "GET", "url": "https://api.factset.com/financial-statements", "params": [ { "name": "ids", "value": "", "type": "query", "description": "The requested list of security identifiers. Accepted ID types include Market Tickers, SEDOL, ISINs, CUSIPs, or FactSet Permanent Ids. Limit of 1,000 per non-batch request / 2,000 per batch request (GET) or 30,000 per batch request (POST)." }, { "name": "metrics", "value": "", "type": "query", "description": "Requested list of Financial Statement Items or Ratios. Use the `/metrics` endpoint for a complete list of available FF_* metric items. When requesting multiple metrics, you cannot mix metric data types (e.g. strings and floats). Limit of 1,600 per request." }, { "name": "category", "value": "", "type": "query", "description": "Filter financial statements by type. INCOME_STATEMENT for revenue and earnings data, BALANCE_SHEET for assets and liabilities, CASH_FLOW for cash flow activities, FINANCIAL_SERVICES for financial institution specific items." }, { "name": "periodicity", "value": "", "type": "query", "description": "Periodicity or frequency of the fiscal periods. ANN = Annual Original, ANN_R = Annual Latest (includes restatements), QTR = Quarterly Original, QTR_R = Quarterly Latest, SEMI = Semi-Annual, SEMI_R = Semi-Annual Latest, LTM = Last Twelve Months, LTM_R = Last Twelve Months Latest, LTMSG = Last Twelve Months Global, LTM_SEMI = Last Twelve Months Semi-Annual, YTD = Year-to-date." }, { "name": "fiscalPeriodStart", "value": "", "type": "query", "description": "The fiscal period start expressed as YYYY-MM-DD. Calendar date that will fall back to the most recent completed period during resolution." }, { "name": "fiscalPeriodEnd", "value": "", "type": "query", "description": "The fiscal period end expressed as YYYY-MM-DD. Calendar date that will fall back to the most recently completed period during resolution." }, { "name": "currency", "value": "", "type": "query", "description": "Currency code for currency values. For a list of currency ISO codes, visit Online Assistant Page 1470. Use \"DOC\" for reporting currency. Defaults to LOCAL." }, { "name": "updateType", "value": "", "type": "query", "description": "Update status flag. RP = Include preliminary data, RF = Only final data." } ] }, "docs": "Retrieves detailed financial statement data organized by statement type (income statement, balance sheet, cash flow). Use the `category` parameter to filter by statement type, and the `metrics` parameter to request specific line items.\n\nAvailable statement categories include INCOME_STATEMENT, BALANCE_SHEET, CASH_FLOW, and FINANCIAL_SERVICES for financial institutions." }, { "info": { "name": "Factset Returns Financial Statement Line Items for a List of Identifiers.", "type": "http" }, "http": { "method": "POST", "url": "https://api.factset.com/financial-statements", "body": { "type": "json", "data": "{}" } }, "docs": "Retrieves detailed financial statement data via POST for large identifier sets. Supports up to 30,000 ids per batch request." } ] } ], "bundled": true }