{
  "opencollection": "1.0.0",
  "info": {
    "name": "Factset Analytics Datastore About Ratios API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "basic",
      "username": "{{username}}",
      "password": "{{password}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Ratios",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Factset Returns Pre-calculated Financial Ratios.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.factset.com/ratios",
            "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 ratio metrics. Common ratios include FF_PE (price-to-earnings), FF_PBK (price-to-book), FF_ROE (return on equity), FF_DEBT_EQUITY, FF_CURR_RATIO, and others. Use the `/metrics` endpoint with category=RATIOS for a complete list."
              },
              {
                "name": "subcategory",
                "value": "",
                "type": "query",
                "description": "Filter ratios by subcategory. FINANCIAL for leverage and coverage ratios, GROWTH_RATE for revenue and earnings growth, LIQUIDITY for current and quick ratios, PROFITABILITY for margin and return metrics, SIZE for market cap and enterprise value, VALUATION for PE, PB, and dividend yield."
              },
              {
                "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."
              }
            ]
          },
          "docs": "Retrieves pre-calculated financial ratios for specified securities. Available ratio subcategories include FINANCIAL, GROWTH_RATE, LIQUIDITY, PROFITABILITY, SIZE, and VALUATION.\n\nCommon ratios include price-to-earnings (FF_PE), return on equity (FF_ROE), debt-to-equity (FF_DEBT_EQUITY), current ratio (FF_CURR_RATIO), and many others."
        },
        {
          "info": {
            "name": "Factset Returns Pre-calculated Financial Ratios for a List of Identifiers.",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.factset.com/ratios",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Retrieves pre-calculated financial ratios via POST for large identifier sets."
        }
      ]
    }
  ],
  "bundled": true
}