FactSet ESG API

openapi: 3.0.0
info:
  version: 1.6.0
  title: FactSet ESG API
  contact:
    name: FactSet Research Systems
    email: [email protected]
    url: https://developer.factset.com/contact
  description: >
    FactSet ESG (powered by FactSet Truvalue Labs) applies machine learning to
    uncover risks and opportunities from companies' Environmental, Social and
    Governance (ESG) behavior, which are aggregated and categorized into
    continuously updated, material ESG scores. The service focuses on company
    ESG behavior from external sources and includes both positive and negative
    events that go beyond traditional sources of ESG risk data.<p> FactSet ESG
    extracts, analyzes, and generates scores from millions of documents each
    month collected from more than 100,000 data sources in over 30 languages.
    Sources include news, trade journals, NGOs, watchdog groups, trade blogs,
    industry reports and social media. Products deliver investable insights by
    revealing value and risk factors from unstructured data at the speed of
    current events.</p>
  license:
    name: Apache License, Version 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
externalDocs:
  description: API Documentation
  url: https://developer.factset.com/api-catalog/factset-esg-api
servers:
  - url: https://api.factset.com/content
    description: Production
security:
  - FactSetApiKey: []
  - FactSetOAuth2: []
tags:
  - name: Factset Esg
paths:
  /factset-esg/v1/sasb-scores:
    get:
      tags:
        - Factset Esg
      summary: >-
        Factset Gets short-term, long-term, and momentum scores based on the 26 ESG categories defined by the Sustainability Accounting Standards Board (SASB).
      operationId: getSasbScores
      description: >
        FactSet Truvalue Labs SASB Scores provides short-term, long-term, and
        momentum scores that are generated for 26 ESG categories defined by the
        Sustainability Accounting Standards Board. FactSet Truvalue also
        calculates a custom overall score called ALLCATEGORIES, can indicate
        data volume flow, and the Dynamic Materiality of that data flow.
      parameters:
        - $ref: '#/components/parameters/ids'
        - $ref: '#/components/parameters/sasbScoreTypes'
        - $ref: '#/components/parameters/categories'
        - $ref: '#/components/parameters/startDate'
        - $ref: '#/components/parameters/endDate'
        - $ref: '#/components/parameters/frequency'
        - $ref: '#/components/parameters/calendar'
      responses:
        '200':
          description: >-
            The SASB Scores response object, including the Pulse Score, Insight
            Score, Momentum Score, Category Volume, Dynamic Materiality Score
            and other meta data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sasbScoresResponse'
              examples:
                Single SASB Score Type for all categories for a single entity (AMZN-US):
                  $ref: '#/components/examples/singleSasbScores'
                Multiple SASB Score Types for multiple categories for multiple entities (AMZN-US, TSLA-US):
                  $ref: '#/components/examples/multipleSasbScores'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
    post:
      tags:
        - Factset Esg
      summary: >-
        Factset For a large list of ids, gets short-term, long-term, and momentum scores based on the 26 ESG categories defined by the Sustainability Accounting Standards Board (SASB).
      description: >
        FactSet Truvalue Labs SASB Scores provides short-term, long-term, and
        momentum scores that are generated for 26 ESG categories defined by the
        Sustainability Accounting Standards Board. FactSet Truvalue also
        calculates a custom overall score called ALLCATEGORIES, can indicate
        data volume flow, and the Dynamic Materiality of that data flow.
      operationId: getSasbScoresPost
      requestBody:
        required: true
        description: >-
          The SASB Scores request body, allowing the user to specify a list of
          ids, SASB Score Items, SASB categories, date range, and frequency.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sasbScoresRequest'
            examples:
              Single SASB Score Type for all categories for a single entity (AMZN-US):
                $ref: '#/components/examples/singleSasbScoresPost'
              Multiple SASB Scores Types for multiple categories for multiple mntities (AMZN-US, TSLA-US):
                $ref: '#/components/examples/multipleSasbScoresPost'
      responses:
        '200':
          description: >-
            The SASB Scores response object, including the Pulse Score, Insight
            Score, Momentum Score, Category Volume, Dynamic Materiality Score
            and other meta data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sasbScoresResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-esg/v1/sasb-ranks:
    get:
      tags:
        - Factset Esg
      summary: Factset Gets ESG Rankings for a requested list of ids and dates.
      operationId: getSasbRanks
      description: >
        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 - 


        |Rank|Industry Percentile Range (%)|

        |||

        |Leader|90 - 100|

        |Above Average|70 - 89.9|

        |Average|30 - 69.9|

        |Below Average|10 - 29.9|

        |Laggard|0 - 9.9|


        Industry classifications follow SICS, SASB's Industry Classification
        System. Using the Adjusted Insight scores, Industry Percentiles are
        generated for all companies. Companies with five or more articles in a
        year get ranked in a first pass, then companies with filled-in values
        are interpolated without forcing the ranking of higher-volume companies
        up or down.  In the case where a company falls into an industry with
        fewer than 7 high or medium volume companies the Sector Percentile is
        inserted in the place of the Industry Percentile score.

        <p>Only Vaild for ALLCATEGORIES and MATERIALITY categories.</p>
      parameters:
        - $ref: '#/components/parameters/ids'
        - $ref: '#/components/parameters/rankCategories'
        - $ref: '#/components/parameters/startDate'
        - $ref: '#/components/parameters/endDate'
        - $ref: '#/components/parameters/frequency'
        - $ref: '#/components/parameters/calendar'
      responses:
        '200':
          description: The SASB Ranks response object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sasbRanksResponse'
              examples:
                ESG Ranks for multiple entities:
                  $ref: '#/components/examples/multipleSasbRanks'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
    post:
      tags:
        - Factset Esg
      summary: Factset Get ESG Ranks for a large list of ids and specified date range.
      description: >
        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 - 


        |Rank|Industry Percentile Range (%)|

        |||

        |Leader|90 - 100|

        |Above Average|70 - 89.9|

        |Average|30 - 69.9|

        |Below Average|10 - 29.9|

        |Laggard|0 - 9.9|


        Industry classifications follow SICS, SASB's Industry Classification
        System. Using the Adjusted Insight scores, Industry Percentiles are
        generated for all companies. Companies with five or more articles in a
        year get ranked in a first pass, then companies with filled-in values
        are interpolated without forcing the ranking of higher-volume companies
        up or down.  In the case where a company falls into an industry with
        fewer than 7 high or medium volume companies the Sector Percentile is
        inserted in the place of the Industry Percentile score.

        <p>Only Vaild for ALLCATEGORIES and MATERIALITY categories.</p>
      operationId: getSasbRanksPost
      requestBody:
        required: true
        description: The SASB Ranks Request Object
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sasbRanksRequest'
      responses:
        '200':
          description: The SASB Ranks response object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sasbRanksResponse'
              examples:
                ESG Ranks for multiple entities:
                  $ref: '#/components/examples/multipleSasbRanks'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-esg/v1/sasb-scores-all:
    get:
      tags:
        - Factset Esg
      summary: >-
        Factset Gets a flat key value array of scores for named categories of the input scoreType(s).
      operationId: getSasbScoresAll
      description: >
        **Retrieves a flat array of all categories for the requested scoreType
        and ids. Unlike the /sasb-scores endpoint the format of the response
        returns category names as part of the key value.**<p> Gets values for
        all categories for the selected score type(s) for the requested
        identifier(s). FactSet Truvalue Labs SASB Scores provides short-term,
        long-term, and momentum scores that are generated for 26 ESG categories
        defined by the Sustainability Accounting Standards Board. ESG Ranks are
        not supported in this Endpoint.
      parameters:
        - $ref: '#/components/parameters/ids'
        - $ref: '#/components/parameters/sasbScoreTypes'
        - $ref: '#/components/parameters/startDate'
        - $ref: '#/components/parameters/endDate'
        - $ref: '#/components/parameters/frequency'
        - $ref: '#/components/parameters/calendar'
      responses:
        '200':
          description: >-
            The SASB Scores All Response Object, including the Pulse, Insight,
            Momentum, Article Volume, Category Volume, Dynamic Materiality,
            Adjusted Insight, and Industry Percentile scores for all categories.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sasbScoresAllResponse'
              examples:
                All SASB Score Types for a Single Entity (AMZN-US):
                  $ref: '#/components/examples/singleSasbScoresAll'
                Multiple SASB Scores Types for Multiple Entities (AMZN-US, TSLA-US):
                  $ref: '#/components/examples/multipleSasbScoresAll'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
    post:
      tags:
        - Factset Esg
      summary: >-
        Factset Gets a flat key value array of scores for named categories of the input score type(s).
      description: >
        **Retrieves a flat array of all categories for the requested scoreType
        and ids. Unlike the /sasb-scores endpoint the format of the response
        returns category names as part of the key value.**<p> Gets values for
        all categories for the selected score type(s) for the requested
        identifier(s). FactSet Truvalue Labs SASB Scores provides short-term,
        long-term, and momentum scores that are generated for 26 ESG categories
        defined by the Sustainability Accounting Standards Board. ESG Ranks are
        not supported in this Endpoint.
      operationId: getSasbScoresAllPost
      requestBody:
        required: true
        description: >-
          The SASB Scores request body, allowing the user to specify a list of
          ids, SASB Score Items, SASB categories, date range, and frequency.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sasbScoresAllRequest'
            examples:
              All SASB Score Types for a Single Entity (AMZN-US):
                $ref: '#/components/examples/singleSasbScoresAllPost'
              Multiple SASB Score Types for Multiple Entities (AMZN-US, TSLA-US):
                $ref: '#/components/examples/multipleSasbScoresAllPost'
      responses:
        '200':
          description: >-
            The SASB Scores All Response Object, including the Pulse, Insight,
            Momentum, Article Volume, Category Volume, Dynamic Materiality,
            Adjusted Insight, and Industry Percentile scores for all categories.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sasbScoresAllResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-esg/v1/sdg-scores:
    get:
      tags:
        - Factset Esg
      summary: >-
        Factset Gets short-term, long-term, and momentum scores based on the 16 Sustainable Development Goals categories defined by the United Nations.
      operationId: getSdgScores
      description: >
        Truvalue Labs SDG Scores provides short-term, long-term, and momentum
        scores that are generated for 16 Sustainable Development Goals
        categories defined by the United Nations.
      parameters:
        - $ref: '#/components/parameters/tvlIds'
        - $ref: '#/components/parameters/sdgScoreTypes'
        - $ref: '#/components/parameters/sdgCategories'
        - $ref: '#/components/parameters/sdgStartDate'
        - $ref: '#/components/parameters/sdgEndDate'
        - $ref: '#/components/parameters/sdgFrequency'
      responses:
        '200':
          description: >-
            The SDG Scores response object, including the Pulse Score, Insight
            Score, Momentum Score, Category Volume, Impact Percentage and other
            meta data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sdgScoresResponse'
              examples:
                Single Score Type for all SDG categories for a single entity (AMZN-US).:
                  $ref: '#/components/examples/singleSdgScores'
                Multiple Score Types for 4 SDG categories for multiple entities (AMZN-US, TSLA-US):
                  $ref: '#/components/examples/multipleSdgScores'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
    post:
      tags:
        - Factset Esg
      summary: >-
        Factset Gets short-term, long-term, and momentum scores based on the 16 Sustainable Development Goals categories defined by United Nations.
      description: >
        Truvalue Labs SDG Scores provides short-term, long-term, and momentum
        scores that are generated for 16 Sustainable Development Goals
        categories defined by the United Nations.*
      operationId: getSdgScoresPost
      requestBody:
        required: true
        description: >-
          The SDG Scores request body, allowing the user to specify a list of
          ids, Score types, SDG categories, date range, and frequency.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sdgScoresRequest'
      responses:
        '200':
          description: >-
            The SDG Scores response object, including the Pulse Score, Insight
            Score, Momentum Score, Category Volume, Impact Percentage and other
            meta data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sdgScoresResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-esg/v1/sfdr-pai:
    get:
      tags:
        - Factset Esg
      summary: >-
        Factset Gets Principle Adverse Impact (PAI) data to support compliant SFDR Sustainable Finance Disclosure Regulation (SFDR) reporting
      operationId: getSfdrPai
      description: >
        SFDR Principle Adverse Impact (PAI) data is built specifically to
        support compliant Sustainable Finance Disclosure Regulation (SFDR)
        reporting. FactSet collects PAI data items from publicly available
        company-reported information and FactSet databases, such as FactSet
        Fundamentals, FactSet RBICS with Revenue and FactSet People, which are
        also based on company-disclosures. FactSet uses Truvalue Labs SASB
        Spotlights for supplemental OECD & UNGC violation checks where company
        reporting is sparse. 
      parameters:
        - $ref: '#/components/parameters/paiIds'
        - $ref: '#/components/parameters/feelback'
        - $ref: '#/components/parameters/fiscalPeriodStart'
        - $ref: '#/components/parameters/fiscalPeriodEnd'
        - $ref: '#/components/parameters/indicators'
        - $ref: '#/components/parameters/calculation'
      responses:
        '200':
          description: >-
            The SFDR PAI response object, including the Calculation, Sub Topic
            Codes, Sub Topic Names, Report End Date,Reporting Period,
            Standardized Units and Standardized Values
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sfdrPaiResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '408':
          $ref: '#/components/responses/408'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
    post:
      tags:
        - Factset Esg
      summary: >-
        Factset Gets Principle Adverse Impact (PAI) data to support compliant SFDR Sustainable Finance Disclosure Regulation (SFDR) reporting
      description: >
        SFDR Principle Adverse Impact (PAI) data is built specifically to
        support compliant Sustainable Finance Disclosure Regulation (SFDR)
        reporting. FactSet collects PAI data items from publicly available
        company-reported information and FactSet databases, such as FactSet
        Fundamentals, FactSet RBICS with Revenue and FactSet People, which are
        also based on company-disclosures. FactSet uses Truvalue Labs SASB
        Spotlights for supplemental OECD & UNGC violation checks where company
        reporting is sparse.
      operationId: getSfdrPaiForList
      requestBody:
        required: true
        description: >-
          The request body, allows the user to specify a list of ids, date
          range(Annual), and PAI Indicators
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sfdrPaiRequest'
      responses:
        '200':
          description: >-
            The SFDR PAI response object, including the Calculation, SubTopic
            Codes, SubTopic Names, Report End Date,Reporting Period,
            Standardized Units and Standardized Values
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sfdrPaiResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '408':
          $ref: '#/components/responses/408'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-esg/v1/sasb-spotlights:
    get:
      tags:
        - Factset Esg
      summary: >-
        Factset Gets Spotlight data for the most important positive and negative ESG events to enable timely and systematic trading strategies and portfolio management
      operationId: getSasbSpotlights
      description: >
        FactSet ESG by Truvalue Labs’ Spotlight Data solutions are a daily
        collection of the most important positive and negative ESG events
        detected by our algorithms, with a variety of quantitative metadata to
        enable timely and systematic trading strategies and portfolio
        management. Qualitive informational data points such as the headline and
        key bullet points for articles is also included. 
      parameters:
        - $ref: '#/components/parameters/paiIds'
        - $ref: '#/components/parameters/sdgStartDate'
        - $ref: '#/components/parameters/sdgEndDate'
        - $ref: '#/components/parameters/fieldsSasbSpotlights'
        - $ref: '#/components/parameters/sasbSpotlightsCategories'
        - $ref: '#/components/parameters/primaryOnly'
        - $ref: '#/components/parameters/isRemoved'
      responses:
        '200':
          description: The SASB Article metadata like Dates, Headlines, Articles, Volume
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/spotlightsResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '408':
          $ref: '#/components/responses/408'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
    post:
      tags:
        - Factset Esg
      summary: >-
        Factset Gets Spotlight data for the most important positive and negative ESG events to enable timely and systematic trading strategies and portfolio management
      description: >
        FactSet ESG by Truvalue Labs’ Spotlight Data solutions are a daily
        collection of the most important positive and negative ESG events
        detected by our algorithms, with a variety of quantitative metadata to
        enable timely and systematic trading strategies and portfolio
        management. Qualitive informational data points such as the headline and
        key bullet points for articles is also included. reporting is sparse.
      operationId: getSasbSpotlightsForList
      requestBody:
        required: true
        description: The SASB Article metadata like Dates, Headlines, Articles, Volume
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sasbSpotlightsRequest'
      responses:
        '200':
          description: The SASB Article metadata like Dates, Headlines, Articles, Volume
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/spotlightsResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '408':
          $ref: '#/components/responses/408'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-esg/v1/sdg-spotlights:
    get:
      tags:
        - Factset Esg
      summary: >-
        Factset Gets Spotlight data for the most important positive and negative ESG events to enable timely and systematic trading strategies and portfolio management
      operationId: getSdgSpotlights
      description: >
        FactSet ESG by Truvalue Labs’ Spotlight Data solutions are a daily
        collection of the most important positive and negative ESG events
        detected by our algorithms, with a variety of quantitative metadata to
        enable timely and systematic trading strategies and portfolio
        management. Qualitive informational data points such as the headline and
        key bullet points for articles is also included. 
      parameters:
        - $ref: '#/components/parameters/paiIds'
        - $ref: '#/components/parameters/sdgStartDate'
        - $ref: '#/components/parameters/sdgEndDate'
        - $ref: '#/components/parameters/sdgSpotlightCategories'
        - $ref: '#/components/parameters/fieldsSdgSpotlights'
        - $ref: '#/components/parameters/primaryOnly'
        - $ref: '#/components/parameters/isRemoved'
      responses:
        '200':
          description: The SDG Article metadata like Dates, Headlines, Articles, Volume
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/spotlightsResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '408':
          $ref: '#/components/responses/408'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
    post:
      tags:
        - Factset Esg
      summary: >-
        Factset Gets Spotlight data for the most important positive and negative ESG events to enable timely and systematic trading strategies and portfolio management
      description: >
        FactSet ESG by Truvalue Labs’ Spotlight Data solutions are a daily
        collection of the most important positive and negative ESG events
        detected by our algorithms, with a variety of quantitative metadata to
        enable timely and systematic trading strategies and portfolio
        management. Qualitive informational data points such as the headline and
        key bullet points for articles is also included. reporting is sparse.
      operationId: getSdgSpotlightsForList
      requestBody:
        required: true
        description: The SDG Article metadata like Dates, Headlines, Articles, Volume
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sdgSpotlightsRequest'
      responses:
        '200':
          description: The SDG Article metadata like Dates, Headlines, Articles, Volume
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/spotlightsResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '408':
          $ref: '#/components/responses/408'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-esg/v1/sasb-articles:
    get:
      tags:
        - Factset Esg
      summary: >-
        Factset Request articles tagged with SASB lens categories from 2016-01-01 to previous day.
      operationId: getSasbArticles
      description: >
        Articles endpoint allows to retrieve underlying news articles used by
        the AI engine to calculate the ESG Scores of companies and therefore
        provides ESG relevant news and also transparency into the ESG Scores.
      parameters:
        - $ref: '#/components/parameters/paiIds'
        - $ref: '#/components/parameters/sdgStartDate'
        - $ref: '#/components/parameters/sdgEndDate'
        - $ref: '#/components/parameters/dateOf'
        - $ref: '#/components/parameters/articlesFields'
        - $ref: '#/components/parameters/sasbArticlesCategories'
      responses:
        '200':
          description: The SASB Article metadata like Dates, Headlines, Articles, Volume
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sasbArticlesResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '408':
          $ref: '#/components/responses/408'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
    post:
      tags:
        - Factset Esg
      summary: >-
        Factset Request articles tagged with SASB lens categories from 2016-01-01 to previous day
      description: >
        Articles endpoint allows to retrieve underlying news articles used by
        the AI engine to calculate the ESG Scores of companies and therefore
        provides ESG relevant news and also transparency into the ESG Scores.
      operationId: getSasbArticlesForList
      requestBody:
        required: true
        description: The SASB Article metadata like Dates, Headlines, Articles, Volume
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sasbArticlesRequest'
      responses:
        '200':
          description: The SASB Article metadata like Dates, Headlines, Articles, Volume
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sasbArticlesResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '408':
          $ref: '#/components/responses/408'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-esg/v1/sdg-articles:
    get:
      tags:
        - Factset Esg
      summary: >-
        Factset Request articles tagged with SDG lens categories from 2016-01-01 to previous day.
      operationId: getSdgArticles
      description: >
        Articles endpoint allows to retrieve underlying news articles used by
        the AI engine to calculate the ESG Scores of companies and therefore
        provides ESG relevant news and also transparency into the ESG Scores.
      parameters:
        - $ref: '#/components/parameters/paiIds'
        - $ref: '#/components/parameters/sdgStartDate'
        - $ref: '#/components/parameters/sdgEndDate'
        - $ref: '#/components/parameters/dateOf'
        - $ref: '#/components/parameters/articlesFields'
        - $ref: '#/components/parameters/sdgArticlesCategories'
      responses:
        '200':
          description: The SDG Article metadata like Dates, Headlines, Articles, Volume
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sdgArticlesResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '408':
          $ref: '#/components/responses/408'
        '415':
          $ref: '#/com

# --- truncated at 32 KB (357 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/factset/refs/heads/main/openapi/esg-openapi-original.yml