Factset Factset Esg API

openapi: 3.0.3
info:
  title: Factset Analytics Datastore About Factset Esg API
  description: Allow clients to fetch precalculated Analytics through predeterministic URLs.
  contact:
    name: FactSet Research Systems
    url: https://developer.factset.com/contact
    email: api@factset.com
  license:
    name: Apache License, Version 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  version: 1.0.0
servers:
- url: https://api.factset.com
  description: Production
- url: https://api-sandbox.factset.com
  description: Sandbox
security:
- basicAuth: []
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 - \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 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.\n<p>Only Vaild for ALLCATEGORIES and MATERIALITY categories.</p>\n"
      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 - \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 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.\n<p>Only Vaild for ALLCATEGORIES and MATERIALITY categories.</p>\n"
      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. \n"
      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. \n"
      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. \n"
      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: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
    post:
      tags:
      - Factset Esg
      summary: Factset Request articles tagged with SDG 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: getSdgArticlesForList
      requestBody:
        required: true
        description: The SDG Article metadata like Dates, Headlines, Articles, Volume
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sdgArticlesRequest'
      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: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
components:
  schemas:
    articlesFields:
      title: fields
      type: array
      items:
        type: string
      description: "Request available Articles data fields to be included in the response.\n Default is all fields. _fsymId_ and _articleId_ are always included.\n \n <h3>Common Fields</h3> \n  |field|description|\n  |||\n  |fsymId|Factset Regional Security Identifier|\n  |articleId|Unique ID of the article assigned by Truvalue|          \n  \n <h3> Articles Fields</h3>\n \n  |field|description|\n  |||\n  |datePub|Publication date of the article expressed in YYYY-MM-DD format|\n  |title|Title of the article|\n  |source|Source of the article|\n  |categories|categories assigned by Truvalue|\n  |bullets|AI-generated bullet point summary for each article. Note, including bullets increases response size drastically|\n  |author|Author of the article|\n  |url|URL of the article|\n  |language|Language code of the article|\n  |orgName| Organization name assigned by Truvalue|\n  |orgId| Unique identifier assigne

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