{
  "opencollection": "1.0.0",
  "info": {
    "name": "Factset Analytics Datastore About Ranks API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "basic",
      "username": "{{username}}",
      "password": "{{password}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Ranks",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Factset Gets Esg Rankings for a Requested List of Ids and Dates.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.factset.com/factset-esg/v1/sasb-ranks",
            "params": [
              {
                "name": "ids",
                "value": "",
                "type": "query",
                "description": "Security or Entity identifiers. FactSet Identifiers, tickers, CUSIP, SEDOL, and ISIN are accepted inputs. <p>***ids limit** =  1000 per request*</p> *<p>Make note, GET Method URL request lines are also limited to a total length of 8192 bytes (8KB). In cases where the service allows for thousands of ids, which may exceed this request line limit of 8KB, its advised for any requests with large request lines to be requested through the respective \"POST\" method.</p>*\n"
              },
              {
                "name": "categories",
                "value": "ALLCATEGORIES,MATERIALITY",
                "type": "query",
                "description": "The Categories representing overall or composite rankings from all underlying 26 SASB Categories.\n\n### SASB Categories\n|**SASB Category Inputs**|**Description**|\n|||\n|**ALLCATEGORIES**|**All Categories** - The company's overall SASB Rank. This value is equal to the cumulative average of all 26 SASB categories.\n|**MATERIALITY**|**Materiality** - The composite rank of all 'material' SASB categories for the given entity. For more information on SASB's Materiality Map, visit [materiality.sasb.org](https://materiality.sasb.org/)|\n\n### Helper Input\n**ALL** = Simply gives the ability to request all categories in a single request without having to explicitly list each available category. \n"
              },
              {
                "name": "startDate",
                "value": "2018-12-31",
                "type": "query",
                "description": "The start date requested for a given date range in **YYYY-MM-DD** format. If left blank, the API will default to latest available completed period.\n"
              },
              {
                "name": "endDate",
                "value": "2019-12-31",
                "type": "query",
                "description": "The end date requested for a given date range in **YYYY-MM-DD** format. If left blank, the API will default to latest available completed period.\n"
              },
              {
                "name": "frequency",
                "value": "",
                "type": "query",
                "description": "Controls the display frequency of the data returned.\n  * **D** = Daily\n  * **W** = Weekly, based on the last day of the week of the start date.\n  * **M** = Monthly, based on the last trading day of the month.\n  * **CY** = Calendar Annual, based on the last trading day of the calendar year.\n  \n"
              },
              {
                "name": "calendar",
                "value": "FIVEDAY",
                "type": "query",
                "description": "Calendar of data returned. SEVENDAY includes weekends. LOCAL calendar will default to the securities' trading calendar which excludes date records for respective holiday periods."
              }
            ]
          },
          "docs": "Indicates if a company is a Leader, Above Average, Average, Below Average, or a Laggard; directly mapping from Industry Percentiles (*request IND_PCTL in scores endpoints*). Mapping of ESG Ranks to Industry Percentile Ranges is as follows - \n\n|Rank|Industry Percentile Range (%)|\n|||\n|Leader|90 - 100|\n|Above Average|70 - 89.9|\n|Average|30 - 69.9|\n|Below Average|10 - 29.9|\n|Laggard|0 - 9.9|\n\nIndustry classifications follow SICS, SASB's Industry Classification System. Using the Adjusted Insight sco"
        },
        {
          "info": {
            "name": "Factset Get Esg Ranks for a Large List of Ids and Specified Date Range.",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.factset.com/factset-esg/v1/sasb-ranks",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Indicates if a company is a Leader, Above Average, Average, Below Average, or a Laggard; directly mapping from Industry Percentiles (*request IND_PCTL in scores endpoints*). Mapping of ESG Ranks to Industry Percentile Ranges is as follows - \n\n|Rank|Industry Percentile Range (%)|\n|||\n|Leader|90 - 100|\n|Above Average|70 - 89.9|\n|Average|30 - 69.9|\n|Below Average|10 - 29.9|\n|Laggard|0 - 9.9|\n\nIndustry classifications follow SICS, SASB's Industry Classification System. Using the Adjusted Insight sco"
        }
      ]
    }
  ],
  "bundled": true
}