openapi: 3.0.0
info:
  version: 1.6.0
  title: FactSet ESG API
  contact:
    name: FactSet Research Systems
    email: api@factset.com
    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: '#/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:
  securitySchemes:
    FactSetApiKey:
      type: http
      scheme: basic
    FactSetOAuth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://auth.factset.com/as/token.oauth2
          scopes: {}
  parameters:
    ids:
      name: ids
      in: query
      schema:
        type: array
        items:
          type: string
        minItems: 1
        maxItems: 1000
      required: true
      explode: false
      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>*
      examples:
        oneId:
          summary: One Market Identifier
          value:
            - AAPL-USA
        multipleIds:
          summary: Multiple Market Identifiers
          value:
            - GOOGL-US
            - AAPL-US
            - MSFT-US
    startDate:
      name: startDate
      in: query
      required: false
      schema:
        type: string
      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.
      example: '2018-12-31'
    endDate:
      name: endDate
      in: query
      required: false
      schema:
        type: string
      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.
      example: '2019-12-31'
    sdgStartDate:
      name: startDate
      in: query
      required: true
      schema:
        type: string
      description: >
        The start date requested for a given date range in YYYY-MM-DD format.
        The input start date must be before the input end date. Future dates
        (T+1) are not accepted in this endpoint.
      example: '2021-01-01'
    sdgEndDate:
      name: endDate
      in: query
      required: true
      schema:
        type: string
      description: >
        The end date requested for a given date range in YYYY-MM-DD format. The
        input end date must be after the input start date. Future dates (T+1)
        are not accepted in this endpoint.
      example: '2021-10-30'
    dateOf:
      name: dateOf
      in: query
      required: false
      schema:
        type: string
        enum:
          - PUBLICATION
          - INGESTION
        default: PUBLICATION
      description: |
        Date of Publication or Ingestion 
         * **Publication:**  use for startDate and endDate the articles publication date 
         * **Ingestion:**  use for startDate and endDate the articles TVL first processing date 
         
      example: PUBLICATION
    frequency:
      name: frequency
      in: query
      schema:
        type: string
        enum:
          - D
          - W
          - M
          - CY
          - ''
        default: D
      description: |
        Controls the display frequency of the data returned.
          * **D** = Daily
          * **W** = Weekly, based on the last day of the week of the start date.
          * **M** = Monthly, based on the last trading day of the month.
          * **CY** = Calendar Annual, based on the last trading day of the calendar year.
          
    calendar:
      name: calendar
      in: query
      schema:
        type: string
        enum:
          - FIVEDAY
          - SEVENDAY
          - LOCAL
        default: SEVENDAY
      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.
      example: FIVEDAY
    sdgScoreTypes:
      name: scoreTypes
      in: query
      schema:
        type: array
        default:
          - ALL
        items:
          type: string
        minItems: 1
        maxItems: 8
      required: false
      explode: false
      description: >
        The FactSet Truvalue Score types being requested. Score Types include
        the Pulse, Insight, Momentum, Article Volume, Category Volume, Dynamic
        Materiality Score, Adjusted Insight, and Industry Percentile. When left
        blank all score types will be returned for the requested Id. To specify
        select scores returned in the response, provide a comma-separated list
        of the scores using the description below.

        <p>These scores use the same underlying data and 100-point scale, except
        for ranks and percentiles. The cognitive computing system behind
        FactSet's Truvalue Platform uses natural language processing to
        interpret semantic content and generate analytics. It does so by
        applying criteria that are consistent with established sustainability
        and ESG frameworks, scoring data points on performance using a 0 to 100
        scale. A score of 50 represents a neutral impact. Scores above 50
        indicate positive performance, and scores below reflect negative
        performance.</p>


        ### SDG Score Types


        |**SDG Category Input**|**Description**|

        |||

        |**PULSE**|*Pulse Score*, is a measure of near-term performance changes
        that highlights opportunities and controversies, enabling real-time
        monitoring of companies. It focuses on events of the day and provides a
        responsive signal to alert investors to dynamic moves.|

        |**INSIGHT**|*Insight Score*, a measure of a company's longer-term SDG
        track record, similar to a ratings system. Scores are less sensitive to
        daily events and reflect the enduring performance record of a company
        over time. Scores are derived using an exponentially-weighted moving
        average of the Pulse, defined below, and the half-life of an event's
        influence on the overall score is 6 months.|

        |**MOMENTUM**|*Momentum Score*, measures the trend of a company's
        Insight score. It is a unique ESG metric in the industry that gives
        investors a high-precision view of the trajectory of a company's SDG
        performance, relative to peers. It does so by precisely articulating
        upward or downward movement, relative to that of all others in the
        universe, making it a measure that enhances quantitative workflows.|

        |**DYNAMIC_MAT**|*Dynamic Materiality Score*, shows the percentage value
        of data flow by category compared with the total data flow for the
        organization |

        |**ADJ_INSIGHT**|*Adjusted Insight*, Measures company SDG performance,
        generating scores for lower-volume and zero-volume firms by blending
        company scores with industry medians. **(ONLY Vaild for `IMPACT`
        category)**. <p>**Adjusted Insight Score = (# of articles / 5) x Company
        Insight Score + ((5 - # of articles) / 5) x Industry (or Sector) Median
        Insight Score.</p>|

        |**IND_PCTL**|*Industry Percentile*, offers context on company Adjusted
        Insight scores relative to peers in the same SICS Industry. This value
        is used to establish the textual ESG Rank. **(ONLY Vaild for `IMPACT`
        category).**|

        |**TTM_VOLUME**|*TTM Volume*, measures the data flow over a trailing
        twelve month period.|

        |**SDG_RANK**|*SDG Rank*, offers rank leveraging the 16 ESG categories
        defined by Sustainable Development Goals (SDG).The datatype for the data
        returned when this score types is requested is String**(ONLY Vaild for
        `IMPACT` category)**.|
      example:
        - PULSE
        - INSIGHT
        - MOMENTUM
    sasbScoreTypes:
      name: scoreTypes
      in: query
      schema:
        type: array
        default:
          - ALL
        items:
          type: string
        minItems: 1
        maxItems: 8
      required: false
      explode: false
      description: >
        The FactSet Truvalue Score types being requested. Score Types include
        the Pulse, Insight, Momentum, Article Volume, Category Volume, Dynamic
        Materiality Score, Adjusted Insight, and Industry Percentile. When left
        blank all score types will be returned for the requested Id. To specify
        select scores returned in the response, provide a comma-separated list
        of the scores using the description below.

        <p>These scores use the same underlying data and 100-point scale, except
        for ranks and percentiles. The cognitive computing system behind
        FactSet's Truvalue Platform uses natural language processing to
        interpret semantic content and generate analytics. It does so by
        applying criteria that are consistent with established sustainability
        and ESG frameworks, scoring data points on performance using a 0 to 100
        scale. A score of 50 represents a neutral impact. Scores above 50
        indicate positive performance, and scores below reflect negative
        performance.</p>


        ### ESG Score Types


        |**SASB Category Input**|**Description**|

        |||

        |**PULSE**|*Pulse Score*, is a measure of near-term performance changes
        that highlights opportunities and controversies, enabling real-time
        monitoring of companies. It focuses on events of the day and provides a
        responsive signal to alert investors to dynamic moves.|

        |**INSIGHT**|*Insight Score*, a measure of a company’s longer-term ESG
        track record, similar to a ratings system. Scores are less sensitive to
        daily events and reflect the enduring performance record of a company
        over time. Scores are derived using an exponentially-weighted moving
        average of the Pulse, defined below, and the half-life of an event’s
        influence on the overall score is 6 months.|

        |**MOMENTUM**|*Momentum Score*, measures the trend of a company's
        Insight score. It is a unique ESG metric in the industry that gives
        investors a high-precision view of the trajectory of a company’s ESG
        performance, relative to peers. It does so by precisely articulating
        upward or downward movement, relative to that of all others in the
        universe, making it a measure that enhances quantitative workflows.|

        |**ART_VOL_TTM**|*Article Volume Score*, measures the information flow
        or number of articles about a company over the past 12 months.|

        |**CAT_VOL_TTM**|*Category Volume Score*, returns the total number of
        times any of the 26 categories received a score over a trailing
        twelve-month (TTM) period of time.|

        |**DYNAMIC_MAT**|*Dynamic Materiality Score*, shows the percentage value
        of data flow by category compared with the total data flow for the
        organization **(NOT VALID for `ALLCATEGORIES` and `MATERIALITY` category
        types).**|

        |**ADJ_INSIGHT**|*Adjusted Insight*, Measures company ESG performance,
        generating scores for lower-volume and zero-volume firms by blending
        company scores with industry medians. **(ONLY Vaild for `ALLCATEGORIES`
        and `MATERIALITY` categories). <p>**Adjusted Insight Score = (# of
        articles / 5) x Company Insight Score + ((5 - # of articles) / 5) x
        Industry (or Sector) Median Insight Score.</p>|

        |**IND_PCTL**|*Industry Percentile*, offers context on company Adjusted
        Insight scores relative to peers in the same SICS Industry. This value
        is used to establish the textual ESG Rank. **(ONLY Vaild for
        `ALLCATEGORIES` and `MATERIALITY` categories).**|


        ### Helper Input

        **ALL**= *Ability to fetch all of the "scoreTypes" listed above in a
        simplified query.* This is used by default and removes the need to
        explitly request each scoreType in the list.
      example:
        - PULSE
        - INSIGHT
        - MOMENTUM
    categories:
      name: categories
      in: query
      schema:
        type: array
        default:
          - ALLCATEGORIES
        items:
          type: string
        minItems: 1
        maxItems: 28
      required: false
      explode: false
      description: >
        The SASB Categories requested for the respective scoreType(s). The
        default value is **ALLCATEGORIES**, which represents all 26 categories
        in a single overall score. To request a specifc category or list of
        categories, simply input the category names below. 


        ### SASB Categories

        |**SASB Category Inputs**|**Description**|

        |||

        |**ALLCATEGORIES**|**All Categories** - this category represents a
        company's overall SASB Score for the specific 'scoreType'. This value is
        equal to the cumulative average of all 26 SASB categories for the
        specific 'scoreType'.*Note that category is not available for the
        Dynamic Materiality 'scoreType'.

        |**ACCESSANDAFFORDABILITY**|**Access and Affordability** - The category
        addresses a company's ability to ensure broad access to its products and
        services, specifically in the context of underserved markets and/or
        population groups. It includes the management of issues related to
        universal needs, such as the accessibility and affordability of health
        care, financial services, utilities , education, and
        telecommunications.|

        |**AIRQUALITY**|**Air Quality** - the category addresses management of
        air quality impacts resulting from stationary (e.g., factories, power
        plants) and mobile sources (e.g., trucks, delivery vehicles, planes) as
        well as industrial emissions. Relevant airborne pollutants include, but
        are not limited to, oxides of nitrogen (NOx), oxides of sulfur (SOx),
        volatile organic compounds (VOCs), heavy metals, particulate matter, and
        chlorofluorocarbons. The category does not include GHG emissions, which
        are addressed in a separate category.|

        |**BUSINESSETHICS**|**Business Ethics** - the category addresses the
        company's approach to managing risks and opportunities surrounding
        ethical conduct of business, including fraud, corruption, bribery and
        facilitation payments, fiduciary responsibilities, and other behavior
        that may have an ethical component. This includes sensitivity to
        business norms and standards as they shift over time, jurisdiction, and
        culture. It addresses the company's ability to provide services that
        satisfy the highest professional and ethical standards of the industry,
        which means to avoid conflicts of interest, misrepresentation, bias, and
        negligence through training employees adequately and implementing
        policies and procedures to ensure employees provide services free from
        bias and error.|

        |**BUSMODELRESILIENCE**|**Business Model Resilience** - the category
        addresses an industry's capacity to manage risks and opportunities
        associated with incorporating social, environmental, and political
        transitions into long-term business model planning. This includes
        responsiveness to the transition to a low-carbon and climate-constrained
        economy, as well as growth and creation of new markets among unserved
        and underserved socioeconomic populations. The category highlights
        industries in which evolving environmental and social realities may
        challenge companies to fundamentally adapt or may put their business
        models at risk.|

        |**COMPETITIVEBEHAVIOR**|**Competitive Behavior** - the category covers
        social issues associated with existence of monopolies, which may
        include, but are not limited to, excessive prices, poor quality of
        service, and inefficiencies. It addresses a company's management of
        legal and social expectation around monopolistic and anti-competitive
        practices, including issues related to bargaining power, collusion,
        price fixing or manipulation, and protection of patents and intellectual
        property (IP).|

        |**CRITINCIDENTRISKMGT**|**Critical Incident Risk Management** - the
        category addresses the company's use of management systems and scenario
        planning to identify, understand, and prevent or minimize the occurrence
        of low-probability, high-impact accidents and emergencies with
        significant potential environmental and social externalities. It relates
        to the culture of safety at a company, its relevant safety management
        systems and technological controls, the potential human, environmental,
        and social implications of such events occurring, and the long-term
        effects to an organization, its workers, and society should these events
        occur.|

        |**CUSTOMERPRIVACY**|**Customer Privacy** - the category addresses
        management of risks related to the use of personally identifiable
        information (PII) and other customer or user data for secondary purposes
        including but not limited to marketing through affiliates and
        non-affiliates. The scope of the category includes social issues that
        may arise from a company's approach to collecting data, obtaining
        consent (e.g., opt-in policies), managing user and customer expectations
        regarding how their data is used, and managing evolving regulation. It
        excludes social issues arising from cybersecurity risks, which are
        covered in a separate category.|

        |**CUSTWELFARE**|**Customer Welfare** - the category addresses customer
        welfare concerns over issues including, but not limited to, health and
        nutrition of foods and beverages, antibiotic use in animal production,
        and management of controlled substances. The category addresses the
        company's ability to provide consumers with manufactured products and
        services that are aligned with societal expectations. It does not
        include issues directly related to quality and safety malfunctions of
        manufactured products and services, but instead addresses qualities
        inherent to the design and delivery of products and services where
        customer welfare may be in question. The scope of the category also
        captures companies' ability to prevent counterfeit products.|

        |**DATASECURITY**|**Data Security** - the category addresses management
        of risks related to collection, retention, and use of sensitive,
        confidential, and/or proprietary customer or user data. It includes
        social issues that may arise from incidents such as data breaches in
        which personally identifiable information (PII) and other user or
        customer data may be exposed. It addresses a company's strategy,
        policies, and practices related to IT infrastructure, staff training,
        record keeping, cooperation with law enforcement, and other mechanisms
        used to ensure security of customer or user data.|

        |**ECOLOGICALIMPACTS**|**Ecological Impacts** - the category addresses
        management of the company's impacts on ecosystems and biodiversity
        through activities including, but not limited to, land use for
        exploration, natural resource extraction, and cultivation, as well as
        project development, construction, and siting. The impacts include, but
        are not limited to, biodiversity loss, habitat destruction, and
        deforestation at all stages – planning, land acquisition, permitting,
        development, operations, and site remediation. The category does not
        cover impacts of climate change on ecosystems and biodiversity.|

        |**EMPENGDIVANDINC**|**Employee Engagement Diversity and Inclusion** -
        the category addresses a company's ability to ensure that its culture
        and hiring and promotion practices embrace the building of a diverse and
        inclusive workforce that reflects the makeup of local talent pools and
        its customer base. It addresses the issues of discriminatory practices
        on the bases of race, gender, ethnicity, religion, sexual orientation,
        and other factors.|

        |**EMPHEALTHANDSAFETY**|**Employee Health and Safety** - the category
        addresses a company's ability to create and maintain a safe and healthy
        workplace environment that is free of injuries, fatalities, and illness
        (both chronic and acute). It is traditionally accomplished through
        implementing safety management plans, developing training requirements
        for employees and contractors, and conducting regular audits of their
        own practices as well as those of their subcontractors. The category
        further captures how companies ensure physical and mental health of
        workforce through technology, training, corporate culture, regulatory
        compliance, monitoring and testing, and personal protective equipment.|

        |**ENERGYMGT**|**Energy Management** - the category addresses
        environmental impacts associated with energy consumption. It addresses
        the company's management of energy in manufacturing and/or for provision
        of products and services derived from utility providers (grid energy)
        not owned or controlled by the company. More specifically, it includes
        management of energy efficiency and intensity, energy mix, as well as
        grid reliance. Upstream (e.g., suppliers) and downstream (e.g., product
        use) energy use is not included in the scope.|

        |**GHGEMISSIONS**|**Greenhouse Gas Emissions** - the category addresses
        direct (Scope 1) greenhouse gas (GHG) emissions that a company generates
        through its operations. This includes GHG emissions from stationary
        (e.g., factories, power plants) and mobile sources (e.g., trucks,
        delivery vehicles, planes), whether a result of combustion of fuel or
        non-combusted direct releases during activities such as natural resource
        extraction, power generation, land use, or biogenic processes. The
        category further includes management of regulatory risks, environmental
        compliance, and reputational risks and opportunities, as they related to
        direct GHG emissions. The seven GHGs covered under the Kyoto Protocol
        are included within the category— carbon dioxide (CO2 ), methane (CH4),
        nitrous oxide (N2O), hydrofluorocarbons (HFCs), perfluorocarbons (PFCs),
        sulfur hexafluoride (SF6), and nitrogen trifluoride (NF3).|

        |**HUMANRIGHTSANDCOMRELS**|**Human Rights and Community Relations** -
        the category addresses management of the relationship between businesses
        and the communities in which they operate, including, but not limited
        to, management of direct and indirect impacts on core human rights and
        the treatment of indigenous peoples. More specifically, such management
        may cover socio-economic community impacts, community engagement,
        environmental justice, cultivation of local workforces, impact on local
        businesses, license to operate, and environmental/social impact
        assessments. The category does not include environmental impacts such as
        air pollution or waste which, although they may impact the health and
        safety of members of local communities, are addressed in separate
        categories.|

        |**LABORPRACTICES**|**Labor Practices** - the category addresses the
        company's ability to uphold commonly accepted labor standards in the
        workplace, including compliance with labor laws and internationally
        accepted norms and standards. This includes, but is not limited to,
        ensuring basic human rights related to child labor, forced or bonded
        labor, exploitative labor, fair wages and overtime pay, and other basic
        workers' rights. It also includes minimum wage policies and provision of
        benefits, which may influence how a workforce is attracted, retained,
        and motivated. The category further addresses a company's relationship
        with organized labor and freedom of association.|

        |**MGTOFLEGALANDREGENV**|**Management of the Legal and Regulatory
        Environment** - the category addresses a company's approach to engaging
        with regulators in cases where conflicting corporate and public
        interests may have the potential for long-term adverse direct or
        indirect environmental and social impacts. The category addresses a
        company's level of reliance upon regulatory policy or monetary
        incentives (such as subsidies and taxes), actions to influence industry
        policy (such as through lobbying), overall reliance on a favorable
        regulatory environment for business competitiveness, and ability to
        comply with relevant regulations. It may relate to the alignment of
        management and investor views of regulatory engagement and compliance at
        large.|

        |**MATSOURCINGANDEFF**|**Materials Sourcing and Efficiency** - the
        category addresses issues related to the resilience of materials supply
        chains to impacts of climate change and other external environmental and
        social factors. It captures the impacts of such external factors on
        operational activity of suppliers, which can further affect availability
        and pricing of key resources. It addresses a company's ability to manage
        these risks through product design, manufacturing, and end-of-life
        management, such as by using of recycled and renewable materials,
        reducing the use of key materials (dematerialization), maximizing
        resource efficiency in manufacturing, and making R&D investments in
        substitute materials. Additionally, companies can manage these issues by
        screening, selection, monitoring, and engagement with suppliers to
        ensure their resilience to external risks. It does not address issues
        associated with environmental and social externalities created by
        operational activity of individual suppliers, which is covered in a
        separate category.|

        |**MATERIALITY**|**Materiality** - this category represents a composite
        score 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/)|

        |**PHYIMPACTSOFCLIMATECHG**|**Physical Impacts of Climate Change** - the
        category addresses the company's ability to manage risks and
        opportunities associated with direct exposure of its owned or controlled
        assets and operations to actual or potential physical impacts of climate
        change. It captures environmental and social issues that may arise from
        operational disruptions due to physical impacts of climate change. It
        further captures socioeconomic issues resulting from companies failing
        to incorporate climate change consideration in products and services
        sold, such as insurance policies and mortgages. The category relates to
        the company's ability to adapt to increased frequency and severity of
        extreme weather, shifting climate, sea level risk, and other expected
        physical impacts of climate change. Management may involve enhancing
        resiliency of physical assets and/or surrounding infrastructure as well
        as incorporation of climate change-related considerations into key
        business activities (e.g., mortgage and insurance underwriting, planning
        and development of real estate projects).|

        |**PDANDLIFECYCLEMGT**|**Product Design and Lifecycle Management** - the
        category addresses incorporation of environmental, social, and
        governance (ESG) considerations in characteristics of products and
        services provided or sold by the company. It includes, but is not
        limited to, managing the lifecycle impacts of products and services,
        such as those related to packaging, distribution, use-phase resource
        intensity, and other environmental and social externalities that may
        occur during their use-phase or at the end of life. The category
        captures a company's ability to address customer and societal demand for
        more sustainable products and services as well as to meet evolving
        environmental and social regulation. It does not address direct
        environmental or social impacts of the company's operations nor does it
        address health and safety risks to consumers from product use, which are
        covered in other categories.|

        |**PRODQUALITYANDSFTY**|**Product Quality and Safety** - the category
        addresses issues involving unintended characteristics of products sold
        or services provided that may create health or safety risks to
        end-users. It addresses a company's ability to offer manufactured
        products and/or services that meet customer expectations with respect to
        their health and safety characteristics. It includes, but is not limited
        to, issues involving liability, management of recalls and market
        withdrawals, product testing, and chemicals/content/ ingredient
        management in products.|

        |**SELLPRACANDPRODLABEL**|**Selling Practices and Product Labeling** -
        the category addresses social issues that may arise from a failure to
        manage the transparency, accuracy, and comprehensibility of marketing
        statements, advertising, and labeling of products and services. It
        includes, but is not limited to, advertising standards and regulations,
        ethical and responsible marketing practices, misleading or deceptive
        labeling, as well as discriminatory or predatory selling and lending
        practices. This may include deceptive or aggressive selling practices in
        which incentive structures for employees could encourage the sale of
        products or services that are not in the best interest of customers or
        clients.|

        |**SUPPLYCHAINMGT**|**Supply Chain Management** - the category addresses
        management of environmental, social, and governance (ESG) risks within a
        company's supply chain. It addresses issues associated with
        environmental and social externalities created by suppliers through
        their operational activities. Such issues include, but are not limited
        to, environmental responsibility, human rights, labor practices, and
        ethics and corruption. Management may involve screening, selection,
        monitoring, and engagement with suppliers on their environmental and
        social impacts. The category does not address the impacts of external
        factors – such as climate change and other environmental and social
        factors – on suppliers' operations and/or on the availability and
        pricing of key resources, which is covered in a separate category.|

        |**SYSTEMICRISKMGT**|**Systemic Risk Management** - the category
        addresses the company's contributions to, or management of systemic
        risks resulting from large-scale weakening or collapse of systems upon
        which the economy and society depend. This includes financial systems,
        natural resource systems, and technological systems. It addresses the
        mechanisms a company has in place to reduce its contributions to
        systemic risks and to improve safeguards that may mitigate the impacts
        of systemic failure. For financial institutions, the category also
        captures the company's ability to absorb shocks arising from financial
        and economic stress and meet stricter regulatory requirements related to
        the complexity and interconnectedness of companies in the industry.|

        |**WASTEANDHZRDMATSMGT**|**Waste and Hazardous Materials Management** -
        the category addresses environmental issues associated with hazardous
        and non-hazardous waste generated by companies. It addresses a company's
        management of solid wastes in manufacturing, agriculture, and other
        industrial processes. It covers treatment, handling, storage, disposal,
        and regulatory compliance. The category does not cover emissions to air
        or wastewater, nor does it cover waste from end-of-life of products,
        which are addressed in separate categories.|

        |**WATERANDWASTEWATERMGT**|**Water and Wastewater Management** - the
        category addresses a company's water use, water consumption, wastewater
        generation, and other impacts of operations on water resources, which
        may be influenced by regional differences in the availability and
        quality of and competition for water resources. More specifically, it
        addresses management strategies including, but not limited to, water
        efficiency, intensity, and recycling. Lastly, the category also
        addresses management of wastewater treatment and discharge, including
        groundwater and aquifer pollution.|


        ### Helper Input

        **ALL** = Simply gives the ability to request all categories in a single
        request without having to explicitly list out all 26 in the request.
        *This is not the same as "ALLCATEGORIES" which is a single overall score
        for the company and returned as default.*
      example:
        - AIRQUALITY
        - BUSINESSETHICS
        - HUMANRIGHTSANDCOMRELS
    sasbSpotlightsCategories:
      name: categories
      in: query
      schema:
        type: array
        default:
          - ALLCATEGORIES
        items:
          type: string
      required: false
      explode: false
      description: >
        The SASB Categories requested for the respective scoreType(s). The
        default value is **ALLCATEGORIES**, which represents all 26 categories
        in a single overall score. To request a specifc category or list of
        categories, simply input the category names below. 


        ### SASB Categories

        |**SASB Category Inputs**|**Description**|

        |||

        |**ALLCATEGORIES**|**All Categories** - this category represents a
        company's overall SASB Score for the specific 'scoreType'. This value is
        equal to the cumulative average of all 26 SASB categories for the
        specific 'scoreType'.*Note that category is not available for the
        Dynamic Materiality 'scoreType'.|

        |**ACCESSANDAFFORDABILITY**|**Access and Affordability** - The category
        addresses a company's ability to ensure broad access to its products and
        services, specifically in the context of underserved markets and/or
        population groups. It includes the management of issues related to
        universal needs, such as the accessibility and affordability of health
        care, financial services, utilities , education, and
        telecommunications.|

        |**AIRQUALITY**|**Air Quality** - the category addresses management of
        air quality impacts resulting from stationary (e.g., factories, power
        plants) and mobile sources (e.g., trucks, delivery vehicles, planes) as
        well as industrial emissions. Relevant airborne pollutants include, but
        are not limited to, oxides of nitrogen (NOx), oxides of sulfur (SOx),
        volatile organic compounds (VOCs), heavy metals, particulate matter, and
        chlorofluorocarbons. The category does not include GHG emissions, which
        are addressed in a separate category.|

        |**BUSINESSETHICS**|**Business Ethics** - the category addresses the
        company's approach to managing risks and opportunities surrounding
        ethical conduct of business, including fraud, corruption, bribery and
        facilitation payments, fiduciary responsibilities, and other behavior
        that may have an ethical component. This includes sensitivity to
        business norms and standards as they shift over time, jurisdiction, and
        culture. It addresses the company's ability to provide services that
        satisfy the highest professional and ethical standards of the industry,
        which means to avoid conflicts of interest, misrepresentation, bias, and
        negligence through training employees adequately and implementing
        policies and procedures to ensure employees provide services free from
        bias and error.|

        |**BUSMODELRESILIENCE**|**Business Model Resilience** - the category
        addresses an industry's capacity to manage risks and opportunities
        associated with incorporating social, environmental, and political
        transitions into long-term business model planning. This includes
        responsiveness to the transition to a low-carbon and climate-constrained
        economy, as well as growth and creation of new markets among unserved
        and underserved socioeconomic populations. The category highlights
        industries in which evolving environmental and social realities may
        challenge companies to fundamentally adapt or may put their business
        models at risk.|

        |**COMPETITIVEBEHAVIOR**|**Competitive Behavior** - the category covers
        social issues associated with existence of monopolies, which may
        include, but are not limited to, excessive prices, poor quality of
        service, and inefficiencies. It addresses a company's management of
        legal and social expectation around monopolistic and anti-competitive
        practices, including issues related to bargaining power, collusion,
        price fixing or manipulation, and protection of patents and intellectual
        property (IP).|

        |**CRITINCIDENTRISKMGT**|**Critical Incident Risk Management** - the
        category addresses the company's use of management systems and scenario
        planning to identify, understand, and prevent or minimize the occurrence
        of low-probability, high-impact accidents and emergencies with
        significant potential environmental and social externalities. It relates
        to the culture of safety at a company, its relevant safety management
        systems and technological controls, the potential human, environmental,
        and social implications of such events occurring, and the long-term
        effects to an organization, its workers, and society should these events
        occur.|

        |**CUSTOMERPRIVACY**|**Customer Privacy** - the category addresses
        management of risks related to the use of personally identifiable
        information (PII) and other customer or user data for secondary purposes
        including but not limited to marketing through affiliates and
        non-affiliates. The scope of the category includes social issues that
        may arise from a company's approach to collecting data, obtaining
        consent (e.g., opt-in policies), managing user and customer expectations
        regarding how their data is used, and managing evolving regulation. It
        excludes social issues arising from cybersecurity risks, which are
        covered in a separate category.|

        |**CUSTWELFARE**|**Customer Welfare** - the category addresses customer
        welfare concerns over issues including, but not limited to, health and
        nutrition of foods and beverages, antibiotic use in animal production,
        and management of controlled substances. The category addresses the
        company's ability to provide consumers with manufactured products and
        services that are aligned with societal expectations. It does not
        include issues directly related to quality and safety malfunctions of
        manufactured products and services, but instead addresses qualities
        inherent to the design and delivery of products and services where
        customer welfare may be in question. The scope of the category also
        captures companies' ability to prevent counterfeit products.|

        |**DATASECURITY**|**Data Security** - the category addresses management
        of risks related to collection, retention, and use of sensitive,
        confidential, and/or proprietary customer or user data. It includes
        social issues that may arise from incidents such as data breaches in
        which personally identifiable information (PII) and other user or
        customer data may be exposed. It addresses a company's strategy,
        policies, and practices related to IT infrastructure, staff training,
        record keeping, cooperation with law enforcement, and other mechanisms
        used to ensure security of customer or user data.|

        |**ECOLOGICALIMPACTS**|**Ecological Impacts** - the category addresses
        management of the company's impacts on ecosystems and biodiversity
        through activities including, but not limited to, land use for
        exploration, natural resource extraction, and cultivation, as well as
        project development, construction, and siting. The impacts include, but
        are not limited to, biodiversity loss, habitat destruction, and
        deforestation at all stages – planning, land acquisition, permitting,
        development, operations, and site remediation. The category does not
        cover impacts of climate change on ecosystems and biodiversity.|

        |**EMPENGDIVANDINC**|**Employee Engagement Diversity and Inclusion** -
        the category addresses a company's ability to ensure that its culture
        and hiring and promotion practices embrace the building of a diverse and
        inclusive workforce that reflects the makeup of local talent pools and
        its customer base. It addresses the issues of discriminatory practices
        on the bases of race, gender, ethnicity, religion, sexual orientation,
        and other factors.|

        |**EMPHEALTHANDSAFETY**|**Employee Health and Safety** - the category
        addresses a company's ability to create and maintain a safe and healthy
        workplace environment that is free of injuries, fatalities, and illness
        (both chronic and acute). It is traditionally accomplished through
        implementing safety management plans, developing training requirements
        for employees and contractors, and conducting regular audits of their
        own practices as well as those of their subcontractors. The category
        further captures how companies ensure physical and mental health of
        workforce through technology, training, corporate culture, regulatory
        compliance, monitoring and testing, and personal protective equipment.|

        |**ENERGYMGT**|**Energy Management** - the category addresses
        environmental impacts associated with energy consumption. It addresses
        the company's management of energy in manufacturing and/or for provision
        of products and services derived from utility providers (grid energy)
        not owned or controlled by the company. More specifically, it includes
        management of energy efficiency and intensity, energy mix, as well as
        grid reliance. Upstream (e.g., suppliers) and downstream (e.g., product
        use) energy use is not included in the scope.|

        |**GHGEMISSIONS**|**Greenhouse Gas Emissions** - the category addresses
        direct (Scope 1) greenhouse gas (GHG) emissions that a company generates
        through its operations. This includes GHG emissions from stationary
        (e.g., factories, power plants) and mobile sources (e.g., trucks,
        delivery vehicles, planes), whether a result of combustion of fuel or
        non-combusted direct releases during activities such as natural resource
        extraction, power generation, land use, or biogenic processes. The
        category further includes management of regulatory risks, environmental
        compliance, and reputational risks and opportunities, as they related to
        direct GHG emissions. The seven GHGs covered under the Kyoto Protocol
        are included within the category— carbon dioxide (CO2 ), methane (CH4),
        nitrous oxide (N2O), hydrofluorocarbons (HFCs), perfluorocarbons (PFCs),
        sulfur hexafluoride (SF6), and nitrogen trifluoride (NF3).|

        |**HUMANRIGHTSANDCOMRELS**|**Human Rights and Community Relations** -
        the category addresses management of the relationship between businesses
        and the communities in which they operate, including, but not limited
        to, management of direct and indirect impacts on core human rights and
        the treatment of indigenous peoples. More specifically, such management
        may cover socio-economic community impacts, community engagement,
        environmental justice, cultivation of local workforces, impact on local
        businesses, license to operate, and environmental/social impact
        assessments. The category does not include environmental impacts such as
        air pollution or waste which, although they may impact the health and
        safety of members of local communities, are addressed in separate
        categories.|

        |**LABORPRACTICES**|**Labor Practices** - the category addresses the
        company's ability to uphold commonly accepted labor standards in the
        workplace, including compliance with labor laws and internationally
        accepted norms and standards. This includes, but is not limited to,
        ensuring basic human rights related to child labor, forced or bonded
        labor, exploitative labor, fair wages and overtime pay, and other basic
        workers' rights. It also includes minimum wage policies and provision of
        benefits, which may influence how a workforce is attracted, retained,
        and motivated. The category further addresses a company's relationship
        with organized labor and freedom of association.|

        |**MGTOFLEGALANDREGENV**|**Management of the Legal and Regulatory
        Environment** - the category addresses a company's approach to engaging
        with regulators in cases where conflicting corporate and public
        interests may have the potential for long-term adverse direct or
        indirect environmental and social impacts. The category addresses a
        company's level of reliance upon regulatory policy or monetary
        incentives (such as subsidies and taxes), actions to influence industry
        policy (such as through lobbying), overall reliance on a favorable
        regulatory environment for business competitiveness, and ability to
        comply with relevant regulations. It may relate to the alignment of
        management and investor views of regulatory engagement and compliance at
        large.|

        |**MATSOURCINGANDEFF**|**Materials Sourcing and Efficiency** - the
        category addresses issues related to the resilience of materials supply
        chains to impacts of climate change and other external environmental and
        social factors. It captures the impacts of such external factors on
        operational activity of suppliers, which can further affect availability
        and pricing of key resources. It addresses a company's ability to manage
        these risks through product design, manufacturing, and end-of-life
        management, such as by using of recycled and renewable materials,
        reducing the use of key materials (dematerialization), maximizing
        resource efficiency in manufacturing, and making R&D investments in
        substitute materials. Additionally, companies can manage these issues by
        screening, selection, monitoring, and engagement with suppliers to
        ensure their resilience to external risks. It does not address issues
        associated with environmental and social externalities created by
        operational activity of individual suppliers, which is covered in a
        separate category.|

        |**MATERIALITY**|**Materiality** - this category represents a composite
        score 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/)|

        |**PHYIMPACTSOFCLIMATECHG**|**Physical Impacts of Climate Change** - the
        category addresses the company's ability to manage risks and
        opportunities associated with direct exposure of its owned or controlled
        assets and operations to actual or potential physical impacts of climate
        change. It captures environmental and social issues that may arise from
        operational disruptions due to physical impacts of climate change. It
        further captures socioeconomic issues resulting from companies failing
        to incorporate climate change consideration in products and services
        sold, such as insurance policies and mortgages. The category relates to
        the company's ability to adapt to increased frequency and severity of
        extreme weather, shifting climate, sea level risk, and other expected
        physical impacts of climate change. Management may involve enhancing
        resiliency of physical assets and/or surrounding infrastructure as well
        as incorporation of climate change-related considerations into key
        business activities (e.g., mortgage and insurance underwriting, planning
        and development of real estate projects).|

        |**PDANDLIFECYCLEMGT**|**Product Design and Lifecycle Management** - the
        category addresses incorporation of environmental, social, and
        governance (ESG) considerations in characteristics of products and
        services provided or sold by the company. It includes, but is not
        limited to, managing the lifecycle impacts of products and services,
        such as those related to packaging, distribution, use-phase resource
        intensity, and other environmental and social externalities that may
        occur during their use-phase or at the end of life. The category
        captures a company's ability to address customer and societal demand for
        more sustainable products and services as well as to meet evolving
        environmental and social regulation. It does not address direct
        environmental or social impacts of the company's operations nor does it
        address health and safety risks to consumers from product use, which are
        covered in other categories.|

        |**PRODQUALITYANDSFTY**|**Product Quality and Safety** - the category
        addresses issues involving unintended characteristics of products sold
        or services provided that may create health or safety risks to
        end-users. It addresses a company's ability to offer manufactured
        products and/or services that meet customer expectations with respect to
        their health and safety characteristics. It includes, but is not limited
        to, issues involving liability, management of recalls and market
        withdrawals, product testing, and chemicals/content/ ingredient
        management in products.|

        |**SELLPRACANDPRODLABEL**|**Selling Practices and Product Labeling** -
        the category addresses social issues that may arise from a failure to
        manage the transparency, accuracy, and comprehensibility of marketing
        statements, advertising, and labeling of products and services. It
        includes, but is not limited to, advertising standards and regulations,
        ethical and responsible marketing practices, misleading or deceptive
        labeling, as well as discriminatory or predatory selling and lending
        practices. This may include deceptive or aggressive selling practices in
        which incentive structures for employees could encourage the sale of
        products or services that are not in the best interest of customers or
        clients.|

        |**SUPPLYCHAINMGT**|**Supply Chain Management** - the category addresses
        management of environmental, social, and governance (ESG) risks within a
        company's supply chain. It addresses issues associated with
        environmental and social externalities created by suppliers through
        their operational activities. Such issues include, but are not limited
        to, environmental responsibility, human rights, labor practices, and
        ethics and corruption. Management may involve screening, selection,
        monitoring, and engagement with suppliers on their environmental and
        social impacts. The category does not address the impacts of external
        factors – such as climate change and other environmental and social
        factors – on suppliers' operations and/or on the availability and
        pricing of key resources, which is covered in a separate category.|

        |**SYSTEMICRISKMGT**|**Systemic Risk Management** - the category
        addresses the company's contributions to, or management of systemic
        risks resulting from large-scale weakening or collapse of systems upon
        which the economy and society depend. This includes financial systems,
        natural resource systems, and technological systems. It addresses the
        mechanisms a company has in place to reduce its contributions to
        systemic risks and to improve safeguards that may mitigate the impacts
        of systemic failure. For financial institutions, the category also
        captures the company's ability to absorb shocks arising from financial
        and economic stress and meet stricter regulatory requirements related to
        the complexity and interconnectedness of companies in the industry.|

        |**WASTEANDHZRDMATSMGT**|**Waste and Hazardous Materials Management** -
        the category addresses environmental issues associated with hazardous
        and non-hazardous waste generated by companies. It addresses a company's
        management of solid wastes in manufacturing, agriculture, and other
        industrial processes. It covers treatment, handling, storage, disposal,
        and regulatory compliance. The category does not cover emissions to air
        or wastewater, nor does it cover waste from end-of-life of products,
        which are addressed in separate categories.|

        |**WATERANDWASTEWATERMGT**|**Water and Wastewater Management** - the
        category addresses a company's water use, water consumption, wastewater
        generation, and other impacts of operations on water resources, which
        may be influenced by regional differences in the availability and
        quality of and competition for water resources. More specifically, it
        addresses management strategies including, but not limited to, water
        efficiency, intensity, and recycling. Lastly, the category also
        addresses management of wastewater treatment and discharge, including
        groundwater and aquifer pollution.|
      example:
        - AIRQUALITY
        - BUSINESSETHICS
        - HUMANRIGHTSANDCOMRELS
    sasbArticlesCategories:
      name: categories
      in: query
      schema:
        type: array
        default:
          - ALLCATEGORIES
        items:
          type: string
      required: false
      explode: false
      description: >
        Comma seperated list of one or more SASB category names as described
        below. The default value is **ALLCATEGORIES**. 


        ### SASB Categories

        |**SASB Category Inputs**|**Description**|

        |||

        |**ALLCATEGORIES**|**All Categories** - Provides articles tagged to all
        26 categories of SASB. Equivalent to providing all 26 categories

        |**SASBMATERIALITY**|**SASBMateriality** - provides articles tagged to
        material categories according to SASB's materiality framework. When
        provided, only material categories for each company is fetched|

        |**ACCESSANDAFFORDABILITY**|**Access and Affordability** - The category
        addresses a company's ability to ensure broad access to its products and
        services, specifically in the context of underserved markets and/or
        population groups. It includes the management of issues related to
        universal needs, such as the accessibility and affordability of health
        care, financial services, utilities , education, and
        telecommunications.|

        |**AIRQUALITY**|**Air Quality** - the category addresses management of
        air quality impacts resulting from stationary (e.g., factories, power
        plants) and mobile sources (e.g., trucks, delivery vehicles, planes) as
        well as industrial emissions. Relevant airborne pollutants include, but
        are not limited to, oxides of nitrogen (NOx), oxides of sulfur (SOx),
        volatile organic compounds (VOCs), heavy metals, particulate matter, and
        chlorofluorocarbons. The category does not include GHG emissions, which
        are addressed in a separate category.|

        |**BUSINESSETHICS**|**Business Ethics** - the category addresses the
        company's approach to managing risks and opportunities surrounding
        ethical conduct of business, including fraud, corruption, bribery and
        facilitation payments, fiduciary responsibilities, and other behavior
        that may have an ethical component. This includes sensitivity to
        business norms and standards as they shift over time, jurisdiction, and
        culture. It addresses the company's ability to provide services that
        satisfy the highest professional and ethical standards of the industry,
        which means to avoid conflicts of interest, misrepresentation, bias, and
        negligence through training employees adequately and implementing
        policies and procedures to ensure employees provide services free from
        bias and error.|

        |**BUSMODELRESILIENCE**|**Business Model Resilience** - the category
        addresses an industry's capacity to manage risks and opportunities
        associated with incorporating social, environmental, and political
        transitions into long-term business model planning. This includes
        responsiveness to the transition to a low-carbon and climate-constrained
        economy, as well as growth and creation of new markets among unserved
        and underserved socioeconomic populations. The category highlights
        industries in which evolving environmental and social realities may
        challenge companies to fundamentally adapt or may put their business
        models at risk.|

        |**COMPETITIVEBEHAVIOR**|**Competitive Behavior** - the category covers
        social issues associated with existence of monopolies, which may
        include, but are not limited to, excessive prices, poor quality of
        service, and inefficiencies. It addresses a company's management of
        legal and social expectation around monopolistic and anti-competitive
        practices, including issues related to bargaining power, collusion,
        price fixing or manipulation, and protection of patents and intellectual
        property (IP).|

        |**CRITINCIDENTRISKMGT**|**Critical Incident Risk Management** - the
        category addresses the company's use of management systems and scenario
        planning to identify, understand, and prevent or minimize the occurrence
        of low-probability, high-impact accidents and emergencies with
        significant potential environmental and social externalities. It relates
        to the culture of safety at a company, its relevant safety management
        systems and technological controls, the potential human, environmental,
        and social implications of such events occurring, and the long-term
        effects to an organization, its workers, and society should these events
        occur.|

        |**CUSTOMERPRIVACY**|**Customer Privacy** - the category addresses
        management of risks related to the use of personally identifiable
        information (PII) and other customer or user data for secondary purposes
        including but not limited to marketing through affiliates and
        non-affiliates. The scope of the category includes social issues that
        may arise from a company's approach to collecting data, obtaining
        consent (e.g., opt-in policies), managing user and customer expectations
        regarding how their data is used, and managing evolving regulation. It
        excludes social issues arising from cybersecurity risks, which are
        covered in a separate category.|

        |**CUSTWELFARE**|**Customer Welfare** - the category addresses customer
        welfare concerns over issues including, but not limited to, health and
        nutrition of foods and beverages, antibiotic use in animal production,
        and management of controlled substances. The category addresses the
        company's ability to provide consumers with manufactured products and
        services that are aligned with societal expectations. It does not
        include issues directly related to quality and safety malfunctions of
        manufactured products and services, but instead addresses qualities
        inherent to the design and delivery of products and services where
        customer welfare may be in question. The scope of the category also
        captures companies' ability to prevent counterfeit products.|

        |**DATASECURITY**|**Data Security** - the category addresses management
        of risks related to collection, retention, and use of sensitive,
        confidential, and/or proprietary customer or user data. It includes
        social issues that may arise from incidents such as data breaches in
        which personally identifiable information (PII) and other user or
        customer data may be exposed. It addresses a company's strategy,
        policies, and practices related to IT infrastructure, staff training,
        record keeping, cooperation with law enforcement, and other mechanisms
        used to ensure security of customer or user data.|

        |**ECOLOGICALIMPACTS**|**Ecological Impacts** - the category addresses
        management of the company's impacts on ecosystems and biodiversity
        through activities including, but not limited to, land use for
        exploration, natural resource extraction, and cultivation, as well as
        project development, construction, and siting. The impacts include, but
        are not limited to, biodiversity loss, habitat destruction, and
        deforestation at all stages – planning, land acquisition, permitting,
        development, operations, and site remediation. The category does not
        cover impacts of climate change on ecosystems and biodiversity.|

        |**EMPENGDIVANDINC**|**Employee Engagement Diversity and Inclusion** -
        the category addresses a company's ability to ensure that its culture
        and hiring and promotion practices embrace the building of a diverse and
        inclusive workforce that reflects the makeup of local talent pools and
        its customer base. It addresses the issues of discriminatory practices
        on the bases of race, gender, ethnicity, religion, sexual orientation,
        and other factors.|

        |**EMPHEALTHANDSAFETY**|**Employee Health and Safety** - the category
        addresses a company's ability to create and maintain a safe and healthy
        workplace environment that is free of injuries, fatalities, and illness
        (both chronic and acute). It is traditionally accomplished through
        implementing safety management plans, developing training requirements
        for employees and contractors, and conducting regular audits of their
        own practices as well as those of their subcontractors. The category
        further captures how companies ensure physical and mental health of
        workforce through technology, training, corporate culture, regulatory
        compliance, monitoring and testing, and personal protective equipment.|

        |**ENERGYMGT**|**Energy Management** - the category addresses
        environmental impacts associated with energy consumption. It addresses
        the company's management of energy in manufacturing and/or for provision
        of products and services derived from utility providers (grid energy)
        not owned or controlled by the company. More specifically, it includes
        management of energy efficiency and intensity, energy mix, as well as
        grid reliance. Upstream (e.g., suppliers) and downstream (e.g., product
        use) energy use is not included in the scope.|

        |**GHGEMISSIONS**|**Greenhouse Gas Emissions** - the category addresses
        direct (Scope 1) greenhouse gas (GHG) emissions that a company generates
        through its operations. This includes GHG emissions from stationary
        (e.g., factories, power plants) and mobile sources (e.g., trucks,
        delivery vehicles, planes), whether a result of combustion of fuel or
        non-combusted direct releases during activities such as natural resource
        extraction, power generation, land use, or biogenic processes. The
        category further includes management of regulatory risks, environmental
        compliance, and reputational risks and opportunities, as they related to
        direct GHG emissions. The seven GHGs covered under the Kyoto Protocol
        are included within the category— carbon dioxide (CO2 ), methane (CH4),
        nitrous oxide (N2O), hydrofluorocarbons (HFCs), perfluorocarbons (PFCs),
        sulfur hexafluoride (SF6), and nitrogen trifluoride (NF3).|

        |**HUMANRIGHTSANDCOMRELS**|**Human Rights and Community Relations** -
        the category addresses management of the relationship between businesses
        and the communities in which they operate, including, but not limited
        to, management of direct and indirect impacts on core human rights and
        the treatment of indigenous peoples. More specifically, such management
        may cover socio-economic community impacts, community engagement,
        environmental justice, cultivation of local workforces, impact on local
        businesses, license to operate, and environmental/social impact
        assessments. The category does not include environmental impacts such as
        air pollution or waste which, although they may impact the health and
        safety of members of local communities, are addressed in separate
        categories.|

        |**LABORPRACTICES**|**Labor Practices** - the category addresses the
        company's ability to uphold commonly accepted labor standards in the
        workplace, including compliance with labor laws and internationally
        accepted norms and standards. This includes, but is not limited to,
        ensuring basic human rights related to child labor, forced or bonded
        labor, exploitative labor, fair wages and overtime pay, and other basic
        workers' rights. It also includes minimum wage policies and provision of
        benefits, which may influence how a workforce is attracted, retained,
        and motivated. The category further addresses a company's relationship
        with organized labor and freedom of association.|

        |**MGTOFLEGALANDREGENV**|**Management of the Legal and Regulatory
        Environment** - the category addresses a company's approach to engaging
        with regulators in cases where conflicting corporate and public
        interests may have the potential for long-term adverse direct or
        indirect environmental and social impacts. The category addresses a
        company's level of reliance upon regulatory policy or monetary
        incentives (such as subsidies and taxes), actions to influence industry
        policy (such as through lobbying), overall reliance on a favorable
        regulatory environment for business competitiveness, and ability to
        comply with relevant regulations. It may relate to the alignment of
        management and investor views of regulatory engagement and compliance at
        large.|

        |**MATSOURCINGANDEFF**|**Materials Sourcing and Efficiency** - the
        category addresses issues related to the resilience of materials supply
        chains to impacts of climate change and other external environmental and
        social factors. It captures the impacts of such external factors on
        operational activity of suppliers, which can further affect availability
        and pricing of key resources. It addresses a company's ability to manage
        these risks through product design, manufacturing, and end-of-life
        management, such as by using of recycled and renewable materials,
        reducing the use of key materials (dematerialization), maximizing
        resource efficiency in manufacturing, and making R&D investments in
        substitute materials. Additionally, companies can manage these issues by
        screening, selection, monitoring, and engagement with suppliers to
        ensure their resilience to external risks. It does not address issues
        associated with environmental and social externalities created by
        operational activity of individual suppliers, which is covered in a
        separate category.|

        |**PHYIMPACTSOFCLIMATECHG**|**Physical Impacts of Climate Change** - the
        category addresses the company's ability to manage risks and
        opportunities associated with direct exposure of its owned or controlled
        assets and operations to actual or potential physical impacts of climate
        change. It captures environmental and social issues that may arise from
        operational disruptions due to physical impacts of climate change. It
        further captures socioeconomic issues resulting from companies failing
        to incorporate climate change consideration in products and services
        sold, such as insurance policies and mortgages. The category relates to
        the company's ability to adapt to increased frequency and severity of
        extreme weather, shifting climate, sea level risk, and other expected
        physical impacts of climate change. Management may involve enhancing
        resiliency of physical assets and/or surrounding infrastructure as well
        as incorporation of climate change-related considerations into key
        business activities (e.g., mortgage and insurance underwriting, planning
        and development of real estate projects).|

        |**PDANDLIFECYCLEMGT**|**Product Design and Lifecycle Management** - the
        category addresses incorporation of environmental, social, and
        governance (ESG) considerations in characteristics of products and
        services provided or sold by the company. It includes, but is not
        limited to, managing the lifecycle impacts of products and services,
        such as those related to packaging, distribution, use-phase resource
        intensity, and other environmental and social externalities that may
        occur during their use-phase or at the end of life. The category
        captures a company's ability to address customer and societal demand for
        more sustainable products and services as well as to meet evolving
        environmental and social regulation. It does not address direct
        environmental or social impacts of the company's operations nor does it
        address health and safety risks to consumers from product use, which are
        covered in other categories.|

        |**PRODQUALITYANDSFTY**|**Product Quality and Safety** - the category
        addresses issues involving unintended characteristics of products sold
        or services provided that may create health or safety risks to
        end-users. It addresses a company's ability to offer manufactured
        products and/or services that meet customer expectations with respect to
        their health and safety characteristics. It includes, but is not limited
        to, issues involving liability, management of recalls and market
        withdrawals, product testing, and chemicals/content/ ingredient
        management in products.|

        |**SELLPRACANDPRODLABEL**|**Selling Practices and Product Labeling** -
        the category addresses social issues that may arise from a failure to
        manage the transparency, accuracy, and comprehensibility of marketing
        statements, advertising, and labeling of products and services. It
        includes, but is not limited to, advertising standards and regulations,
        ethical and responsible marketing practices, misleading or deceptive
        labeling, as well as discriminatory or predatory selling and lending
        practices. This may include deceptive or aggressive selling practices in
        which incentive structures for employees could encourage the sale of
        products or services that are not in the best interest of customers or
        clients.|

        |**SUPPLYCHAINMGT**|**Supply Chain Management** - the category addresses
        management of environmental, social, and governance (ESG) risks within a
        company's supply chain. It addresses issues associated with
        environmental and social externalities created by suppliers through
        their operational activities. Such issues include, but are not limited
        to, environmental responsibility, human rights, labor practices, and
        ethics and corruption. Management may involve screening, selection,
        monitoring, and engagement with suppliers on their environmental and
        social impacts. The category does not address the impacts of external
        factors – such as climate change and other environmental and social
        factors – on suppliers' operations and/or on the availability and
        pricing of key resources, which is covered in a separate category.|

        |**SYSTEMICRISKMGT**|**Systemic Risk Management** - the category
        addresses the company's contributions to, or management of systemic
        risks resulting from large-scale weakening or collapse of systems upon
        which the economy and society depend. This includes financial systems,
        natural resource systems, and technological systems. It addresses the
        mechanisms a company has in place to reduce its contributions to
        systemic risks and to improve safeguards that may mitigate the impacts
        of systemic failure. For financial institutions, the category also
        captures the company's ability to absorb shocks arising from financial
        and economic stress and meet stricter regulatory requirements related to
        the complexity and interconnectedness of companies in the industry.|

        |**WASTEANDHZRDMATSMGT**|**Waste and Hazardous Materials Management** -
        the category addresses environmental issues associated with hazardous
        and non-hazardous waste generated by companies. It addresses a company's
        management of solid wastes in manufacturing, agriculture, and other
        industrial processes. It covers treatment, handling, storage, disposal,
        and regulatory compliance. The category does not cover emissions to air
        or wastewater, nor does it cover waste from end-of-life of products,
        which are addressed in separate categories.|

        |**WATERANDWASTEWATERMGT**|**Water and Wastewater Management** - the
        category addresses a company's water use, water consumption, wastewater
        generation, and other impacts of operations on water resources, which
        may be influenced by regional differences in the availability and
        quality of and competition for water resources. More specifically, it
        addresses management strategies including, but not limited to, water
        efficiency, intensity, and recycling. Lastly, the category also
        addresses management of wastewater treatment and discharge, including
        groundwater and aquifer pollution.|
      example:
        - AIRQUALITY
        - BUSINESSETHICS
        - HUMANRIGHTSANDCOMRELS
    rankCategories:
      name: categories
      in: query
      schema:
        type: array
        default:
          - ALL
        items:
          type: string
        minItems: 1
        maxItems: 28
      required: false
      explode: false
      description: >
        The Categories representing overall or composite rankings from all
        underlying 26 SASB Categories.


        ### SASB Categories

        |**SASB Category Inputs**|**Description**|

        |||

        |**ALLCATEGORIES**|**All Categories** - The company's overall SASB Rank.
        This value is equal to the cumulative average of all 26 SASB categories.

        |**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/)|


        ### Helper Input

        **ALL** = Simply gives the ability to request all categories in a single
        request without having to explicitly list each available category. 
      example:
        - ALLCATEGORIES
        - MATERIALITY
    tvlIds:
      name: ids
      in: query
      schema:
        type: array
        items:
          type: string
        minItems: 1
        maxItems: 1500
      required: true
      explode: false
      description: >
        Security or Entity identifiers. ISIN, Truvalue Identifiers,
        instrumentTvlId, instrumentPermId, and Tickers are accepted inputs.
        <p>***ids limit** =  1500 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 lead to
        exceeding this request line limit of 8KB, its advised for any requests
        with large request lines to be requested through the respective "POST"
        method.</p>*
      examples:
        oneId:
          summary: One Market Identifier
          value:
            - AAPL-USA
        multipleIds:
          summary: Multiple Market Identifiers
          value:
            - AAPL-US
            - GOOGL-US
            - MSFT-US
    paiIds:
      name: ids
      in: query
      schema:
        type: array
        items:
          type: string
      required: true
      explode: false
      description: >
        Security or Entity identifiers. FactSet Identifiers, tickers, CUSIP and
        SEDOL are accepted input. <p>***ids limit** =  1500 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 lead to exceeding this request line limit of
        8KB, its advised for any requests with large request lines to be
        requested through the respective "POST" method.</p>*
      examples:
        oneId:
          summary: One Market Identifier
          value:
            - AAPL-USA
        multipleIds:
          summary: Multiple Market Identifiers
          value:
            - AAPL-US
            - GOOGL-US
            - MSFT-US
    fieldsSasbSpotlights:
      name: fields
      in: query
      description: >
        Request available SASB Spotlights data fields to be included in the
        response.
         Default is all fields. _fsymId_,_orgId_, _date_, _spotlightId_, _groupId_ and _requestId_ are always included.
         
         <h3>Common Fields</h3> 
          |field|description|
          |||
          |fsymId|Factset Regional Security Identifier|
          |orgId|Unique identifier assigned by Truvalue that is applied on an organization level |          
          |date|Date for the period requested in YYYY-MM-DD format.|
          |spotlightId|Unique identifier identifying a Spotlight ESG event that is detected at the company level, within a single category.|
          |groupId|Unique identifier  identifying a Spotlight group using the Spotlight ID of the Primary Spotlight.|
          |requestId|Identifier that was used for the request.|
          
         <h3>SASB Spotlights Fields</h3>
         
          |field|description|
          |||
          |orgName|The current name of the organization (not point-in-time)|
          |primarySpotlight|Y/N value indicating the primary Spotlight in a Spotlight Group.|
          |spotlightCategory|SASB category tagged to each Spotlight.|
          |materialCategory|Indicates if the category is material for the organization based on SASBs Materiality Map|
          |status|Indicates status of a spotlight, which can be one of Completed or Ongoing.|
          |removed|Displays the date a Spotlight was removed from the dataset, if it has been removed.|
          |startDate|Date when a Spotlight has met the volume threshold for Spotlight consideration. Score and volume change metadata are associated with this date.|
          |liveDate|Date when a Spotlight meets confidence threshold and is considered a Spotlight. This date should never precede start date|
          |firstArticleDate|Date of earliest article in the Spotlight as of the Start Date.|
          |finalArticleDate|Date of final article in the Spotlight. This value can change over the course of the Spotlight until the Spotlight is marked as completed.|
          |organizationVolumeThreshold|The article volume needed to create a Spotlight, as set by the company's overall volume level classification on the Start Date.|
          |totalSpotlightVolume|Total number of articles in the Spotlight. This number will change until the Spotlight is marked as completed.|
          |startDateVolume|Number of articles in the Spotlight on the Start Date when it met the volume threshold. Does not include the number of articles that were added to the Spotlight after the Spotlight Start Date.|
          |primaryArticleSource|Source of the primary article.|
          |primaryArticleUrl|URL of the primary article.|
          |primaryArticleHeadline|Headline of primary Spotlight article.|
          |primaryArticleBulletpoints|Bullet points summarizing the primary article.|
          |meanArtScoreFinalDate|Average score of articles in Spotlight on Final Article Date. This score will continue to change until the Spotlight is marked as completed.|
          |meanArtScoreStartDate|Average score of articles in Spotlight on Start Date. This score will not change throughout the history of the spotlight.|
          |meanPulseScore|Average of pulse scores for each day from First Article Date to Final Article Date, including scores for both Start Date and Final Article Date.|
          |pulseBeforeFirstArticle|Pulse score for category at end-of-day on day before the First Article Date|
          |pulseOnFinalArticleDate|Pulse score for category at the end-of-day on the Final Article Date.|
          |pulseOnStartDate|Pulse score for the category at the end-of-day on the Start Date.|
          |zScoreOnFinalDate|Z-score for Spotlight as of Final Article Date. This score will continue to change until the Spotlight is marked as completed.|
          |zScoreOnStartDate|Z-score for Spotlight as of Start Date. This score will not change throughout the history of the spotlight.|
          |standoutLvlOnFinalDate|Describes if the spotlight is a High, Medium, or Low standout spotlight.  This score will continue to change until the Spotlight is marked as completed.|
          |standoutLvlOnStartDate|Describes if the spotlight is a High, Medium, or Low standout spotlight.|
      required: false
      explode: false
      schema:
        type: array
        items:
          type: string
    articlesFields:
      name: fields
      in: query
      description: |
        Request available Articles data fields to be included in the response.
         Default is all fields. _fsymId_ and _articleId_ are always included.
         
         <h3>Common Fields</h3> 
          |field|description|
          |||
          |fsymId|Factset Regional Security Identifier|
          |articleId|Unique ID of the article assigned by Truvalue|          
          
         <h3>Articles Fields</h3>
         
          |field|description|
          |||
          |datePub|Publication date of the article in YYYY-MM-DD format|
          |title|Title of the article|
          |source|Source of the article|
          |categories|categories assigned by Truvalue|
          |bullets|AI-generated bullet point summary for each article. Note, including bullets increases response size drastically|
          |author|Author of the article|
          |url|URL of the article|
          |language|Language code of the article|
          |dateIngestion|Date of TVL article ingestion and processing|
          |orgName| Organization name assigned by Truvalue|
          |orgId| Unique identifier assigned by Truvalue that is applied on an organization level 
      example:
        - datePub
      required: false
      explode: false
      schema:
        type: array
        items:
          type: string
    sdgCategories:
      name: categories
      in: query
      schema:
        type: array
        default:
          - IMPACT
        items:
          type: string
      required: false
      explode: false
      description: >
        The SDG Categories specified for the Truvalue Scores being requested. To
        specify select categories returned in the response, provide a
        comma-separated list of the scores using the description below.


        |**SDG Category Input**|**Description**|

        |||

        |**IMPACT**|**Impact** - The aggregate SDG score for each company is
        simply named "Impact." The SDG Impact Score is produced using a weighted
        average of individual category scores, where the weight utilized is the
        category score volume.|

        |**IMPACTARTICLES**|**Impact Articles** - The All Goals Category Volume
        measures the total number of times any of the 16 goals received a score
        over a trailing twelve-month (TTM) period of time. **( Data wil be
        returned only for `TTM_VOLUME` score type)**|       

        |**GOAL1NOPOVERTY**|**No Poverty** - Goal 1 focuses on poverty in all
        its manifestations and also aims to ensure social protection for the
        poor and vulnerable, increase access to basic services and support
        people harmed by climate related extreme events and other economic,
        social and environmental shocks and disasters. <p>**Company-Level Issue
        Examples** *- Financial services access and affordability, Underserved
        groups,Unethical pricing.*|

        |**GOAL2ZEROHUNGER**|**Zero Hunger** - Goal 2 aims to end hunger and all
        forms of malnutrition and commits to universal access to safe,
        nutritious and sufficient food at all times of the year, particularly
        for the poor and people in vulnerable situations (e.g., infants). This
        will require sustainable food production systems and resilient
        agricultural practices, equal access to land, technology, and markets
        and international cooperation on investments in infrastructure and
        technology to boost agricultural productivity. <p>**Company-Level Issue
        Examples** *- Sustainable agricultural practices, Agricultural
        ingredients sourcing and certifications, Food safety concerns, Animal
        welfare.*|

        |**GOAL3GOODHEALTHANDWELLBEING**|**Good Health and Wellbeing** - Goal 3
        seeks to ensure health and wellbeing for all, at every stage of life and
        addresses all major health priorities, including reproductive, maternal,
        and child health; communicable, noncommunicable and environmental
        diseases; universal health coverage; and access for all to safe,
        effective, quality, and affordable medicines and vaccines.<p>
        **Company-Level Issue Examples** *- Harmful Chemicals in Products,
        Product Recalls, Healthcare Access and Affordability.*|

        |**GOAL4QUALITYEDUCATION**|**Quality Education** - Goal 4 addresses
        access and affordability of education and skills development starting
        from childhood development and continuing through adulthood, including
        for girls, persons with disabilities, indigenous peoples and children in
        vulnerable situations, Improvements to the access to education it hopes
        to ensure that all youth and a substantial proportion of adults achieve
        literacy and numeracy. It also seeks to build and upgrade education
        facilities and to increase the supply of qualified
        teachers.<p>**Company-Level Issue Examples** *- Mentorship and training,
        Education company quality, Education company ethics.*|

        |**GOAL5GENDEREQUALITY**|**Gender Equality** - Goal 5 emphasizes
        eliminating discrimination and violence against women and girls. The
        Goal emphasizes ensuring women's full and effective participation and
        equal opportunities for leadership at all levels of decision-making in
        political, economic and public life. Access to sexual and reproductive
        health and reproductive rights and access to economic resources (e.g.,
        land ownership, financial services) are also
        emphasized.<p>**Company-Level Issue Examples** *- Board Diversity,
        Gender Discrimination, Sexual Harassment.*|

        |**GOAL6CLEANWATERANDSANITATION**|**Clean Water and Sanitation** - Goal
        6 not only addresses issues relating to drinking water, sanitation and
        hygiene, but also the quality and sustainability of water resources
        worldwide. It strives to achieve universal and equitable access to safe
        and affordable drinking water for all. It also focuses on adequate and
        equitable sanitation and hygiene and reducing pollution, minimizing
        release of hazardous chemicals and materials, and protection of
        water-related ecosystems. It also highlights increasing water-use
        efficiency across all sectors, recycling, and ensuring sustainable
        withdrawals and supply of freshwater.<p>**Company-Level Issue Examples**
        *- Water Pollution, Water Recycling and Stewardship, Water
        Infrastructure.*|

        |**GOAL7AFFORDABLEANDCLEANENERGY**|**Goal 7 Affordable and Clean
        Energy** - Goal 7 seeks to ensure access to affordable, reliable, and
        modern energy services for all. It aims to increase renewable energy in
        the global energy mix and improve energy efficiency significantly. It
        also calls for more access to clean energy research, technology, and
        infrastructure for renewable energy, energy efficiency, and advanced and
        cleaner fossil-fuel technology, and promoting investment in energy
        infrastructure and clean energy technology.<p>**Company-Level Issue
        Examples** *- Green Buildings, Renewable Energy, Unethical Utility
        Pricing.*|

        |**GOAL8DECENTWORKANDECONOMICGROWTH**|**Decent Work and Economic
        Growth** - Goal 8 focuses on economic productivity and supports policies
        for entrepreneurship, creativity and innovation that assist micro,
        small, and medium-sized enterprises. The Goal also seeks to reduce
        unemployment, the proportion of youth not working or in school, child
        labor, and forced labor. Also covered are the protection of labor
        rights, migrant workers, safe and secure working environments,
        sustainable tourism, and increasing the capacity of domestic financial
        institutions in regards to access to banking, insurance, and financial
        services.<p>**Company-Level Issue Examples** *-  Job Creation, Labor
        Exploitation, Employee Health and Safety, Workplace Turnover, Supplier
        Transparency.*|

        |**GOAL9INDUSTRYINNOVATIONANDINFRASTRUCTURE**|**Industry Innovation and
        Infrastructure** - Goal 9 focuses on three important aspects of
        sustainable development, infrastructure, industrialization and
        innovation, including considerations for resiliency, equity, quality,
        reliability, access and affordability, and regional and transborder
        infrastructure. The Goal focuses on infrastructure upgrades and
        retrofitting of industries with increased resource-use efficiency and
        clean and environmentally sound technologies and industrial
        processes.<p>**Company-Level Issue Examples** *- Digital Divide, ESG
        integration in financial services, Engineering Structural Integrity.*|

        |**GOAL10REDUCEDINEQUALITIES**|**Reduced Inequalities** - Goal 10 calls
        for reducing inequalities in income as well as those based on age, sex,
        disability, race, ethnicity, origin, religion, or economic or other
        status within a country. The Goal addresses inequalities among
        countries, including those related to representation, migration, and
        development assistance. It aims to empower and promote social, economic,
        and political inclusion of all. The Goal stresses regulation and
        monitoring of global financial markets and
        institutions.<p>**Company-Level Issue Examples** *- Responsible Lending,
        Worker Discrimination, CEO Pay Gap, Worker Pay Gap, Workplace Diversity
        and Inclusion.*|

        |**GOAL11SUSTAINABLECITIESANDCOMMUNITIES**|**Sustainable Cities and
        Communities** - Goal 11 seeks to ensure access for all to adequate,
        safe, and affordable housing and basic services, and green and public
        spaces, and to upgrade slums. It focuses on improving transportation,
        air quality and municipal and other waste management, and creating
        inclusive and sustainable urbanization through participatory urban
        planning. The Goal also supports safeguarding the world's cultural and
        natural heritage, while aiming to increase the number of cities and
        human settlements adopting and implementing integrated policies and
        plans towards inclusion, resource efficiency, mitigation and adaptation
        to climate change, and resilience to disasters.<p>**Company-Level Issue
        Examples** *- Air Pollution, Environmental Justice, Human Rights
        Violations, Affordable Housing.*|

        |**GOAL12RESPONSIBLECONSUMPTIONANDPRODUCTION**|**Responsible Consumption
        and Production** - Goal 12 aims to achieve the sustainable management
        and efficient use of natural resources through both the public and
        private sector. It specifically addresses global food waste in
        consumption, production, and distribution, sustainable tourism, waste
        and chemicals management. Goal 12 encourages sustainability reporting in
        the private sector, while in the public sector it encourages
        restructuring taxation and subsidies for fossil fuels and promoting
        sustainable public procurement practices.<p>**Company-Level Issue
        Examples** *- Sustainability Reporting, Circular Economy, Hazardous
        Waste Management, Waste Reduction.*|

        |**GOAL13CLIMATEACTION**|**Climate Action** - While Goal 13 is focused
        on actions by countries towards climate mitigation and adaptation, the
        private sector can also play a role in these areas. The goal seeks to
        strengthen resilience and adaptive capacity to climate-related hazards
        and natural disasters in all countries. It calls for integrating climate
        change measures, including those related to climate resilience and low
        GHG development, into national policies, strategies, and planning. It
        aims to improve education and awareness of climate change mitigation,
        adaptation, impact reduction, and early warning.<p>**Company-Level Issue
        Examples** *- GHG Emissions, Sustainable Transportation, Physical
        Climate Impacts.*|

        |**GOAL14LIFEBELOWWATER**|**Life Below Water** - Goal 14 focuses on
        preventing marine pollution of all kinds, particularly from land-based
        activities, and to minimize and address the impacts of ocean
        acidification. The Goal also aims to achieve sustainable yields in
        fisheries, through regulation of harvesting, controlling subsidies, and
        ending overfishing. It seeks to sustainably manage and protect marine
        and coastal ecosystems to avoid significant adverse impacts, including
        by strengthening their resilience, and take action for their restoration
        in order to achieve healthy and productive oceans.<p>**Company-Level
        Issue Examples** *- Impacts on water-related endangered species and
        habitats, Oil Spills, Seafood Sourcing.*|

        |**GOAL15LIFEONLAND**|**Life On Land** - Goal 15 seeks to ensure the
        conservation, restoration, and sustainable use of terrestrial and inland
        freshwater ecosystems and their services, in order to preserve
        biodiversity. It focuses specifically on sustainably managing forests,
        halting deforestation, restoring degraded lands and successfully
        combating desertification, reducing degraded natural habitats and ending
        biodiversity loss, with an emphasis on threatened species and invasive
        alien species.<p>**Company-Level Issue Examples** *- Impacts on
        land-related endangered species and habitats, Sustainable forestry
        practices and certifications, Project lifecycle environmental impacts.*|

        |**GOAL16PEACEJUSTICEANDSTRONGINSTITUTIONS**|**Peace, Justice, and
        Strong Institutions** - Goal 16 aims to significantly reduce all forms
        of violence, and also focuses specifically on reducing violence against
        children in the forms of abuse, exploitation, trafficking, and torture.
        It also aims to significantly reduce illicit financial and arms flows
        and to substantially reduce corruption and bribery in all their forms.
        The Goal also emphasizes effective and transparent institutions at all
        levels, inclusive and participatory decision-making, ensuring public
        access to information, and protection of fundamental
        freedoms.<p>**Company-Level Issue Examples** *- Tax Avoidance,
        Anti-Competitive Behavior, Cyber Security, Corruption, ESG
        Resolutions.*|
      example: IMPACT
    sdgSpotlightCategories:
      name: categories
      in: query
      schema:
        type: array
        default:
          - IMPACT
        items:
          type: string
      required: false
      explode: false
      description: >
        The SDG Categories specified for the Truvalue Scores being requested. To
        specify select categories returned in the response, provide a
        comma-separated list of the scores using the description below.


        |**SDG Category Input**|**Description**|

        |||

        |**IMPACT**|**Impact** - The aggregate SDG score for each company is
        simply named "Impact." The SDG Impact Score is produced using a weighted
        average of individual category scores, where the weight utilized is the
        category score volume.|

        |**GOAL1NOPOVERTY**|**No Poverty** - Goal 1 focuses on poverty in all
        its manifestations and also aims to ensure social protection for the
        poor and vulnerable, increase access to basic services and support
        people harmed by climate related extreme events and other economic,
        social and environmental shocks and disasters. <p>**Company-Level Issue
        Examples** *- Financial services access and affordability, Underserved
        groups,Unethical pricing.*|

        |**GOAL2ZEROHUNGER**|**Zero Hunger** - Goal 2 aims to end hunger and all
        forms of malnutrition and commits to universal access to safe,
        nutritious and sufficient food at all times of the year, particularly
        for the poor and people in vulnerable situations (e.g., infants). This
        will require sustainable food production systems and resilient
        agricultural practices, equal access to land, technology, and markets
        and international cooperation on investments in infrastructure and
        technology to boost agricultural productivity. <p>**Company-Level Issue
        Examples** *- Sustainable agricultural practices, Agricultural
        ingredients sourcing and certifications, Food safety concerns, Animal
        welfare.*|

        |**GOAL3GOODHEALTHANDWELLBEING**|**Good Health and Wellbeing** - Goal 3
        seeks to ensure health and wellbeing for all, at every stage of life and
        addresses all major health priorities, including reproductive, maternal,
        and child health; communicable, noncommunicable and environmental
        diseases; universal health coverage; and access for all to safe,
        effective, quality, and affordable medicines and vaccines.<p>
        **Company-Level Issue Examples** *- Harmful Chemicals in Products,
        Product Recalls, Healthcare Access and Affordability.*|

        |**GOAL4QUALITYEDUCATION**|**Quality Education** - Goal 4 addresses
        access and affordability of education and skills development starting
        from childhood development and continuing through adulthood, including
        for girls, persons with disabilities, indigenous peoples and children in
        vulnerable situations, Improvements to the access to education it hopes
        to ensure that all youth and a substantial proportion of adults achieve
        literacy and numeracy. It also seeks to build and upgrade education
        facilities and to increase the supply of qualified
        teachers.<p>**Company-Level Issue Examples** *- Mentorship and training,
        Education company quality, Education company ethics.*|

        |**GOAL5GENDEREQUALITY**|**Gender Equality** - Goal 5 emphasizes
        eliminating discrimination and violence against women and girls. The
        Goal emphasizes ensuring women's full and effective participation and
        equal opportunities for leadership at all levels of decision-making in
        political, economic and public life. Access to sexual and reproductive
        health and reproductive rights and access to economic resources (e.g.,
        land ownership, financial services) are also
        emphasized.<p>**Company-Level Issue Examples** *- Board Diversity,
        Gender Discrimination, Sexual Harassment.*|

        |**GOAL6CLEANWATERANDSANITATION**|**Clean Water and Sanitation** - Goal
        6 not only addresses issues relating to drinking water, sanitation and
        hygiene, but also the quality and sustainability of water resources
        worldwide. It strives to achieve universal and equitable access to safe
        and affordable drinking water for all. It also focuses on adequate and
        equitable sanitation and hygiene and reducing pollution, minimizing
        release of hazardous chemicals and materials, and protection of
        water-related ecosystems. It also highlights increasing water-use
        efficiency across all sectors, recycling, and ensuring sustainable
        withdrawals and supply of freshwater.<p>**Company-Level Issue Examples**
        *- Water Pollution, Water Recycling and Stewardship, Water
        Infrastructure.*|

        |**GOAL7AFFORDABLEANDCLEANENERGY**|**Goal 7 Affordable and Clean
        Energy** - Goal 7 seeks to ensure access to affordable, reliable, and
        modern energy services for all. It aims to increase renewable energy in
        the global energy mix and improve energy efficiency significantly. It
        also calls for more access to clean energy research, technology, and
        infrastructure for renewable energy, energy efficiency, and advanced and
        cleaner fossil-fuel technology, and promoting investment in energy
        infrastructure and clean energy technology.<p>**Company-Level Issue
        Examples** *- Green Buildings, Renewable Energy, Unethical Utility
        Pricing.*|

        |**GOAL8DECENTWORKANDECONOMICGROWTH**|**Decent Work and Economic
        Growth** - Goal 8 focuses on economic productivity and supports policies
        for entrepreneurship, creativity and innovation that assist micro,
        small, and medium-sized enterprises. The Goal also seeks to reduce
        unemployment, the proportion of youth not working or in school, child
        labor, and forced labor. Also covered are the protection of labor
        rights, migrant workers, safe and secure working environments,
        sustainable tourism, and increasing the capacity of domestic financial
        institutions in regards to access to banking, insurance, and financial
        services.<p>**Company-Level Issue Examples** *-  Job Creation, Labor
        Exploitation, Employee Health and Safety, Workplace Turnover, Supplier
        Transparency.*|

        |**GOAL9INDUSTRYINNOVATIONANDINFRASTRUCTURE**|**Industry Innovation and
        Infrastructure** - Goal 9 focuses on three important aspects of
        sustainable development, infrastructure, industrialization and
        innovation, including considerations for resiliency, equity, quality,
        reliability, access and affordability, and regional and transborder
        infrastructure. The Goal focuses on infrastructure upgrades and
        retrofitting of industries with increased resource-use efficiency and
        clean and environmentally sound technologies and industrial
        processes.<p>**Company-Level Issue Examples** *- Digital Divide, ESG
        integration in financial services, Engineering Structural Integrity.*|

        |**GOAL10REDUCEDINEQUALITIES**|**Reduced Inequalities** - Goal 10 calls
        for reducing inequalities in income as well as those based on age, sex,
        disability, race, ethnicity, origin, religion, or economic or other
        status within a country. The Goal addresses inequalities among
        countries, including those related to representation, migration, and
        development assistance. It aims to empower and promote social, economic,
        and political inclusion of all. The Goal stresses regulation and
        monitoring of global financial markets and
        institutions.<p>**Company-Level Issue Examples** *- Responsible Lending,
        Worker Discrimination, CEO Pay Gap, Worker Pay Gap, Workplace Diversity
        and Inclusion.*|

        |**GOAL11SUSTAINABLECITIESANDCOMMUNITIES**|**Sustainable Cities and
        Communities** - Goal 11 seeks to ensure access for all to adequate,
        safe, and affordable housing and basic services, and green and public
        spaces, and to upgrade slums. It focuses on improving transportation,
        air quality and municipal and other waste management, and creating
        inclusive and sustainable urbanization through participatory urban
        planning. The Goal also supports safeguarding the world's cultural and
        natural heritage, while aiming to increase the number of cities and
        human settlements adopting and implementing integrated policies and
        plans towards inclusion, resource efficiency, mitigation and adaptation
        to climate change, and resilience to disasters.<p>**Company-Level Issue
        Examples** *- Air Pollution, Environmental Justice, Human Rights
        Violations, Affordable Housing.*|

        |**GOAL12RESPONSIBLECONSUMPTIONANDPRODUCTION**|**Responsible Consumption
        and Production** - Goal 12 aims to achieve the sustainable management
        and efficient use of natural resources through both the public and
        private sector. It specifically addresses global food waste in
        consumption, production, and distribution, sustainable tourism, waste
        and chemicals management. Goal 12 encourages sustainability reporting in
        the private sector, while in the public sector it encourages
        restructuring taxation and subsidies for fossil fuels and promoting
        sustainable public procurement practices.<p>**Company-Level Issue
        Examples** *- Sustainability Reporting, Circular Economy, Hazardous
        Waste Management, Waste Reduction.*|

        |**GOAL13CLIMATEACTION**|**Climate Action** - While Goal 13 is focused
        on actions by countries towards climate mitigation and adaptation, the
        private sector can also play a role in these areas. The goal seeks to
        strengthen resilience and adaptive capacity to climate-related hazards
        and natural disasters in all countries. It calls for integrating climate
        change measures, including those related to climate resilience and low
        GHG development, into national policies, strategies, and planning. It
        aims to improve education and awareness of climate change mitigation,
        adaptation, impact reduction, and early warning.<p>**Company-Level Issue
        Examples** *- GHG Emissions, Sustainable Transportation, Physical
        Climate Impacts.*|

        |**GOAL14LIFEBELOWWATER**|**Life Below Water** - Goal 14 focuses on
        preventing marine pollution of all kinds, particularly from land-based
        activities, and to minimize and address the impacts of ocean
        acidification. The Goal also aims to achieve sustainable yields in
        fisheries, through regulation of harvesting, controlling subsidies, and
        ending overfishing. It seeks to sustainably manage and protect marine
        and coastal ecosystems to avoid significant adverse impacts, including
        by strengthening their resilience, and take action for their restoration
        in order to achieve healthy and productive oceans.<p>**Company-Level
        Issue Examples** *- Impacts on water-related endangered species and
        habitats, Oil Spills, Seafood Sourcing.*|

        |**GOAL15LIFEONLAND**|**Life On Land** - Goal 15 seeks to ensure the
        conservation, restoration, and sustainable use of terrestrial and inland
        freshwater ecosystems and their services, in order to preserve
        biodiversity. It focuses specifically on sustainably managing forests,
        halting deforestation, restoring degraded lands and successfully
        combating desertification, reducing degraded natural habitats and ending
        biodiversity loss, with an emphasis on threatened species and invasive
        alien species.<p>**Company-Level Issue Examples** *- Impacts on
        land-related endangered species and habitats, Sustainable forestry
        practices and certifications, Project lifecycle environmental impacts.*|

        |**GOAL16PEACEJUSTICEANDSTRONGINSTITUTIONS**|**Peace, Justice, and
        Strong Institutions** - Goal 16 aims to significantly reduce all forms
        of violence, and also focuses specifically on reducing violence against
        children in the forms of abuse, exploitation, trafficking, and torture.
        It also aims to significantly reduce illicit financial and arms flows
        and to substantially reduce corruption and bribery in all their forms.
        The Goal also emphasizes effective and transparent institutions at all
        levels, inclusive and participatory decision-making, ensuring public
        access to information, and protection of fundamental
        freedoms.<p>**Company-Level Issue Examples** *- Tax Avoidance,
        Anti-Competitive Behavior, Cyber Security, Corruption, ESG
        Resolutions.*|
      example: IMPACT
    sdgArticlesCategories:
      name: categories
      in: query
      schema:
        type: array
        default:
          - IMPACT
        items:
          type: string
      required: false
      explode: false
      description: >
        The SDG Categories specified for the Truvalue Scores being requested. To
        specify select categories returned in the response, provide a
        comma-separated list of the scores using the description below.


        |**SDG Category Input**|**Description**|

        |||

        |**IMPACT**|**Impact** - Provides Articles tagged to all SDG categories|

        |**GOAL1NOPOVERTY**|**No Poverty** - Goal 1 focuses on poverty in all
        its manifestations and also aims to ensure social protection for the
        poor and vulnerable, increase access to basic services and support
        people harmed by climate related extreme events and other economic,
        social and environmental shocks and disasters. <p>**Company-Level Issue
        Examples** *- Financial services access and affordability, Underserved
        groups,Unethical pricing.*|

        |**GOAL2ZEROHUNGER**|**Zero Hunger** - Goal 2 aims to end hunger and all
        forms of malnutrition and commits to universal access to safe,
        nutritious and sufficient food at all times of the year, particularly
        for the poor and people in vulnerable situations (e.g., infants). This
        will require sustainable food production systems and resilient
        agricultural practices, equal access to land, technology, and markets
        and international cooperation on investments in infrastructure and
        technology to boost agricultural productivity. <p>**Company-Level Issue
        Examples** *- Sustainable agricultural practices, Agricultural
        ingredients sourcing and certifications, Food safety concerns, Animal
        welfare.*|

        |**GOAL3GOODHEALTHANDWELLBEING**|**Good Health and Wellbeing** - Goal 3
        seeks to ensure health and wellbeing for all, at every stage of life and
        addresses all major health priorities, including reproductive, maternal,
        and child health; communicable, noncommunicable and environmental
        diseases; universal health coverage; and access for all to safe,
        effective, quality, and affordable medicines and vaccines.<p>
        **Company-Level Issue Examples** *- Harmful Chemicals in Products,
        Product Recalls, Healthcare Access and Affordability.*|

        |**GOAL4QUALITYEDUCATION**|**Quality Education** - Goal 4 addresses
        access and affordability of education and skills development starting
        from childhood development and continuing through adulthood, including
        for girls, persons with disabilities, indigenous peoples and children in
        vulnerable situations, Improvements to the access to education it hopes
        to ensure that all youth and a substantial proportion of adults achieve
        literacy and numeracy. It also seeks to build and upgrade education
        facilities and to increase the supply of qualified
        teachers.<p>**Company-Level Issue Examples** *- Mentorship and training,
        Education company quality, Education company ethics.*|

        |**GOAL5GENDEREQUALITY**|**Gender Equality** - Goal 5 emphasizes
        eliminating discrimination and violence against women and girls. The
        Goal emphasizes ensuring women's full and effective participation and
        equal opportunities for leadership at all levels of decision-making in
        political, economic and public life. Access to sexual and reproductive
        health and reproductive rights and access to economic resources (e.g.,
        land ownership, financial services) are also
        emphasized.<p>**Company-Level Issue Examples** *- Board Diversity,
        Gender Discrimination, Sexual Harassment.*|

        |**GOAL6CLEANWATERANDSANITATION**|**Clean Water and Sanitation** - Goal
        6 not only addresses issues relating to drinking water, sanitation and
        hygiene, but also the quality and sustainability of water resources
        worldwide. It strives to achieve universal and equitable access to safe
        and affordable drinking water for all. It also focuses on adequate and
        equitable sanitation and hygiene and reducing pollution, minimizing
        release of hazardous chemicals and materials, and protection of
        water-related ecosystems. It also highlights increasing water-use
        efficiency across all sectors, recycling, and ensuring sustainable
        withdrawals and supply of freshwater.<p>**Company-Level Issue Examples**
        *- Water Pollution, Water Recycling and Stewardship, Water
        Infrastructure.*|

        |**GOAL7AFFORDABLEANDCLEANENERGY**|**Goal 7 Affordable and Clean
        Energy** - Goal 7 seeks to ensure access to affordable, reliable, and
        modern energy services for all. It aims to increase renewable energy in
        the global energy mix and improve energy efficiency significantly. It
        also calls for more access to clean energy research, technology, and
        infrastructure for renewable energy, energy efficiency, and advanced and
        cleaner fossil-fuel technology, and promoting investment in energy
        infrastructure and clean energy technology.<p>**Company-Level Issue
        Examples** *- Green Buildings, Renewable Energy, Unethical Utility
        Pricing.*|

        |**GOAL8DECENTWORKANDECONOMICGROWTH**|**Decent Work and Economic
        Growth** - Goal 8 focuses on economic productivity and supports policies
        for entrepreneurship, creativity and innovation that assist micro,
        small, and medium-sized enterprises. The Goal also seeks to reduce
        unemployment, the proportion of youth not working or in school, child
        labor, and forced labor. Also covered are the protection of labor
        rights, migrant workers, safe and secure working environments,
        sustainable tourism, and increasing the capacity of domestic financial
        institutions in regards to access to banking, insurance, and financial
        services.<p>**Company-Level Issue Examples** *-  Job Creation, Labor
        Exploitation, Employee Health and Safety, Workplace Turnover, Supplier
        Transparency.*|

        |**GOAL9INDUSTRYINNOVATIONANDINFRASTRUCTURE**|**Industry Innovation and
        Infrastructure** - Goal 9 focuses on three important aspects of
        sustainable development, infrastructure, industrialization and
        innovation, including considerations for resiliency, equity, quality,
        reliability, access and affordability, and regional and transborder
        infrastructure. The Goal focuses on infrastructure upgrades and
        retrofitting of industries with increased resource-use efficiency and
        clean and environmentally sound technologies and industrial
        processes.<p>**Company-Level Issue Examples** *- Digital Divide, ESG
        integration in financial services, Engineering Structural Integrity.*|

        |**GOAL10REDUCEDINEQUALITIES**|**Reduced Inequalities** - Goal 10 calls
        for reducing inequalities in income as well as those based on age, sex,
        disability, race, ethnicity, origin, religion, or economic or other
        status within a country. The Goal addresses inequalities among
        countries, including those related to representation, migration, and
        development assistance. It aims to empower and promote social, economic,
        and political inclusion of all. The Goal stresses regulation and
        monitoring of global financial markets and
        institutions.<p>**Company-Level Issue Examples** *- Responsible Lending,
        Worker Discrimination, CEO Pay Gap, Worker Pay Gap, Workplace Diversity
        and Inclusion.*|

        |**GOAL11SUSTAINABLECITIESANDCOMMUNITIES**|**Sustainable Cities and
        Communities** - Goal 11 seeks to ensure access for all to adequate,
        safe, and affordable housing and basic services, and green and public
        spaces, and to upgrade slums. It focuses on improving transportation,
        air quality and municipal and other waste management, and creating
        inclusive and sustainable urbanization through participatory urban
        planning. The Goal also supports safeguarding the world's cultural and
        natural heritage, while aiming to increase the number of cities and
        human settlements adopting and implementing integrated policies and
        plans towards inclusion, resource efficiency, mitigation and adaptation
        to climate change, and resilience to disasters.<p>**Company-Level Issue
        Examples** *- Air Pollution, Environmental Justice, Human Rights
        Violations, Affordable Housing.*|

        |**GOAL12RESPONSIBLECONSUMPTIONANDPRODUCTION**|**Responsible Consumption
        and Production** - Goal 12 aims to achieve the sustainable management
        and efficient use of natural resources through both the public and
        private sector. It specifically addresses global food waste in
        consumption, production, and distribution, sustainable tourism, waste
        and chemicals management. Goal 12 encourages sustainability reporting in
        the private sector, while in the public sector it encourages
        restructuring taxation and subsidies for fossil fuels and promoting
        sustainable public procurement practices.<p>**Company-Level Issue
        Examples** *- Sustainability Reporting, Circular Economy, Hazardous
        Waste Management, Waste Reduction.*|

        |**GOAL13CLIMATEACTION**|**Climate Action** - While Goal 13 is focused
        on actions by countries towards climate mitigation and adaptation, the
        private sector can also play a role in these areas. The goal seeks to
        strengthen resilience and adaptive capacity to climate-related hazards
        and natural disasters in all countries. It calls for integrating climate
        change measures, including those related to climate resilience and low
        GHG development, into national policies, strategies, and planning. It
        aims to improve education and awareness of climate change mitigation,
        adaptation, impact reduction, and early warning.<p>**Company-Level Issue
        Examples** *- GHG Emissions, Sustainable Transportation, Physical
        Climate Impacts.*|

        |**GOAL14LIFEBELOWWATER**|**Life Below Water** - Goal 14 focuses on
        preventing marine pollution of all kinds, particularly from land-based
        activities, and to minimize and address the impacts of ocean
        acidification. The Goal also aims to achieve sustainable yields in
        fisheries, through regulation of harvesting, controlling subsidies, and
        ending overfishing. It seeks to sustainably manage and protect marine
        and coastal ecosystems to avoid significant adverse impacts, including
        by strengthening their resilience, and take action for their restoration
        in order to achieve healthy and productive oceans.<p>**Company-Level
        Issue Examples** *- Impacts on water-related endangered species and
        habitats, Oil Spills, Seafood Sourcing.*|

        |**GOAL15LIFEONLAND**|**Life On Land** - Goal 15 seeks to ensure the
        conservation, restoration, and sustainable use of terrestrial and inland
        freshwater ecosystems and their services, in order to preserve
        biodiversity. It focuses specifically on sustainably managing forests,
        halting deforestation, restoring degraded lands and successfully
        combating desertification, reducing degraded natural habitats and ending
        biodiversity loss, with an emphasis on threatened species and invasive
        alien species.<p>**Company-Level Issue Examples** *- Impacts on
        land-related endangered species and habitats, Sustainable forestry
        practices and certifications, Project lifecycle environmental impacts.*|

        |**GOAL16PEACEJUSTICEANDSTRONGINSTITUTIONS**|**Peace, Justice, and
        Strong Institutions** - Goal 16 aims to significantly reduce all forms
        of violence, and also focuses specifically on reducing violence against
        children in the forms of abuse, exploitation, trafficking, and torture.
        It also aims to significantly reduce illicit financial and arms flows
        and to substantially reduce corruption and bribery in all their forms.
        The Goal also emphasizes effective and transparent institutions at all
        levels, inclusive and participatory decision-making, ensuring public
        access to information, and protection of fundamental
        freedoms.<p>**Company-Level Issue Examples** *- Tax Avoidance,
        Anti-Competitive Behavior, Cyber Security, Corruption, ESG
        Resolutions.*|
      example: IMPACT
    sdgFrequency:
      name: frequency
      in: query
      schema:
        type: string
        enum:
          - D
          - W
          - M
          - CY
          - ''
        default: M
      description: |
        Controls the display frequency of the data returned.
          * **D** = Daily data (to receive most recent day's values, you must use daily frequency).
          * **W** = Weekly, End of week as of UTC Sunday at 12 AM.
          * **M** = Monthly, End of month as of UTC 12 AM.
          * **CY** = Yearly, End of year as of UTC 12 AM.
          
    fiscalPeriodStart:
      name: fiscalPeriodStart
      in: query
      schema:
        type: string
      description: >
        Fiscal period start is expressed in YYYY formats. The input start date
        must be before the input end date. Future dates (T+1) are not accepted
        in this endpoint.
      example: '2020'
    fiscalPeriodEnd:
      name: fiscalPeriodEnd
      in: query
      schema:
        type: string
      description: >
        Fiscal period end is expressed in YYYY formats. The input start date
        must be before the input end date. Future dates (T+1) are not accepted
        in this endpoint.
      example: '2021'
    indicators:
      name: indicators
      in: query
      schema:
        type: array
        default:
          - ALL
        items:
          type: string
      description: >
        The indicators are the Principal Adverse Impact (PAI) metrics which
        consists of General, Mandatory and Additional indicators which supports
        the SFDR reporting. 


        The General indicators data can retrieved by providing the `GL001` and
        `GL002` subTopic codes as input. Please refer to the attached
        documentation for the full list of subtopics codes and their mapping
        with the indicators.


        The data can also be requested for individual sub topic codes in
        addition to the indicators mentioned below -
          
        |**SFDR PAI Indicators**|**Description**|

        |||

        |**MandatoryIndicators**| Mandatory indicators are the indicators which
        must be reported under the EU Sustainable Finance Disclosure Regulation
        (SFDR).|

        |**AdditionalIndicators**| These are additional environmental and social
        indicators as mentioned in additional tables as provided in the Annex 1
        table in the SFDR RTS report.|

        |**GHGEmissions**| This mandatory indicator includes metrics related to
        greenhouse emissions such as - Scope 1, 2, and 3 emissions, footprint
        and intensity and energy consumption from non-renewable and high climate
        sectors.|

        |**Biodiversity**| This mandatory indicator includes metrics pertaining
        to biodiversity and a company's impacts on biodiversity-sensitive
        areas.|

        |**Water**| This mandatory indicator includes data relating to emissions
        to water as made by the companies.|

        |**Waste**| This mandatory indicator includes data relating to hazardous
        waste as generated by the companies.|

        |**SocialEmployeeMatters**| This mandatory indicator includes
        employee-related metrics like gender diversity, pay gap and
        social-related metrics like violation of UNGC/OECD principles and
        exposure to controversial weapons.|

        |**Emissions**| This additional indicator includes metrics related to
        air pollutants, inorganic pollutants and ozone depleting substance. |

        |**EnergyPerformance**| This additional indicator includes metrics
        related to various sources of non-renewable energy as used by the
        companies. |

        |**WaterWasteMaterialEmissions**| This mandatory indicator includes
        employee-related metrics like gender diversity, pay gap and
        social-related metrics like violation of UNGC/OECD principles and
        exposure to controversial weapons.|

        |**AdditionalEmployeeMatters**| This additional indicator includes
        metrics related to workplace discrimination and safety, whistleblower
        mechanism and supplier code of conduct.|

        |**HumanRights**| This additional indicator includes metrics related to
        both policies and performance of a company in the areas of human rights,
        forced labor and human trafficking.|

        |**AntiCorruptionAntiBribery**| This additional indicator includes data
        related to company violations of anti-corruption and anti-bribery laws,
        and resulting fines.|
      example:
        - Water
        - HumanRights
    calculation:
      name: calculation
      in: query
      schema:
        type: boolean
        default: true
      description: >
        This parameter would return the PAI data based on the input provided.
        All the data for indicators or subtopics requested are returned when the
        input is `true` and the SFDR required metrics are only returned when the
        input is`false`
    feelback:
      name: feelback
      in: query
      schema:
        type: boolean
        default: false
      description: >
        This parameter would return the latest PAI data based on the indicators
        or the subtopics requested. This parameter should not be used in
        conjuction with `fiscalPeriodStart` and `fiscalPeriodEnd` 
    primaryOnly:
      name: primaryOnly
      in: query
      schema:
        type: boolean
        default: true
      description: |
        This parameter would return only primary spotlights when set to `true`
    fieldsSdgSpotlights:
      name: fields
      in: query
      description: >
        Request available SDG Spotlights data fields to be included in the
        response.
         Default is all fields. _fsymId_,_orgId_, _date_, _spotlightId_, _groupId_ and _requestId_ are always included.
         
         <h3>Common Fields</h3> 
          |field|description|
          |||
          |fsymId|Factset Regional Security Identifier|
          |orgId|Unique identifier assigned by Truvalue that is applied on an organization level |
          |date|Date for the period requested in YYYY-MM-DD format.|
          |spotlightId|Unique identifier identifying a Spotlight ESG event that is detected at the company level, within a single category.|
          |groupId|Unique identifier  identifying a Spotlight group using the Spotlight ID of the Primary Spotlight.|
          |requestId|Identifier that was used for the request.|
         
         <h3>SDG Spotlights Fields</h3>
         
          |field|description|
          |-|-|
          |orgName|The current name of the organization according to Truvalue (not point-in-time)|
          |primarySpotlight|Value indicating the primary Spotlight in a Spotlight Group. It could be either "Yes" or "No".|
          |spotlightCategory|SDG category tagged to each Spotlight.| 
          |status|Indicates status of a spotlight, which can be one of Completed or Ongoing. |
          |removed|Displays the date a Spotlight was removed from the dataset, if it has been removed.| 
          |startDate|Date when a Spotlight has met the volume threshold for Spotlight consideration. Score and volume change metadata are associated with this date.|
          |liveDate|Date when a Spotlight meets confidence threshold and is considered a Spotlight. This date should never precede start_date. |          
          |firstArticleDate|Date of earliest article in the Spotlight as of the Start Date. |
          |finalArticleDate|Date of final article in the Spotlight. This value can change over the course of the Spotlight until the Spotlight is marked as completed.|    
          |organizationVolumeThreshold| The article volume needed to create a Spotlight, as set by the company's overall volume level classification on the Start Date. | 
          |totalSpotlightVolume|Total number of articles in the Spotlight. This number will change until the Spotlight is marked as completed.|          
          |startDateVolume|Number of articles in the Spotlight on the Start Date when it met the volume threshold. Does not include the number of articles that were added to the Spotlight after the Spotlight Start Date.|
          |primaryArticleSource|Source of the primary article.| 
          |primaryArticleUrl|URL of the primary article.|           
          |primaryArticleHeadline|Headline of primary Spotlight article.|          
          |primaryArticleBulletpoints|Bullet points summarizing the primary article. |
          |meanArtScoreFinalDate|Average score of articles in Spotlight on Final Article Date. This score will continue to change until the Spotlight is marked as completed.|   
          |meanArtScoreStartDate|Average score of articles in Spotlight on Start Date. This score will not change throughout the history of the spotlight.|          
          |meanPulseScore|Average of pulse scores for each day from First Article Date to Final Article Date, including scores for both Start Date and Final Article Date.|
          |pulseBeforeFirstArticle|Pulse score for category at end-of-day on day before the First Article Date. |           
          |pulseOnFinalArticleDate|Pulse score for category at the end-of-day on the Final Article Date.|          
          |pulseOnStartDate|Pulse score for the category at the end-of-day on the Start Date. |
          |zScoreOnFinalDate|Z-score for Spotlight as of Final Article Date. This score will continue to change until the Spotlight is marked as completed.|       
          |zScoreOnStartDate|Z-score for Spotlight as of Start Date. This score will not change throughout the history of the spotlight.|
          |standoutLvlOnFinalDate|Describes if the spotlight is a High, Medium, or Low standout spotlight.  This score will continue to change until the Spotlight is marked as completed.| 
          |standoutLvlOnStartDate|Describes if the spotlight is a High, Medium, or Low standout spotlight.|           
      explode: false
      schema:
        type: array
        items:
          type: string
    isRemoved:
      name: isRemoved
      in: query
      schema:
        type: boolean
        default: false
      description: >
        This parameter would return the spotlights removed in the response(i.e.
        Spotlight is marked as Rejected but has a firstApprovedOnDate))when set
        to `true`

        Only Spotlights that are marked as approved will be returned when set to
        `false`
  schemas:
    sasbScoresRequest:
      title: SASB Scores Request Body
      description: SASB Scores Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/ids'
        scoreTypes:
          $ref: '#/components/schemas/sasbScoreTypes'
        categories:
          $ref: '#/components/schemas/categories'
        startDate:
          $ref: '#/components/schemas/startDate'
        endDate:
          $ref: '#/components/schemas/endDate'
        frequency:
          $ref: '#/components/schemas/frequency'
        calendar:
          $ref: '#/components/schemas/calendar'
      required:
        - ids
    sasbScoresResponse:
      type: object
      title: SASB Scores Response
      properties:
        data:
          description: Array of SASB Scores Objects
          type: array
          items:
            $ref: '#/components/schemas/sasbScores'
    sasbScores:
      title: SASB Scores Object
      type: object
      properties:
        date:
          description: Date for the period requested expressed in YYYY-MM-DD format.
          type: string
          format: date
          example: '2020-09-30'
          nullable: true
        fsymId:
          description: >-
            FactSet Entity Identifier. Six alpha-numeric characters, excluding
            vowels, with a -E suffix (XXXXXX-E).
          type: string
          example: 000BJT-E
          nullable: true
        requestId:
          description: Identifier that was used for the request.
          type: string
          example: ADBE-US
        sasbCategory:
          description: The specific SASB 'category' the score is referring to.
          type: string
          example: AIRQUALITY
          nullable: true
        sasbScore:
          description: >-
            The SASB Score value for the given 'scoreType' and 'category'. When
            scoreType = ESG_RANK, the data type will be string, otherwise data
            type will be a number with double format.
          type: object
          example: 41.61229277
          nullable: true
        scoreType:
          description: >-
            The name of the specific SASB Score type being shown in the
            response. This will be represented by the scoreTypes input: PULSE,
            INSIGHT, MOMENTUM, ART_VOL_TTM, CAT_VOL_TTM, or DYNAMIC_MAT.
          type: string
          example: PULSE
          nullable: true
    sasbRanksRequest:
      title: SASB Scores Request Body
      description: SASB Scores Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/ids'
        categories:
          $ref: '#/components/schemas/rankCategories'
        startDate:
          $ref: '#/components/schemas/startDate'
        endDate:
          $ref: '#/components/schemas/endDate'
        frequency:
          $ref: '#/components/schemas/frequency'
        calendar:
          $ref: '#/components/schemas/calendar'
      required:
        - ids
    sasbRanksResponse:
      type: object
      title: SASB Ranks Response
      properties:
        data:
          description: Array of SASB Ranks Objects
          type: array
          items:
            $ref: '#/components/schemas/sasbRanks'
    sasbRanks:
      title: SASB Ranks Object
      type: object
      properties:
        date:
          description: Date for the period requested expressed in YYYY-MM-DD format.
          type: string
          format: date
          example: '2020-09-30'
          nullable: true
        fsymId:
          description: >-
            FactSet Entity Identifier. Six alpha-numeric characters, excluding
            vowels, with a -E suffix (XXXXXX-E).
          type: string
          example: 000BJT-E
          nullable: true
        requestId:
          description: Identifier that was used for the request.
          type: string
          example: ADBE-US
        sasbCategory:
          description: The specific SASB 'category' the Rank is referring to.
          type: string
          example: ALLCATEGORIES
          nullable: true
        sasbRank:
          description: |
            The SASB Rank for the given category in Proper format.
              |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|
          type: string
          example: Average
          nullable: true
    sasbScoresAllRequest:
      title: SASB Scores All Request Body
      description: SASB Scores All Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/ids'
        scoreTypes:
          $ref: '#/components/schemas/sasbScoreTypes'
        startDate:
          $ref: '#/components/schemas/startDate'
        endDate:
          $ref: '#/components/schemas/endDate'
        frequency:
          $ref: '#/components/schemas/frequency'
        calendar:
          $ref: '#/components/schemas/calendar'
      required:
        - ids
    sasbScoresAllResponse:
      type: object
      title: SASB Scores All Response
      properties:
        data:
          description: Array of SASB Scores All Objects
          type: array
          items:
            $ref: '#/components/schemas/sasbScoresAll'
    sasbScoresAll:
      title: SASB Scores All Object
      type: object
      properties:
        date:
          description: Date for the period requested expressed in YYYY-MM-DD format.
          type: string
          format: date
          example: '2020-09-30'
          nullable: true
        fsymId:
          description: >-
            FactSet Entity Identifier. Six alpha-numeric characters, excluding
            vowels, with a -E suffix (XXXXXX-E).
          type: string
          example: 001MF1-E
          nullable: true
        requestId:
          description: Identifier that was used for the request.
          type: string
          example: AMZN-US
        scoreType:
          description: >-
            The name of the specific SASB Score type being shown in the
            response. This will be represented by the scoreTypes input: PULSE,
            INSIGHT, MOMENTUM, ART_VOL_TTM, CAT_VOL_TTM, or DYNAMIC_MAT.
          type: string
          example: PULSE
          nullable: true
        accessAndAffordability:
          description: The Access and Affordability SASB Category.
          type: number
          format: double
          example: 42.0589785474386
          nullable: true
        airQuality:
          description: The Air Quality SASB Category.
          type: number
          format: double
          example: 29.8807816941901
          nullable: true
        allCategories:
          description: >-
            The All Categories Category. This represents the overall SASB Score
            for the given 'scoreType'. When scoreType = ESG_RANK, the data type
            will be string, otherwise data type will be a number with double
            format.
          type: object
          example: 49.1044372161141
          nullable: true
        businessEthics:
          description: The Business Ethics Category.
          type: number
          format: double
          example: 30.6074308481714
          nullable: true
        businessModelResilience:
          description: The Business Model Resilience Category.
          type: number
          format: double
          example: 41.8940425184173
          nullable: true
        competitiveBehavior:
          description: The Competitive Behavior Category.
          type: number
          format: double
          example: 32.5921215119197
          nullable: true
        criticalIncidentRiskManagement:
          description: The Critical Incident Risk Management Category.
          type: number
          format: double
          example: 45.3820575553375
          nullable: true
        customerPrivacy:
          description: The Customer Privacy Category.
          type: number
          format: double
          example: 54.9645092108536
          nullable: true
        customerWelfare:
          description: The Customer Welfare Category.
          type: number
          format: double
          example: 68.5579215857227
          nullable: true
        dataSecurity:
          description: The Data Security Category.
          type: number
          format: double
          example: 35.4099360664856
          nullable: true
        ecologicalImpacts:
          description: The Ecological Impacts Category.
          type: number
          format: double
          example: 51.5562478316789
          nullable: true
        employeeEngagementDiversityandInclusion:
          description: The Employee Engagement Diversity and Inclusion Category.
          type: number
          format: double
          example: 55.6395516005745
          nullable: true
        employeeHealthAndSafety:
          description: The Employee Health And Safety Category.
          type: number
          format: double
          example: 51.7344801598622
          nullable: true
        energyManagement:
          description: The Energy Management Category.
          type: number
          format: double
          example: 77.591147035024
          nullable: true
        gHGEmissions:
          description: The Greenhouse Gases Emissions Category.
          type: number
          format: double
          example: 56.9085694943306
          nullable: true
        humanRightsandCommunityRelations:
          description: The Human Rights and Community Relations Category.
          type: number
          format: double
          example: 46.5119869803688
          nullable: true
        laborPractices:
          description: The Labor Practices Category.
          type: number
          format: double
          example: 49.8005302032842
          nullable: true
        managementOfTheLegalAndRegulatoryEnvironment:
          description: The Management of the Legal and Regulatory Environment Category.
          type: number
          format: double
          example: 52.3487226050073
          nullable: true
        materialsSourcingAndEfficiency:
          description: The Materials Sourcing and Efficiency Category.
          type: number
          format: double
          example: 59.6849308135668
          nullable: true
        materiality:
          description: >-
            The Materiality Category. When scoreType = ESG_RANK, the data type
            will be string, otherwise data type will be a number with double
            format.
          type: object
          example: 51.6289633279129
          nullable: true
        physicalImpactsOfClimateChange:
          description: The Physical Impacts of Climate Change Category.
          type: number
          format: double
          example: 47.376430062074
          nullable: true
        productQualityAndSafety:
          description: The Product Quality and Safety Category.
          type: number
          format: double
          example: 47.5437583105162
          nullable: true
        productDesignAndLifecycleManagement:
          description: The Product Design And Lifecycle Management Category.
          type: number
          format: double
          example: 54.5033074297044
          nullable: true
        sellingPracticesAndProductLabeling:
          description: The Selling Practices And Product Labeling Category.
          type: number
          format: double
          example: 25.1319878766169
          nullable: true
        supplyChainManagement:
          description: The Supply Chain Management Category.
          type: number
          format: double
          example: 57.6323871116413
          nullable: true
        systemicRiskManagement:
          description: The Systemic Risk Management Category.
          type: number
          format: double
          example: 53.6422678837999
          nullable: true
        wasteAndHazardousMaterialsManagement:
          description: The Waste and Hazardous Materials Management Category.
          type: number
          format: double
          example: 56.551268737999
          nullable: true
        waterAndWastewaterManagement:
          description: The Water and Wastewater Management Category.
          type: number
          format: double
          example: 63.2635158281821
          nullable: true
    sdgScoresRequest:
      title: SDG Scores Request Body
      description: SDG Scores Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/tvlIds'
        scoreTypes:
          $ref: '#/components/schemas/sdgScoreTypes'
        categories:
          $ref: '#/components/schemas/sdgCategories'
        startDate:
          $ref: '#/components/schemas/sdgStartDate'
        endDate:
          $ref: '#/components/schemas/sdgEndDate'
        frequency:
          $ref: '#/components/schemas/sdgFrequency'
      required:
        - ids
    sdgScoresResponse:
      type: object
      title: SDG Scores Response
      properties:
        data:
          description: Array of SDG Scores Objects
          type: array
          items:
            $ref: '#/components/schemas/sdgScores'
    sdgScores:
      title: SDG Scores All Object
      type: object
      properties:
        date:
          description: Ending date for the period requested expressed in YYYY-MM-DD format.
          type: string
          format: date
          example: '2020-05-02'
          nullable: true
        fsymId:
          description: >-
            FactSet Entity Identifier. Six alpha-numeric characters, excluding
            vowels, with a -E suffix (XXXXXX-E).
          type: string
          example: 001MF1-E
          nullable: true
        requestId:
          description: Identifier that was used for the request.
          type: string
          example: US0231351067
        scoreType:
          description: >-
            The name of the specific SDG Score type being shown in the response.
            This will be represented by the scoreTypes input: PULSE, INSIGHT,
            MOMENTUM, ART_VOL_TTM, CAT_VOL_TTM, or DYNAMIC_MAT.
          type: string
          example: PULSE
          nullable: true
      additionalProperties: true
      required:
        - date
        - fsymId
        - requestId
        - scoreType
    sfdrPaiRequest:
      title: SFDR PAI Indicators Request Body
      description: SFDR PAI Indicators Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/paiIds'
        feelback:
          $ref: '#/components/schemas/feelback'
        fiscalPeriodStart:
          $ref: '#/components/schemas/fiscalPeriodStart'
        fiscalPeriodEnd:
          $ref: '#/components/schemas/fiscalPeriodEnd'
        indicators:
          $ref: '#/components/schemas/indicators'
        calculation:
          $ref: '#/components/schemas/calculation'
      required:
        - ids
    sfdrPaiResponse:
      type: object
      title: SFDR PAI Response
      properties:
        data:
          description: Array of SFDR PAI Response object
          type: array
          items:
            $ref: '#/components/schemas/sfdrPai'
    sfdrPai:
      title: SFDR PAI Indicators Response Object
      type: object
      properties:
        fsymId:
          description: >-
            FactSet Entity Identifier. Six alpha-numeric characters, excluding
            vowels, with a -E suffix (XXXXXX-E).
          type: string
          example: 001MF1-E
          nullable: true
        requestId:
          description: Identifier that was used for the request.
          type: string
          example: US0231351067
        subTopicCode:
          description: Codes for the General, Mandatory and Additional PAI indicators
          type: string
          example: EN001
          nullable: true
        subTopicName:
          description: Names for the General, Mandatory and Additional PAI indicators
          type: string
          example: Scope 1 GHG emissions
          nullable: true
        indicatorType:
          description: The type of indicator - General, Additional & Mandatory
          type: string
          example: Mandatory
          nullable: true
        periodEndDate:
          description: The Reporting period end date expressed in YYYY-MM-DD format
          type: string
          format: date
          example: '2020-09-26'
          nullable: true
        reportingPeriod:
          description: The reporting period of the company expressed in YYYY format
          type: string
          example: '2020'
          nullable: true
        standardizedUnit:
          description: The units of measurements for the indicators
          type: string
          example: Metric ton CO2 e
          nullable: true
        standardizedValue:
          description: >-
            The PAI calculations based on the company-reported data, some
            metrics sourced from Factset Databases and Truvalue SASB Spotlights
          type: string
          example: '9620000'
          nullable: true
    sasbSpotlightsRequest:
      title: SASB Spotlights Request Body
      description: SASB Spotlights Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/paiIds'
        categories:
          $ref: '#/components/schemas/sasbSpotlightsCategories'
        fields:
          $ref: '#/components/schemas/fieldsSasbSpotlights'
        startDate:
          $ref: '#/components/schemas/sdgStartDate'
        endDate:
          $ref: '#/components/schemas/sdgEndDate'
        primaryOnly:
          $ref: '#/components/schemas/primaryOnly'
        isRemoved:
          $ref: '#/components/schemas/isRemoved'
      required:
        - ids
    spotlightsResponse:
      type: object
      title: Spotlights Response
      properties:
        data:
          description: Array ofSpotlights Objects
          type: array
          items:
            $ref: '#/components/schemas/Spotlights'
    Spotlights:
      title: Spotlights All Object
      type: object
      properties:
        date:
          description: Ending date for the period requested expressed in YYYY-MM-DD format.
          type: string
          format: date
          example: '2020-05-02'
          nullable: true
        fsymId:
          description: >-
            FactSet Entity Identifier. Six alpha-numeric characters, excluding
            vowels, with a -E suffix (XXXXXX-E).
          type: string
          example: 001MF1-E
          nullable: true
        requestId:
          description: Identifier that was used for the request.
          type: string
          example: US0231351067
      additionalProperties: true
      required:
        - date
        - fsymId
        - requestId
    sdgSpotlightsRequest:
      title: SDG Spotlights Request Body
      description: SDG Spotlights Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/paiIds'
        startDate:
          $ref: '#/components/schemas/sdgStartDate'
        endDate:
          $ref: '#/components/schemas/sdgEndDate'
        categories:
          $ref: '#/components/schemas/sdgSpotlightCategories'
        fields:
          $ref: '#/components/schemas/fieldsSdgSpotlights'
        primaryOnly:
          $ref: '#/components/schemas/primaryOnly'
        isRemoved:
          $ref: '#/components/schemas/isRemoved'
      required:
        - ids
    sasbArticlesRequest:
      title: SASB Articles Request Body
      description: SASB Articles Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/paiIds'
        categories:
          $ref: '#/components/schemas/sasbArticlesCategories'
        fields:
          $ref: '#/components/schemas/articlesFields'
        startDate:
          $ref: '#/components/schemas/sdgStartDate'
        endDate:
          $ref: '#/components/schemas/sdgEndDate'
        dateOf:
          $ref: '#/components/schemas/dateOf'
      required:
        - ids
        - startDate
        - endDate
    sasbArticlesResponse:
      type: object
      title: Articles Response
      properties:
        data:
          description: Array of Articles Objects
          type: array
          items:
            $ref: '#/components/schemas/sasbArticle'
    sasbArticle:
      title: Articles All Object
      type: object
      properties:
        date:
          description: Date of article based on dateOf parameter
          type: string
          format: date
          example: '2020-05-02'
          nullable: true
        fsymId:
          description: >-
            FactSet Entity Identifier. Six alpha-numeric characters, excluding
            vowels, with a -E suffix (XXXXXX-E).
          type: string
          example: 001MF1-E
          nullable: true
        requestId:
          description: Identifier that was used for the request.
          type: string
          example: US0231351067
      additionalProperties: true
      required:
        - date
        - fsymId
        - requestId
    sdgArticlesRequest:
      title: SDG Articles Request Body
      description: SDG Articles Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/paiIds'
        categories:
          $ref: '#/components/schemas/sdgArticlesCategories'
        fields:
          $ref: '#/components/schemas/articlesFields'
        startDate:
          $ref: '#/components/schemas/sdgStartDate'
        endDate:
          $ref: '#/components/schemas/sdgEndDate'
        dateOf:
          $ref: '#/components/schemas/dateOf'
      required:
        - ids
        - startDate
        - endDate
    sdgArticlesResponse:
      type: object
      title: SDG Articles Response
      properties:
        data:
          description: Array of SDG Articles Objects
          type: array
          items:
            $ref: '#/components/schemas/sdgArticle'
    sdgArticle:
      title: Articles All Object
      type: object
      properties:
        date:
          description: Date of article based on dateOf parameter.
          type: string
          format: date
          example: '2020-05-02'
          nullable: true
        fsymId:
          description: >-
            FactSet Entity Identifier. Six alpha-numeric characters, excluding
            vowels, with a -E suffix (XXXXXX-E).
          type: string
          example: 001MF1-E
          nullable: true
        requestId:
          description: Identifier that was used for the request.
          type: string
          example: AAPL-US
      additionalProperties: true
      required:
        - date
        - fsymId
        - requestId
    tvlIds:
      type: array
      items:
        type: string
      minItems: 1
      maxItems: 1500
      description: >
        Security or Entity identifiers. FactSet Identifiers, tickers, CUSIP and
        SEDOL are accepted input. <p>***ids limit** =  1500 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 lead to exceeding this request line limit of
        8KB, its advised for any requests with large request lines to be
        requested through the respective "POST" method.</p>*
      example:
        - AAPL-USA
    paiIds:
      type: array
      items:
        type: string
      description: >
        Security or Entity identifiers. FactSet Identifiers, tickers, CUSIP and
        SEDOL are accepted input.  *<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 lead to exceeding
        this request line limit of 8KB, its advised for any requests with large
        request lines to be requested through the respective "POST" method.</p>*
      example:
        - AAPL-USA
    sdgCategories:
      type: array
      default:
        - IMPACT
      items:
        type: string
      description: >
        The SDG Categories specified for the Truvalue Scores being requested. To
        specify select categories returned in the response, provide a
        comma-separated list of the scores using the description below.


        |**SDG Category Input**|**Description**|

        |||

        |**IMPACT**|**Impact** - The aggregate SDG score for each company is
        simply named "Impact." The SDG Impact Score is produced using a weighted
        average of individual category scores, where the weight utilized is the
        category score volume.|

        |**IMPACTARTICLES**|**Impact Articles** - The All Goals Category Volume
        measures the total number of times any of the 16 goals received a score
        over a trailing twelve-month (TTM) period of time. **( Data wil be
        returned only for `TTM_VOLUME` score type)** |       

        |**GOAL1NOPOVERTY**|**No Poverty** - Goal 1 focuses on poverty in all
        its manifestations and also aims to ensure social protection for the
        poor and vulnerable, increase access to basic services and support
        people harmed by climate related extreme events and other economic,
        social and environmental shocks and disasters. <p>**Company-Level Issue
        Examples** *- Financial services access and affordability, Underserved
        groups,Unethical pricing.*|

        |**GOAL2ZEROHUNGER**|**Zero Hunger** - Goal 2 aims to end hunger and all
        forms of malnutrition and commits to universal access to safe,
        nutritious and sufficient food at all times of the year, particularly
        for the poor and people in vulnerable situations (e.g., infants). This
        will require sustainable food production systems and resilient
        agricultural practices, equal access to land, technology, and markets
        and international cooperation on investments in infrastructure and
        technology to boost agricultural productivity. <p>**Company-Level Issue
        Examples** *- Sustainable agricultural practices, Agricultural
        ingredients sourcing and certifications, Food safety concerns, Animal
        welfare.*|

        |**GOAL3GOODHEALTHANDWELLBEING**|**Good Health and Wellbeing** - Goal 3
        seeks to ensure health and wellbeing for all, at every stage of life and
        addresses all major health priorities, including reproductive, maternal,
        and child health; communicable, noncommunicable and environmental
        diseases; universal health coverage; and access for all to safe,
        effective, quality, and affordable medicines and vaccines.<p>
        **Company-Level Issue Examples** *- Harmful Chemicals in Products,
        Product Recalls, Healthcare Access and Affordability.*|

        |**GOAL4QUALITYEDUCATION**|**Quality Education** - Goal 4 addresses
        access and affordability of education and skills development starting
        from childhood development and continuing through adulthood, including
        for girls, persons with disabilities, indigenous peoples and children in
        vulnerable situations, Improvements to the access to education it hopes
        to ensure that all youth and a substantial proportion of adults achieve
        literacy and numeracy. It also seeks to build and upgrade education
        facilities and to increase the supply of qualified
        teachers.<p>**Company-Level Issue Examples** *- Mentorship and training,
        Education company quality, Education company ethics.*|

        |**GOAL5GENDEREQUALITY**|**Gender Equality** - Goal 5 emphasizes
        eliminating discrimination and violence against women and girls. The
        Goal emphasizes ensuring women's full and effective participation and
        equal opportunities for leadership at all levels of decision-making in
        political, economic and public life. Access to sexual and reproductive
        health and reproductive rights and access to economic resources (e.g.,
        land ownership, financial services) are also
        emphasized.<p>**Company-Level Issue Examples** *- Board Diversity,
        Gender Discrimination, Sexual Harassment.*|

        |**GOAL6CLEANWATERANDSANITATION**|**Clean Water and Sanitation** - Goal
        6 not only addresses issues relating to drinking water, sanitation and
        hygiene, but also the quality and sustainability of water resources
        worldwide. It strives to achieve universal and equitable access to safe
        and affordable drinking water for all. It also focuses on adequate and
        equitable sanitation and hygiene and reducing pollution, minimizing
        release of hazardous chemicals and materials, and protection of
        water-related ecosystems. It also highlights increasing water-use
        efficiency across all sectors, recycling, and ensuring sustainable
        withdrawals and supply of freshwater.<p>**Company-Level Issue Examples**
        *- Water Pollution, Water Recycling and Stewardship, Water
        Infrastructure.*|

        |**GOAL7AFFORDABLEANDCLEANENERGY**|**Goal 7 Affordable and Clean
        Energy** - Goal 7 seeks to ensure access to affordable, reliable, and
        modern energy services for all. It aims to increase renewable energy in
        the global energy mix and improve energy efficiency significantly. It
        also calls for more access to clean energy research, technology, and
        infrastructure for renewable energy, energy efficiency, and advanced and
        cleaner fossil-fuel technology, and promoting investment in energy
        infrastructure and clean energy technology.<p>**Company-Level Issue
        Examples** *- Green Buildings, Renewable Energy, Unethical Utility
        Pricing.*|

        |**GOAL8DECENTWORKANDECONOMICGROWTH**|**Decent Work and Economic
        Growth** - Goal 8 focuses on economic productivity and supports policies
        for entrepreneurship, creativity and innovation that assist micro,
        small, and medium-sized enterprises. The Goal also seeks to reduce
        unemployment, the proportion of youth not working or in school, child
        labor, and forced labor. Also covered are the protection of labor
        rights, migrant workers, safe and secure working environments,
        sustainable tourism, and increasing the capacity of domestic financial
        institutions in regards to access to banking, insurance, and financial
        services.<p>**Company-Level Issue Examples** *-  Job Creation, Labor
        Exploitation, Employee Health and Safety, Workplace Turnover, Supplier
        Transparency.*|

        |**GOAL9INDUSTRYINNOVATIONANDINFRASTRUCTURE**|**Industry Innovation and
        Infrastructure** - Goal 9 focuses on three important aspects of
        sustainable development, infrastructure, industrialization and
        innovation, including considerations for resiliency, equity, quality,
        reliability, access and affordability, and regional and transborder
        infrastructure. The Goal focuses on infrastructure upgrades and
        retrofitting of industries with increased resource-use efficiency and
        clean and environmentally sound technologies and industrial
        processes.<p>**Company-Level Issue Examples** *- Digital Divide, ESG
        integration in financial services, Engineering Structural Integrity.*|

        |**GOAL10REDUCEDINEQUALITIES**|**Reduced Inequalities** - Goal 10 calls
        for reducing inequalities in income as well as those based on age, sex,
        disability, race, ethnicity, origin, religion, or economic or other
        status within a country. The Goal addresses inequalities among
        countries, including those related to representation, migration, and
        development assistance. It aims to empower and promote social, economic,
        and political inclusion of all. The Goal stresses regulation and
        monitoring of global financial markets and
        institutions.<p>**Company-Level Issue Examples** *- Responsible Lending,
        Worker Discrimination, CEO Pay Gap, Worker Pay Gap, Workplace Diversity
        and Inclusion.*|

        |**GOAL11SUSTAINABLECITIESANDCOMMUNITIES**|**Sustainable Cities and
        Communities** - Goal 11 seeks to ensure access for all to adequate,
        safe, and affordable housing and basic services, and green and public
        spaces, and to upgrade slums. It focuses on improving transportation,
        air quality and municipal and other waste management, and creating
        inclusive and sustainable urbanization through participatory urban
        planning. The Goal also supports safeguarding the world's cultural and
        natural heritage, while aiming to increase the number of cities and
        human settlements adopting and implementing integrated policies and
        plans towards inclusion, resource efficiency, mitigation and adaptation
        to climate change, and resilience to disasters.<p>**Company-Level Issue
        Examples** *- Air Pollution, Environmental Justice, Human Rights
        Violations, Affordable Housing.*|

        |**GOAL12RESPONSIBLECONSUMPTIONANDPRODUCTION**|**Responsible Consumption
        and Production** - Goal 12 aims to achieve the sustainable management
        and efficient use of natural resources through both the public and
        private sector. It specifically addresses global food waste in
        consumption, production, and distribution, sustainable tourism, waste
        and chemicals management. Goal 12 encourages sustainability reporting in
        the private sector, while in the public sector it encourages
        restructuring taxation and subsidies for fossil fuels and promoting
        sustainable public procurement practices.<p>**Company-Level Issue
        Examples** *- Sustainability Reporting, Circular Economy, Hazardous
        Waste Management, Waste Reduction.*|

        |**GOAL13CLIMATEACTION**|**Climate Action** - While Goal 13 is focused
        on actions by countries towards climate mitigation and adaptation, the
        private sector can also play a role in these areas. The goal seeks to
        strengthen resilience and adaptive capacity to climate-related hazards
        and natural disasters in all countries. It calls for integrating climate
        change measures, including those related to climate resilience and low
        GHG development, into national policies, strategies, and planning. It
        aims to improve education and awareness of climate change mitigation,
        adaptation, impact reduction, and early warning.<p>**Company-Level Issue
        Examples** *- GHG Emissions, Sustainable Transportation, Physical
        Climate Impacts.*|

        |**GOAL14LIFEBELOWWATER**|**Life Below Water** - Goal 14 focuses on
        preventing marine pollution of all kinds, particularly from land-based
        activities, and to minimize and address the impacts of ocean
        acidification. The Goal also aims to achieve sustainable yields in
        fisheries, through regulation of harvesting, controlling subsidies, and
        ending overfishing. It seeks to sustainably manage and protect marine
        and coastal ecosystems to avoid significant adverse impacts, including
        by strengthening their resilience, and take action for their restoration
        in order to achieve healthy and productive oceans.<p>**Company-Level
        Issue Examples** *- Impacts on water-related endangered species and
        habitats, Oil Spills, Seafood Sourcing.*|

        |**GOAL15LIFEONLAND**|**Life On Land** - Goal 15 seeks to ensure the
        conservation, restoration, and sustainable use of terrestrial and inland
        freshwater ecosystems and their services, in order to preserve
        biodiversity. It focuses specifically on sustainably managing forests,
        halting deforestation, restoring degraded lands and successfully
        combating desertification, reducing degraded natural habitats and ending
        biodiversity loss, with an emphasis on threatened species and invasive
        alien species.<p>**Company-Level Issue Examples** *- Impacts on
        land-related endangered species and habitats, Sustainable forestry
        practices and certifications, Project lifecycle environmental impacts.*|

        |**GOAL16PEACEJUSTICEANDSTRONGINSTITUTIONS**|**Peace, Justice, and
        Strong Institutions** - Goal 16 aims to significantly reduce all forms
        of violence, and also focuses specifically on reducing violence against
        children in the forms of abuse, exploitation, trafficking, and torture.
        It also aims to significantly reduce illicit financial and arms flows
        and to substantially reduce corruption and bribery in all their forms.
        The Goal also emphasizes effective and transparent institutions at all
        levels, inclusive and participatory decision-making, ensuring public
        access to information, and protection of fundamental
        freedoms.<p>**Company-Level Issue Examples** *- Tax Avoidance,
        Anti-Competitive Behavior, Cyber Security, Corruption, ESG
        Resolutions.*|
      example:
        - IMPACT
        - GOAL1NOPOVERTY
    sdgSpotlightCategories:
      type: array
      default:
        - IMPACT
      items:
        type: string
      description: >
        The SDG Categories specified for the Truvalue Scores being requested. To
        specify select categories returned in the response, provide a
        comma-separated list of the scores using the description below.


        |**SDG Category Input**|**Description**|

        |||

        |**IMPACT**|**Impact** - The aggregate SDG score for each company is
        simply named "Impact." The SDG Impact Score is produced using a weighted
        average of individual category scores, where the weight utilized is the
        category score volume.|

        |**GOAL1NOPOVERTY**|**No Poverty** - Goal 1 focuses on poverty in all
        its manifestations and also aims to ensure social protection for the
        poor and vulnerable, increase access to basic services and support
        people harmed by climate related extreme events and other economic,
        social and environmental shocks and disasters. <p>**Company-Level Issue
        Examples** *- Financial services access and affordability, Underserved
        groups,Unethical pricing.*|

        |**GOAL2ZEROHUNGER**|**Zero Hunger** - Goal 2 aims to end hunger and all
        forms of malnutrition and commits to universal access to safe,
        nutritious and sufficient food at all times of the year, particularly
        for the poor and people in vulnerable situations (e.g., infants). This
        will require sustainable food production systems and resilient
        agricultural practices, equal access to land, technology, and markets
        and international cooperation on investments in infrastructure and
        technology to boost agricultural productivity. <p>**Company-Level Issue
        Examples** *- Sustainable agricultural practices, Agricultural
        ingredients sourcing and certifications, Food safety concerns, Animal
        welfare.*|

        |**GOAL3GOODHEALTHANDWELLBEING**|**Good Health and Wellbeing** - Goal 3
        seeks to ensure health and wellbeing for all, at every stage of life and
        addresses all major health priorities, including reproductive, maternal,
        and child health; communicable, noncommunicable and environmental
        diseases; universal health coverage; and access for all to safe,
        effective, quality, and affordable medicines and vaccines.<p>
        **Company-Level Issue Examples** *- Harmful Chemicals in Products,
        Product Recalls, Healthcare Access and Affordability.*|

        |**GOAL4QUALITYEDUCATION**|**Quality Education** - Goal 4 addresses
        access and affordability of education and skills development starting
        from childhood development and continuing through adulthood, including
        for girls, persons with disabilities, indigenous peoples and children in
        vulnerable situations, Improvements to the access to education it hopes
        to ensure that all youth and a substantial proportion of adults achieve
        literacy and numeracy. It also seeks to build and upgrade education
        facilities and to increase the supply of qualified
        teachers.<p>**Company-Level Issue Examples** *- Mentorship and training,
        Education company quality, Education company ethics.*|

        |**GOAL5GENDEREQUALITY**|**Gender Equality** - Goal 5 emphasizes
        eliminating discrimination and violence against women and girls. The
        Goal emphasizes ensuring women's full and effective participation and
        equal opportunities for leadership at all levels of decision-making in
        political, economic and public life. Access to sexual and reproductive
        health and reproductive rights and access to economic resources (e.g.,
        land ownership, financial services) are also
        emphasized.<p>**Company-Level Issue Examples** *- Board Diversity,
        Gender Discrimination, Sexual Harassment.*|

        |**GOAL6CLEANWATERANDSANITATION**|**Clean Water and Sanitation** - Goal
        6 not only addresses issues relating to drinking water, sanitation and
        hygiene, but also the quality and sustainability of water resources
        worldwide. It strives to achieve universal and equitable access to safe
        and affordable drinking water for all. It also focuses on adequate and
        equitable sanitation and hygiene and reducing pollution, minimizing
        release of hazardous chemicals and materials, and protection of
        water-related ecosystems. It also highlights increasing water-use
        efficiency across all sectors, recycling, and ensuring sustainable
        withdrawals and supply of freshwater.<p>**Company-Level Issue Examples**
        *- Water Pollution, Water Recycling and Stewardship, Water
        Infrastructure.*|

        |**GOAL7AFFORDABLEANDCLEANENERGY**|**Goal 7 Affordable and Clean
        Energy** - Goal 7 seeks to ensure access to affordable, reliable, and
        modern energy services for all. It aims to increase renewable energy in
        the global energy mix and improve energy efficiency significantly. It
        also calls for more access to clean energy research, technology, and
        infrastructure for renewable energy, energy efficiency, and advanced and
        cleaner fossil-fuel technology, and promoting investment in energy
        infrastructure and clean energy technology.<p>**Company-Level Issue
        Examples** *- Green Buildings, Renewable Energy, Unethical Utility
        Pricing.*|

        |**GOAL8DECENTWORKANDECONOMICGROWTH**|**Decent Work and Economic
        Growth** - Goal 8 focuses on economic productivity and supports policies
        for entrepreneurship, creativity and innovation that assist micro,
        small, and medium-sized enterprises. The Goal also seeks to reduce
        unemployment, the proportion of youth not working or in school, child
        labor, and forced labor. Also covered are the protection of labor
        rights, migrant workers, safe and secure working environments,
        sustainable tourism, and increasing the capacity of domestic financial
        institutions in regards to access to banking, insurance, and financial
        services.<p>**Company-Level Issue Examples** *-  Job Creation, Labor
        Exploitation, Employee Health and Safety, Workplace Turnover, Supplier
        Transparency.*|

        |**GOAL9INDUSTRYINNOVATIONANDINFRASTRUCTURE**|**Industry Innovation and
        Infrastructure** - Goal 9 focuses on three important aspects of
        sustainable development, infrastructure, industrialization and
        innovation, including considerations for resiliency, equity, quality,
        reliability, access and affordability, and regional and transborder
        infrastructure. The Goal focuses on infrastructure upgrades and
        retrofitting of industries with increased resource-use efficiency and
        clean and environmentally sound technologies and industrial
        processes.<p>**Company-Level Issue Examples** *- Digital Divide, ESG
        integration in financial services, Engineering Structural Integrity.*|

        |**GOAL10REDUCEDINEQUALITIES**|**Reduced Inequalities** - Goal 10 calls
        for reducing inequalities in income as well as those based on age, sex,
        disability, race, ethnicity, origin, religion, or economic or other
        status within a country. The Goal addresses inequalities among
        countries, including those related to representation, migration, and
        development assistance. It aims to empower and promote social, economic,
        and political inclusion of all. The Goal stresses regulation and
        monitoring of global financial markets and
        institutions.<p>**Company-Level Issue Examples** *- Responsible Lending,
        Worker Discrimination, CEO Pay Gap, Worker Pay Gap, Workplace Diversity
        and Inclusion.*|

        |**GOAL11SUSTAINABLECITIESANDCOMMUNITIES**|**Sustainable Cities and
        Communities** - Goal 11 seeks to ensure access for all to adequate,
        safe, and affordable housing and basic services, and green and public
        spaces, and to upgrade slums. It focuses on improving transportation,
        air quality and municipal and other waste management, and creating
        inclusive and sustainable urbanization through participatory urban
        planning. The Goal also supports safeguarding the world's cultural and
        natural heritage, while aiming to increase the number of cities and
        human settlements adopting and implementing integrated policies and
        plans towards inclusion, resource efficiency, mitigation and adaptation
        to climate change, and resilience to disasters.<p>**Company-Level Issue
        Examples** *- Air Pollution, Environmental Justice, Human Rights
        Violations, Affordable Housing.*|

        |**GOAL12RESPONSIBLECONSUMPTIONANDPRODUCTION**|**Responsible Consumption
        and Production** - Goal 12 aims to achieve the sustainable management
        and efficient use of natural resources through both the public and
        private sector. It specifically addresses global food waste in
        consumption, production, and distribution, sustainable tourism, waste
        and chemicals management. Goal 12 encourages sustainability reporting in
        the private sector, while in the public sector it encourages
        restructuring taxation and subsidies for fossil fuels and promoting
        sustainable public procurement practices.<p>**Company-Level Issue
        Examples** *- Sustainability Reporting, Circular Economy, Hazardous
        Waste Management, Waste Reduction.*|

        |**GOAL13CLIMATEACTION**|**Climate Action** - While Goal 13 is focused
        on actions by countries towards climate mitigation and adaptation, the
        private sector can also play a role in these areas. The goal seeks to
        strengthen resilience and adaptive capacity to climate-related hazards
        and natural disasters in all countries. It calls for integrating climate
        change measures, including those related to climate resilience and low
        GHG development, into national policies, strategies, and planning. It
        aims to improve education and awareness of climate change mitigation,
        adaptation, impact reduction, and early warning.<p>**Company-Level Issue
        Examples** *- GHG Emissions, Sustainable Transportation, Physical
        Climate Impacts.*|

        |**GOAL14LIFEBELOWWATER**|**Life Below Water** - Goal 14 focuses on
        preventing marine pollution of all kinds, particularly from land-based
        activities, and to minimize and address the impacts of ocean
        acidification. The Goal also aims to achieve sustainable yields in
        fisheries, through regulation of harvesting, controlling subsidies, and
        ending overfishing. It seeks to sustainably manage and protect marine
        and coastal ecosystems to avoid significant adverse impacts, including
        by strengthening their resilience, and take action for their restoration
        in order to achieve healthy and productive oceans.<p>**Company-Level
        Issue Examples** *- Impacts on water-related endangered species and
        habitats, Oil Spills, Seafood Sourcing.*|

        |**GOAL15LIFEONLAND**|**Life On Land** - Goal 15 seeks to ensure the
        conservation, restoration, and sustainable use of terrestrial and inland
        freshwater ecosystems and their services, in order to preserve
        biodiversity. It focuses specifically on sustainably managing forests,
        halting deforestation, restoring degraded lands and successfully
        combating desertification, reducing degraded natural habitats and ending
        biodiversity loss, with an emphasis on threatened species and invasive
        alien species.<p>**Company-Level Issue Examples** *- Impacts on
        land-related endangered species and habitats, Sustainable forestry
        practices and certifications, Project lifecycle environmental impacts.*|

        |**GOAL16PEACEJUSTICEANDSTRONGINSTITUTIONS**|**Peace, Justice, and
        Strong Institutions** - Goal 16 aims to significantly reduce all forms
        of violence, and also focuses specifically on reducing violence against
        children in the forms of abuse, exploitation, trafficking, and torture.
        It also aims to significantly reduce illicit financial and arms flows
        and to substantially reduce corruption and bribery in all their forms.
        The Goal also emphasizes effective and transparent institutions at all
        levels, inclusive and participatory decision-making, ensuring public
        access to information, and protection of fundamental
        freedoms.<p>**Company-Level Issue Examples** *- Tax Avoidance,
        Anti-Competitive Behavior, Cyber Security, Corruption, ESG
        Resolutions.*|
      example:
        - IMPACT
        - GOAL1NOPOVERTY
    sdgArticlesCategories:
      type: array
      default:
        - IMPACT
      items:
        type: string
      description: >
        The SDG Categories specified for the Truvalue Scores being requested. To
        specify select categories returned in the response, provide a
        comma-separated list of the scores using the description below.


        |**SDG Category Input**|**Description**|

        |||

        |**IMPACT**|**Impact** - Provides Articles tagged to all SDG categories|

        |**GOAL1NOPOVERTY**|**No Poverty** - Goal 1 focuses on poverty in all
        its manifestations and also aims to ensure social protection for the
        poor and vulnerable, increase access to basic services and support
        people harmed by climate related extreme events and other economic,
        social and environmental shocks and disasters. <p>**Company-Level Issue
        Examples** *- Financial services access and affordability, Underserved
        groups,Unethical pricing.*|

        |**GOAL2ZEROHUNGER**|**Zero Hunger** - Goal 2 aims to end hunger and all
        forms of malnutrition and commits to universal access to safe,
        nutritious and sufficient food at all times of the year, particularly
        for the poor and people in vulnerable situations (e.g., infants). This
        will require sustainable food production systems and resilient
        agricultural practices, equal access to land, technology, and markets
        and international cooperation on investments in infrastructure and
        technology to boost agricultural productivity. <p>**Company-Level Issue
        Examples** *- Sustainable agricultural practices, Agricultural
        ingredients sourcing and certifications, Food safety concerns, Animal
        welfare.*|

        |**GOAL3GOODHEALTHANDWELLBEING**|**Good Health and Wellbeing** - Goal 3
        seeks to ensure health and wellbeing for all, at every stage of life and
        addresses all major health priorities, including reproductive, maternal,
        and child health; communicable, noncommunicable and environmental
        diseases; universal health coverage; and access for all to safe,
        effective, quality, and affordable medicines and vaccines.<p>
        **Company-Level Issue Examples** *- Harmful Chemicals in Products,
        Product Recalls, Healthcare Access and Affordability.*|

        |**GOAL4QUALITYEDUCATION**|**Quality Education** - Goal 4 addresses
        access and affordability of education and skills development starting
        from childhood development and continuing through adulthood, including
        for girls, persons with disabilities, indigenous peoples and children in
        vulnerable situations, Improvements to the access to education it hopes
        to ensure that all youth and a substantial proportion of adults achieve
        literacy and numeracy. It also seeks to build and upgrade education
        facilities and to increase the supply of qualified
        teachers.<p>**Company-Level Issue Examples** *- Mentorship and training,
        Education company quality, Education company ethics.*|

        |**GOAL5GENDEREQUALITY**|**Gender Equality** - Goal 5 emphasizes
        eliminating discrimination and violence against women and girls. The
        Goal emphasizes ensuring women's full and effective participation and
        equal opportunities for leadership at all levels of decision-making in
        political, economic and public life. Access to sexual and reproductive
        health and reproductive rights and access to economic resources (e.g.,
        land ownership, financial services) are also
        emphasized.<p>**Company-Level Issue Examples** *- Board Diversity,
        Gender Discrimination, Sexual Harassment.*|

        |**GOAL6CLEANWATERANDSANITATION**|**Clean Water and Sanitation** - Goal
        6 not only addresses issues relating to drinking water, sanitation and
        hygiene, but also the quality and sustainability of water resources
        worldwide. It strives to achieve universal and equitable access to safe
        and affordable drinking water for all. It also focuses on adequate and
        equitable sanitation and hygiene and reducing pollution, minimizing
        release of hazardous chemicals and materials, and protection of
        water-related ecosystems. It also highlights increasing water-use
        efficiency across all sectors, recycling, and ensuring sustainable
        withdrawals and supply of freshwater.<p>**Company-Level Issue Examples**
        *- Water Pollution, Water Recycling and Stewardship, Water
        Infrastructure.*|

        |**GOAL7AFFORDABLEANDCLEANENERGY**|**Goal 7 Affordable and Clean
        Energy** - Goal 7 seeks to ensure access to affordable, reliable, and
        modern energy services for all. It aims to increase renewable energy in
        the global energy mix and improve energy efficiency significantly. It
        also calls for more access to clean energy research, technology, and
        infrastructure for renewable energy, energy efficiency, and advanced and
        cleaner fossil-fuel technology, and promoting investment in energy
        infrastructure and clean energy technology.<p>**Company-Level Issue
        Examples** *- Green Buildings, Renewable Energy, Unethical Utility
        Pricing.*|

        |**GOAL8DECENTWORKANDECONOMICGROWTH**|**Decent Work and Economic
        Growth** - Goal 8 focuses on economic productivity and supports policies
        for entrepreneurship, creativity and innovation that assist micro,
        small, and medium-sized enterprises. The Goal also seeks to reduce
        unemployment, the proportion of youth not working or in school, child
        labor, and forced labor. Also covered are the protection of labor
        rights, migrant workers, safe and secure working environments,
        sustainable tourism, and increasing the capacity of domestic financial
        institutions in regards to access to banking, insurance, and financial
        services.<p>**Company-Level Issue Examples** *-  Job Creation, Labor
        Exploitation, Employee Health and Safety, Workplace Turnover, Supplier
        Transparency.*|

        |**GOAL9INDUSTRYINNOVATIONANDINFRASTRUCTURE**|**Industry Innovation and
        Infrastructure** - Goal 9 focuses on three important aspects of
        sustainable development, infrastructure, industrialization and
        innovation, including considerations for resiliency, equity, quality,
        reliability, access and affordability, and regional and transborder
        infrastructure. The Goal focuses on infrastructure upgrades and
        retrofitting of industries with increased resource-use efficiency and
        clean and environmentally sound technologies and industrial
        processes.<p>**Company-Level Issue Examples** *- Digital Divide, ESG
        integration in financial services, Engineering Structural Integrity.*|

        |**GOAL10REDUCEDINEQUALITIES**|**Reduced Inequalities** - Goal 10 calls
        for reducing inequalities in income as well as those based on age, sex,
        disability, race, ethnicity, origin, religion, or economic or other
        status within a country. The Goal addresses inequalities among
        countries, including those related to representation, migration, and
        development assistance. It aims to empower and promote social, economic,
        and political inclusion of all. The Goal stresses regulation and
        monitoring of global financial markets and
        institutions.<p>**Company-Level Issue Examples** *- Responsible Lending,
        Worker Discrimination, CEO Pay Gap, Worker Pay Gap, Workplace Diversity
        and Inclusion.*|

        |**GOAL11SUSTAINABLECITIESANDCOMMUNITIES**|**Sustainable Cities and
        Communities** - Goal 11 seeks to ensure access for all to adequate,
        safe, and affordable housing and basic services, and green and public
        spaces, and to upgrade slums. It focuses on improving transportation,
        air quality and municipal and other waste management, and creating
        inclusive and sustainable urbanization through participatory urban
        planning. The Goal also supports safeguarding the world's cultural and
        natural heritage, while aiming to increase the number of cities and
        human settlements adopting and implementing integrated policies and
        plans towards inclusion, resource efficiency, mitigation and adaptation
        to climate change, and resilience to disasters.<p>**Company-Level Issue
        Examples** *- Air Pollution, Environmental Justice, Human Rights
        Violations, Affordable Housing.*|

        |**GOAL12RESPONSIBLECONSUMPTIONANDPRODUCTION**|**Responsible Consumption
        and Production** - Goal 12 aims to achieve the sustainable management
        and efficient use of natural resources through both the public and
        private sector. It specifically addresses global food waste in
        consumption, production, and distribution, sustainable tourism, waste
        and chemicals management. Goal 12 encourages sustainability reporting in
        the private sector, while in the public sector it encourages
        restructuring taxation and subsidies for fossil fuels and promoting
        sustainable public procurement practices.<p>**Company-Level Issue
        Examples** *- Sustainability Reporting, Circular Economy, Hazardous
        Waste Management, Waste Reduction.*|

        |**GOAL13CLIMATEACTION**|**Climate Action** - While Goal 13 is focused
        on actions by countries towards climate mitigation and adaptation, the
        private sector can also play a role in these areas. The goal seeks to
        strengthen resilience and adaptive capacity to climate-related hazards
        and natural disasters in all countries. It calls for integrating climate
        change measures, including those related to climate resilience and low
        GHG development, into national policies, strategies, and planning. It
        aims to improve education and awareness of climate change mitigation,
        adaptation, impact reduction, and early warning.<p>**Company-Level Issue
        Examples** *- GHG Emissions, Sustainable Transportation, Physical
        Climate Impacts.*|

        |**GOAL14LIFEBELOWWATER**|**Life Below Water** - Goal 14 focuses on
        preventing marine pollution of all kinds, particularly from land-based
        activities, and to minimize and address the impacts of ocean
        acidification. The Goal also aims to achieve sustainable yields in
        fisheries, through regulation of harvesting, controlling subsidies, and
        ending overfishing. It seeks to sustainably manage and protect marine
        and coastal ecosystems to avoid significant adverse impacts, including
        by strengthening their resilience, and take action for their restoration
        in order to achieve healthy and productive oceans.<p>**Company-Level
        Issue Examples** *- Impacts on water-related endangered species and
        habitats, Oil Spills, Seafood Sourcing.*|

        |**GOAL15LIFEONLAND**|**Life On Land** - Goal 15 seeks to ensure the
        conservation, restoration, and sustainable use of terrestrial and inland
        freshwater ecosystems and their services, in order to preserve
        biodiversity. It focuses specifically on sustainably managing forests,
        halting deforestation, restoring degraded lands and successfully
        combating desertification, reducing degraded natural habitats and ending
        biodiversity loss, with an emphasis on threatened species and invasive
        alien species.<p>**Company-Level Issue Examples** *- Impacts on
        land-related endangered species and habitats, Sustainable forestry
        practices and certifications, Project lifecycle environmental impacts.*|

        |**GOAL16PEACEJUSTICEANDSTRONGINSTITUTIONS**|**Peace, Justice, and
        Strong Institutions** - Goal 16 aims to significantly reduce all forms
        of violence, and also focuses specifically on reducing violence against
        children in the forms of abuse, exploitation, trafficking, and torture.
        It also aims to significantly reduce illicit financial and arms flows
        and to substantially reduce corruption and bribery in all their forms.
        The Goal also emphasizes effective and transparent institutions at all
        levels, inclusive and participatory decision-making, ensuring public
        access to information, and protection of fundamental
        freedoms.<p>**Company-Level Issue Examples** *- Tax Avoidance,
        Anti-Competitive Behavior, Cyber Security, Corruption, ESG
        Resolutions.*|
      example:
        - IMPACT
        - GOAL1NOPOVERTY
    sdgFrequency:
      type: string
      enum:
        - D
        - W
        - M
        - CY
        - ''
      default: M
      description: |
        Controls the display frequency of the data returned.
          * **D** = Daily data (to receive most recent day's values, you must use daily frequency). 
          * **W** = Weekly, End of week as of UTC Sunday at 12 AM. 
          * **M** = Monthly, End of month as of UTC 12 AM.
          * **CY** = Yearly, End of year as of UTC 12 AM.
    ids:
      type: array
      items:
        type: string
      minItems: 1
      maxItems: 1000
      description: >
        Security or Entity identifiers. FactSet Identifiers, tickers, CUSIP and
        SEDOL are accepted input. <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>*
      example:
        - AAPL-USA
    startDate:
      type: string
      description: >
        The start date requested for a given date range in **YYYY-MM-DD**
        format. Data is available on a Fiscal Annual periodicity, but updated
        Daily. If left blank, the API will default to previous close. Future
        dates (T+1) are not accepted in this endpoint.
      example: '2019-01-01'
    endDate:
      type: string
      description: >
        The end date requested for a given date range in **YYYY-MM-DD** format.
        Data is available on a Fiscal Annual periodicity, but updated Daily. If
        left blank, the API will default to previous close. Future dates (T+1)
        are not accepted in this endpoint.
      example: '2019-12-31'
    dateOf:
      type: string
      default: PUBLICATION
      enum:
        - PUBLICATION
        - INGESTION
      description: >
        Date of Publication or Ingestion * **Publication:**  use for startDate
        and endDate the articles publication date * **Ingestion:**  use for
        startDate and endDate the articles TVL first processing date 
      example: PUBLICATION
    calendar:
      type: string
      enum:
        - FIVEDAY
        - SEVENDAY
        - LOCAL
      default: SEVENDAY
      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.
      example: FIVEDAY
    sdgStartDate:
      type: string
      description: >
        The start date requested for a given date range in YYYY-MM-DD format.
        The input start date must be before the input end date. Future dates
        (T+1) are not accepted in this endpoint.
      example: '2021-01-01'
    sdgEndDate:
      type: string
      description: >
        The end date requested for a given date range in YYYY-MM-DD format. The
        input end date must be after the input start date. Future dates (T+1)
        are not accepted in this endpoint.
      example: '2021-10-30'
    sasbScoreTypes:
      type: array
      default:
        - ALL
      items:
        type: string
      minItems: 1
      maxItems: 8
      description: >
        The FactSet Truvalue Score types being requested. Score Types include
        the Pulse, Insight, Momentum, Article Volume, Category Volume, Dynamic
        Materiality Score, Adjusted Insight, and Industry Percentile. When left
        blank all score types will be returned for the requested Id. To specify
        select scores returned in the response, provide a comma-separated list
        of the scores using the description below.

        <p>These scores use the same underlying data and 100-point scale, except
        for ranks and percentiles. The cognitive computing system behind
        FactSet's Truvalue Platform uses natural language processing to
        interpret semantic content and generate analytics. It does so by
        applying criteria that are consistent with established sustainability
        and ESG frameworks, scoring data points on performance using a 0 to 100
        scale. A score of 50 represents a neutral impact. Scores above 50
        indicate positive performance, and scores below reflect negative
        performance.</p>


        ### ESG Score Types


        |**SASB Category Input**|**Description**|

        |||

        |**PULSE**|*Pulse Score*, is a measure of near-term performance changes
        that highlights opportunities and controversies, enabling real-time
        monitoring of companies. It focuses on events of the day and provides a
        responsive signal to alert investors to dynamic moves.|

        |**INSIGHT**|*Insight Score*, a measure of a company's longer-term ESG
        track record, similar to a ratings system. Scores are less sensitive to
        daily events and reflect the enduring performance record of a company
        over time. Scores are derived using an exponentially-weighted moving
        average of the Pulse, defined below, and the half-life of an event's
        influence on the overall score is 6 months.|

        |**MOMENTUM**|*Momentum Score*, measures the trend of a company's
        Insight score. It is a unique ESG metric in the industry that gives
        investors a high-precision view of the trajectory of a company's ESG
        performance, relative to peers. It does so by precisely articulating
        upward or downward movement, relative to that of all others in the
        universe, making it a measure that enhances quantitative workflows.|

        |**ART_VOL_TTM**|*Article Volume Score*, measures the information flow
        or number of articles about a company over the past 12 months.|

        |**CAT_VOL_TTM**|*Category Volume Score*, returns the total number of
        times any of the 26 categories received a score over a trailing
        twelve-month (TTM) period of time.|

        |**DYNAMIC_MAT**|*Dynamic Materiality Score*, shows the percentage value
        of data flow by category compared with the total data flow for the
        organization **(NOT VALID for `ALLCATEGORIES` and `MATERIALITY` category
        types).**|

        |**ADJ_INSIGHT**|*Adjusted Insight*, Measures company ESG performance,
        generating scores for lower-volume and zero-volume firms by blending
        company scores with industry medians. **(ONLY Vaild for `ALLCATEGORIES`
        and `MATERIALITY` categories). <p>**Adjusted Insight Score = (# of
        articles / 5) x Company Insight Score + ((5 - # of articles) / 5) x
        Industry (or Sector) Median Insight Score.</p>|

        |**IND_PCTL**|*Industry Percentile*, offers context on company Adjusted
        Insight scores relative to peers in the same SICS Industry. This value
        is used to establish the textual ESG Rank. **(ONLY Vaild for
        `ALLCATEGORIES` and `MATERIALITY` categories).**|


        ### Helper Input

        **ALL**= *Ability to fetch all of the "scoreTypes" listed above in a
        simplified query.* This is used by default and removes the need to
        explitly request each scoreType in the list.
      example:
        - PULSE
        - INSIGHT
        - MOMENTUM
    sdgScoreTypes:
      type: array
      default:
        - ALL
      items:
        type: string
      minItems: 1
      maxItems: 8
      description: >
        The FactSet Truvalue Score types being requested. Score Types include
        the Pulse, Insight, Momentum, Article Volume, Category Volume, Dynamic
        Materiality Score, Adjusted Insight, and Industry Percentile. When left
        blank all score types will be returned for the requested Id. To specify
        select scores returned in the response, provide a comma-separated list
        of the scores using the description below.

        <p>These scores use the same underlying data and 100-point scale, except
        for ranks and percentiles. The cognitive computing system behind
        FactSet's Truvalue Platform uses natural language processing to
        interpret semantic content and generate analytics. It does so by
        applying criteria that are consistent with established sustainability
        and ESG frameworks, scoring data points on performance using a 0 to 100
        scale. A score of 50 represents a neutral impact. Scores above 50
        indicate positive performance, and scores below reflect negative
        performance.</p>


        ### SDG Score Types


        |**SDG Category Input**|**Description**|

        |||

        |**PULSE**|*Pulse Score*, is a measure of near-term performance changes
        that highlights opportunities and controversies, enabling real-time
        monitoring of companies. It focuses on events of the day and provides a
        responsive signal to alert investors to dynamic moves.|

        |**INSIGHT**|*Insight Score*, a measure of a company's longer-term SDG
        track record, similar to a ratings system. Scores are less sensitive to
        daily events and reflect the enduring performance record of a company
        over time. Scores are derived using an exponentially-weighted moving
        average of the Pulse, defined below, and the half-life of an event's
        influence on the overall score is 6 months.|

        |**MOMENTUM**|*Momentum Score*, measures the trend of a company's
        Insight score. It is a unique SDG metric in the industry that gives
        investors a high-precision view of the trajectory of a company's ESG
        performance, relative to peers. It does so by precisely articulating
        upward or downward movement, relative to that of all others in the
        universe, making it a measure that enhances quantitative workflows.|

        |**DYNAMIC_MAT**|*Dynamic Materiality Score*, shows the percentage value
        of data flow by category compared with the total data flow for the
        organization |

        |**ADJ_INSIGHT**|*Adjusted Insight*, Measures company ESG performance,
        generating scores for lower-volume and zero-volume firms by blending
        company scores with industry medians. **(ONLY Vaild for `IMPACT`
        category)**. <p>**Adjusted Insight Score = (# of articles / 5) x Company
        Insight Score + ((5 - # of articles) / 5) x Industry (or Sector) Median
        Insight Score.</p>|

        |**IND_PCTL**|*Industry Percentile*, offers context on company Adjusted
        Insight scores relative to peers in the same SICS Industry. This value
        is used to establish the textual ESG Rank. **(ONLY Vaild for `IMPACT`
        category).**|

        |**TTM_VOLUME**|*TTM Volume*, measures the data flow over a trailing
        twelve month period.|

        |**SDG_RANK**|*SDG Rank*, offers rank leveraging the 16 ESG categories
        defined by Sustainable Development Goals (SDG).**(ONLY Vaild for
        `IMPACT` category)**The datatype for the data returned when this score
        types is requested is String.|
      example:
        - PULSE
        - INSIGHT
        - MOMENTUM
    categories:
      type: array
      default:
        - ALLCATEGORIES
      items:
        type: string
      minItems: 1
      maxItems: 28
      description: >
        The SASB Categories requested for the respective scoreType(s). The
        default value is **ALLCATEGORIES**, which represents all 26 categories
        in a single overall score. To request a specifc category or list of
        categories, simply input the category names below. 


        ### SASB Categories

        |**SASB Category Inputs**|**Description**|

        |||

        |**ALLCATEGORIES**|**All Categories** - this category represents a
        company's overall SASB Score for the specific 'scoreType'. This value is
        equal to the cumulative average of all 26 SASB categories for the
        specific 'scoreType'.*Note that category is not available for the
        Dynamic Materiality 'scoreType'.**|

        |**ACCESSANDAFFORDABILITY**|**Access and Affordability** - The category
        addresses a company's ability to ensure broad access to its products and
        services, specifically in the context of underserved markets and/or
        population groups. It includes the management of issues related to
        universal needs, such as the accessibility and affordability of health
        care, financial services, utilities , education, and
        telecommunications.|

        |**AIRQUALITY**|**Air Quality** - the category addresses management of
        air quality impacts resulting from stationary (e.g., factories, power
        plants) and mobile sources (e.g., trucks, delivery vehicles, planes) as
        well as industrial emissions. Relevant airborne pollutants include, but
        are not limited to, oxides of nitrogen (NOx), oxides of sulfur (SOx),
        volatile organic compounds (VOCs), heavy metals, particulate matter, and
        chlorofluorocarbons. The category does not include GHG emissions, which
        are addressed in a separate category.|

        |**BUSINESSETHICS**|**Business Ethics** - the category addresses the
        company's approach to managing risks and opportunities surrounding
        ethical conduct of business, including fraud, corruption, bribery and
        facilitation payments, fiduciary responsibilities, and other behavior
        that may have an ethical component. This includes sensitivity to
        business norms and standards as they shift over time, jurisdiction, and
        culture. It addresses the company's ability to provide services that
        satisfy the highest professional and ethical standards of the industry,
        which means to avoid conflicts of interest, misrepresentation, bias, and
        negligence through training employees adequately and implementing
        policies and procedures to ensure employees provide services free from
        bias and error.|

        |**BUSMODELRESILIENCE**|**Business Model Resilience** - the category
        addresses an industry's capacity to manage risks and opportunities
        associated with incorporating social, environmental, and political
        transitions into long-term business model planning. This includes
        responsiveness to the transition to a low-carbon and climate-constrained
        economy, as well as growth and creation of new markets among unserved
        and underserved socioeconomic populations. The category highlights
        industries in which evolving environmental and social realities may
        challenge companies to fundamentally adapt or may put their business
        models at risk.|

        |**COMPETITIVEBEHAVIOR**|**Competitive Behavior** - the category covers
        social issues associated with existence of monopolies, which may
        include, but are not limited to, excessive prices, poor quality of
        service, and inefficiencies. It addresses a company's management of
        legal and social expectation around monopolistic and anti-competitive
        practices, including issues related to bargaining power, collusion,
        price fixing or manipulation, and protection of patents and intellectual
        property (IP).|

        |**CRITINCIDENTRISKMGT**|**Critical Incident Risk Management** - the
        category addresses the company's use of management systems and scenario
        planning to identify, understand, and prevent or minimize the occurrence
        of low-probability, high-impact accidents and emergencies with
        significant potential environmental and social externalities. It relates
        to the culture of safety at a company, its relevant safety management
        systems and technological controls, the potential human, environmental,
        and social implications of such events occurring, and the long-term
        effects to an organization, its workers, and society should these events
        occur.|

        |**CUSTOMERPRIVACY**|**Customer Privacy** - the category addresses
        management of risks related to the use of personally identifiable
        information (PII) and other customer or user data for secondary purposes
        including but not limited to marketing through affiliates and
        non-affiliates. The scope of the category includes social issues that
        may arise from a company's approach to collecting data, obtaining
        consent (e.g., opt-in policies), managing user and customer expectations
        regarding how their data is used, and managing evolving regulation. It
        excludes social issues arising from cybersecurity risks, which are
        covered in a separate category.|

        |**CUSTWELFARE**|**Customer Welfare** - the category addresses customer
        welfare concerns over issues including, but not limited to, health and
        nutrition of foods and beverages, antibiotic use in animal production,
        and management of controlled substances. The category addresses the
        company's ability to provide consumers with manufactured products and
        services that are aligned with societal expectations. It does not
        include issues directly related to quality and safety malfunctions of
        manufactured products and services, but instead addresses qualities
        inherent to the design and delivery of products and services where
        customer welfare may be in question. The scope of the category also
        captures companies' ability to prevent counterfeit products.|

        |**DATASECURITY**|**Data Security** - the category addresses management
        of risks related to collection, retention, and use of sensitive,
        confidential, and/or proprietary customer or user data. It includes
        social issues that may arise from incidents such as data breaches in
        which personally identifiable information (PII) and other user or
        customer data may be exposed. It addresses a company's strategy,
        policies, and practices related to IT infrastructure, staff training,
        record keeping, cooperation with law enforcement, and other mechanisms
        used to ensure security of customer or user data.|

        |**ECOLOGICALIMPACTS**|**Ecological Impacts** - the category addresses
        management of the company's impacts on ecosystems and biodiversity
        through activities including, but not limited to, land use for
        exploration, natural resource extraction, and cultivation, as well as
        project development, construction, and siting. The impacts include, but
        are not limited to, biodiversity loss, habitat destruction, and
        deforestation at all stages – planning, land acquisition, permitting,
        development, operations, and site remediation. The category does not
        cover impacts of climate change on ecosystems and biodiversity.|

        |**EMPENGDIVANDINC**|**Employee Engagement Diversity and Inclusion** -
        the category addresses a company's ability to ensure that its culture
        and hiring and promotion practices embrace the building of a diverse and
        inclusive workforce that reflects the makeup of local talent pools and
        its customer base. It addresses the issues of discriminatory practices
        on the bases of race, gender, ethnicity, religion, sexual orientation,
        and other factors.|

        |**EMPHEALTHANDSAFETY**|**Employee Health and Safety** - the category
        addresses a company's ability to create and maintain a safe and healthy
        workplace environment that is free of injuries, fatalities, and illness
        (both chronic and acute). It is traditionally accomplished through
        implementing safety management plans, developing training requirements
        for employees and contractors, and conducting regular audits of their
        own practices as well as those of their subcontractors. The category
        further captures how companies ensure physical and mental health of
        workforce through technology, training, corporate culture, regulatory
        compliance, monitoring and testing, and personal protective equipment.|

        |**ENERGYMGT**|**Energy Management** - the category addresses
        environmental impacts associated with energy consumption. It addresses
        the company's management of energy in manufacturing and/or for provision
        of products and services derived from utility providers (grid energy)
        not owned or controlled by the company. More specifically, it includes
        management of energy efficiency and intensity, energy mix, as well as
        grid reliance. Upstream (e.g., suppliers) and downstream (e.g., product
        use) energy use is not included in the scope.|

        |**GHGEMISSIONS**|**Greenhouse Gas Emissions** - the category addresses
        direct (Scope 1) greenhouse gas (GHG) emissions that a company generates
        through its operations. This includes GHG emissions from stationary
        (e.g., factories, power plants) and mobile sources (e.g., trucks,
        delivery vehicles, planes), whether a result of combustion of fuel or
        non-combusted direct releases during activities such as natural resource
        extraction, power generation, land use, or biogenic processes. The
        category further includes management of regulatory risks, environmental
        compliance, and reputational risks and opportunities, as they related to
        direct GHG emissions. The seven GHGs covered under the Kyoto Protocol
        are included within the category— carbon dioxide (CO2 ), methane (CH4),
        nitrous oxide (N2O), hydrofluorocarbons (HFCs), perfluorocarbons (PFCs),
        sulfur hexafluoride (SF6), and nitrogen trifluoride (NF3).|

        |**HUMANRIGHTSANDCOMRELS**|**Human Rights and Community Relations** -
        the category addresses management of the relationship between businesses
        and the communities in which they operate, including, but not limited
        to, management of direct and indirect impacts on core human rights and
        the treatment of indigenous peoples. More specifically, such management
        may cover socio-economic community impacts, community engagement,
        environmental justice, cultivation of local workforces, impact on local
        businesses, license to operate, and environmental/social impact
        assessments. The category does not include environmental impacts such as
        air pollution or waste which, although they may impact the health and
        safety of members of local communities, are addressed in separate
        categories.|

        |**LABORPRACTICES**|**Labor Practices** - the category addresses the
        company's ability to uphold commonly accepted labor standards in the
        workplace, including compliance with labor laws and internationally
        accepted norms and standards. This includes, but is not limited to,
        ensuring basic human rights related to child labor, forced or bonded
        labor, exploitative labor, fair wages and overtime pay, and other basic
        workers' rights. It also includes minimum wage policies and provision of
        benefits, which may influence how a workforce is attracted, retained,
        and motivated. The category further addresses a company's relationship
        with organized labor and freedom of association.|

        |**MGTOFLEGALANDREGENV**|**Management of the Legal and Regulatory
        Environment** - the category addresses a company's approach to engaging
        with regulators in cases where conflicting corporate and public
        interests may have the potential for long-term adverse direct or
        indirect environmental and social impacts. The category addresses a
        company's level of reliance upon regulatory policy or monetary
        incentives (such as subsidies and taxes), actions to influence industry
        policy (such as through lobbying), overall reliance on a favorable
        regulatory environment for business competitiveness, and ability to
        comply with relevant regulations. It may relate to the alignment of
        management and investor views of regulatory engagement and compliance at
        large.|

        |**MATSOURCINGANDEFF**|**Materials Sourcing and Efficiency** - the
        category addresses issues related to the resilience of materials supply
        chains to impacts of climate change and other external environmental and
        social factors. It captures the impacts of such external factors on
        operational activity of suppliers, which can further affect availability
        and pricing of key resources. It addresses a company's ability to manage
        these risks through product design, manufacturing, and end-of-life
        management, such as by using of recycled and renewable materials,
        reducing the use of key materials (dematerialization), maximizing
        resource efficiency in manufacturing, and making R&D investments in
        substitute materials. Additionally, companies can manage these issues by
        screening, selection, monitoring, and engagement with suppliers to
        ensure their resilience to external risks. It does not address issues
        associated with environmental and social externalities created by
        operational activity of individual suppliers, which is covered in a
        separate category.|

        |**MATERIALITY**|**Materiality** - this category represents a composite
        score 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/)|

        |**PHYIMPACTSOFCLIMATECHG**|**Physical Impacts of Climate Change** - the
        category addresses the company's ability to manage risks and
        opportunities associated with direct exposure of its owned or controlled
        assets and operations to actual or potential physical impacts of climate
        change. It captures environmental and social issues that may arise from
        operational disruptions due to physical impacts of climate change. It
        further captures socioeconomic issues resulting from companies failing
        to incorporate climate change consideration in products and services
        sold, such as insurance policies and mortgages. The category relates to
        the company's ability to adapt to increased frequency and severity of
        extreme weather, shifting climate, sea level risk, and other expected
        physical impacts of climate change. Management may involve enhancing
        resiliency of physical assets and/or surrounding infrastructure as well
        as incorporation of climate change-related considerations into key
        business activities (e.g., mortgage and insurance underwriting, planning
        and development of real estate projects).|

        |**PDANDLIFECYCLEMGT**|**Product Design and Lifecycle Management** - the
        category addresses incorporation of environmental, social, and
        governance (ESG) considerations in characteristics of products and
        services provided or sold by the company. It includes, but is not
        limited to, managing the lifecycle impacts of products and services,
        such as those related to packaging, distribution, use-phase resource
        intensity, and other environmental and social externalities that may
        occur during their use-phase or at the end of life. The category
        captures a company's ability to address customer and societal demand for
        more sustainable products and services as well as to meet evolving
        environmental and social regulation. It does not address direct
        environmental or social impacts of the company's operations nor does it
        address health and safety risks to consumers from product use, which are
        covered in other categories.|

        |**PRODQUALITYANDSFTY**|**Product Quality and Safety** - the category
        addresses issues involving unintended characteristics of products sold
        or services provided that may create health or safety risks to
        end-users. It addresses a company's ability to offer manufactured
        products and/or services that meet customer expectations with respect to
        their health and safety characteristics. It includes, but is not limited
        to, issues involving liability, management of recalls and market
        withdrawals, product testing, and chemicals/content/ ingredient
        management in products.|

        |**SELLPRACANDPRODLABEL**|**Selling Practices and Product Labeling** -
        the category addresses social issues that may arise from a failure to
        manage the transparency, accuracy, and comprehensibility of marketing
        statements, advertising, and labeling of products and services. It
        includes, but is not limited to, advertising standards and regulations,
        ethical and responsible marketing practices, misleading or deceptive
        labeling, as well as discriminatory or predatory selling and lending
        practices. This may include deceptive or aggressive selling practices in
        which incentive structures for employees could encourage the sale of
        products or services that are not in the best interest of customers or
        clients.|

        |**SUPPLYCHAINMGT**|**Supply Chain Management** - the category addresses
        management of environmental, social, and governance (ESG) risks within a
        company's supply chain. It addresses issues associated with
        environmental and social externalities created by suppliers through
        their operational activities. Such issues include, but are not limited
        to, environmental responsibility, human rights, labor practices, and
        ethics and corruption. Management may involve screening, selection,
        monitoring, and engagement with suppliers on their environmental and
        social impacts. The category does not address the impacts of external
        factors – such as climate change and other environmental and social
        factors – on suppliers' operations and/or on the availability and
        pricing of key resources, which is covered in a separate category.|

        |**SYSTEMICRISKMGT**|**Systemic Risk Management** - the category
        addresses the company's contributions to, or management of systemic
        risks resulting from large-scale weakening or collapse of systems upon
        which the economy and society depend. This includes financial systems,
        natural resource systems, and technological systems. It addresses the
        mechanisms a company has in place to reduce its contributions to
        systemic risks and to improve safeguards that may mitigate the impacts
        of systemic failure. For financial institutions, the category also
        captures the company's ability to absorb shocks arising from financial
        and economic stress and meet stricter regulatory requirements related to
        the complexity and interconnectedness of companies in the industry.|

        |**WASTEANDHZRDMATSMGT**|**Waste and Hazardous Materials Management** -
        the category addresses environmental issues associated with hazardous
        and non-hazardous waste generated by companies. It addresses a company's
        management of solid wastes in manufacturing, agriculture, and other
        industrial processes. It covers treatment, handling, storage, disposal,
        and regulatory compliance. The category does not cover emissions to air
        or wastewater, nor does it cover waste from end-of-life of products,
        which are addressed in separate categories.|

        |**WATERANDWASTEWATERMGT**|**Water and Wastewater Management** - the
        category addresses a company's water use, water consumption, wastewater
        generation, and other impacts of operations on water resources, which
        may be influenced by regional differences in the availability and
        quality of and competition for water resources. More specifically, it
        addresses management strategies including, but not limited to, water
        efficiency, intensity, and recycling. Lastly, the category also
        addresses management of wastewater treatment and discharge, including
        groundwater and aquifer pollution.|


        ### Helper Input

        **ALL** = Simply gives the ability to request all categories in a single
        request without having to explicitly list out all 26 in the request.
        *This is not the same as "ALLCATEGORIES" which is a single overall score
        for the company and returned as default.*
      example:
        - AIRQUALITY
        - BUSINESSETHICS
        - HUMANRIGHTSANDCOMRELS
    sasbSpotlightsCategories:
      type: array
      default:
        - ALLCATEGORIES
      items:
        type: string
      description: >
        The SASB Categories requested for the respective scoreType(s). The
        default value is **ALLCATEGORIES**, which represents all 26 categories
        in a single overall score. To request a specifc category or list of
        categories, simply input the category names below. 


        ### SASB Categories

        |**SASB Category Inputs**|**Description**|

        |||

        |**ALLCATEGORIES**|**All Categories** - this category represents a
        company's overall SASB Score for the specific 'scoreType'. This value is
        equal to the cumulative average of all 26 SASB categories for the
        specific 'scoreType'.*Note that category is not available for the
        Dynamic Materiality 'scoreType'.

        |**ACCESSANDAFFORDABILITY**|**Access and Affordability** - The category
        addresses a company's ability to ensure broad access to its products and
        services, specifically in the context of underserved markets and/or
        population groups. It includes the management of issues related to
        universal needs, such as the accessibility and affordability of health
        care, financial services, utilities , education, and
        telecommunications.|

        |**AIRQUALITY**|**Air Quality** - the category addresses management of
        air quality impacts resulting from stationary (e.g., factories, power
        plants) and mobile sources (e.g., trucks, delivery vehicles, planes) as
        well as industrial emissions. Relevant airborne pollutants include, but
        are not limited to, oxides of nitrogen (NOx), oxides of sulfur (SOx),
        volatile organic compounds (VOCs), heavy metals, particulate matter, and
        chlorofluorocarbons. The category does not include GHG emissions, which
        are addressed in a separate category.|

        |**BUSINESSETHICS**|**Business Ethics** - the category addresses the
        company's approach to managing risks and opportunities surrounding
        ethical conduct of business, including fraud, corruption, bribery and
        facilitation payments, fiduciary responsibilities, and other behavior
        that may have an ethical component. This includes sensitivity to
        business norms and standards as they shift over time, jurisdiction, and
        culture. It addresses the company's ability to provide services that
        satisfy the highest professional and ethical standards of the industry,
        which means to avoid conflicts of interest, misrepresentation, bias, and
        negligence through training employees adequately and implementing
        policies and procedures to ensure employees provide services free from
        bias and error.|

        |**BUSMODELRESILIENCE**|**Business Model Resilience** - the category
        addresses an industry's capacity to manage risks and opportunities
        associated with incorporating social, environmental, and political
        transitions into long-term business model planning. This includes
        responsiveness to the transition to a low-carbon and climate-constrained
        economy, as well as growth and creation of new markets among unserved
        and underserved socioeconomic populations. The category highlights
        industries in which evolving environmental and social realities may
        challenge companies to fundamentally adapt or may put their business
        models at risk.|

        |**COMPETITIVEBEHAVIOR**|**Competitive Behavior** - the category covers
        social issues associated with existence of monopolies, which may
        include, but are not limited to, excessive prices, poor quality of
        service, and inefficiencies. It addresses a company's management of
        legal and social expectation around monopolistic and anti-competitive
        practices, including issues related to bargaining power, collusion,
        price fixing or manipulation, and protection of patents and intellectual
        property (IP).|

        |**CRITINCIDENTRISKMGT**|**Critical Incident Risk Management** - the
        category addresses the company's use of management systems and scenario
        planning to identify, understand, and prevent or minimize the occurrence
        of low-probability, high-impact accidents and emergencies with
        significant potential environmental and social externalities. It relates
        to the culture of safety at a company, its relevant safety management
        systems and technological controls, the potential human, environmental,
        and social implications of such events occurring, and the long-term
        effects to an organization, its workers, and society should these events
        occur.|

        |**CUSTOMERPRIVACY**|**Customer Privacy** - the category addresses
        management of risks related to the use of personally identifiable
        information (PII) and other customer or user data for secondary purposes
        including but not limited to marketing through affiliates and
        non-affiliates. The scope of the category includes social issues that
        may arise from a company's approach to collecting data, obtaining
        consent (e.g., opt-in policies), managing user and customer expectations
        regarding how their data is used, and managing evolving regulation. It
        excludes social issues arising from cybersecurity risks, which are
        covered in a separate category.|

        |**CUSTWELFARE**|**Customer Welfare** - the category addresses customer
        welfare concerns over issues including, but not limited to, health and
        nutrition of foods and beverages, antibiotic use in animal production,
        and management of controlled substances. The category addresses the
        company's ability to provide consumers with manufactured products and
        services that are aligned with societal expectations. It does not
        include issues directly related to quality and safety malfunctions of
        manufactured products and services, but instead addresses qualities
        inherent to the design and delivery of products and services where
        customer welfare may be in question. The scope of the category also
        captures companies' ability to prevent counterfeit products.|

        |**DATASECURITY**|**Data Security** - the category addresses management
        of risks related to collection, retention, and use of sensitive,
        confidential, and/or proprietary customer or user data. It includes
        social issues that may arise from incidents such as data breaches in
        which personally identifiable information (PII) and other user or
        customer data may be exposed. It addresses a company's strategy,
        policies, and practices related to IT infrastructure, staff training,
        record keeping, cooperation with law enforcement, and other mechanisms
        used to ensure security of customer or user data.|

        |**ECOLOGICALIMPACTS**|**Ecological Impacts** - the category addresses
        management of the company's impacts on ecosystems and biodiversity
        through activities including, but not limited to, land use for
        exploration, natural resource extraction, and cultivation, as well as
        project development, construction, and siting. The impacts include, but
        are not limited to, biodiversity loss, habitat destruction, and
        deforestation at all stages – planning, land acquisition, permitting,
        development, operations, and site remediation. The category does not
        cover impacts of climate change on ecosystems and biodiversity.|

        |**EMPENGDIVANDINC**|**Employee Engagement Diversity and Inclusion** -
        the category addresses a company's ability to ensure that its culture
        and hiring and promotion practices embrace the building of a diverse and
        inclusive workforce that reflects the makeup of local talent pools and
        its customer base. It addresses the issues of discriminatory practices
        on the bases of race, gender, ethnicity, religion, sexual orientation,
        and other factors.|

        |**EMPHEALTHANDSAFETY**|**Employee Health and Safety** - the category
        addresses a company's ability to create and maintain a safe and healthy
        workplace environment that is free of injuries, fatalities, and illness
        (both chronic and acute). It is traditionally accomplished through
        implementing safety management plans, developing training requirements
        for employees and contractors, and conducting regular audits of their
        own practices as well as those of their subcontractors. The category
        further captures how companies ensure physical and mental health of
        workforce through technology, training, corporate culture, regulatory
        compliance, monitoring and testing, and personal protective equipment.|

        |**ENERGYMGT**|**Energy Management** - the category addresses
        environmental impacts associated with energy consumption. It addresses
        the company's management of energy in manufacturing and/or for provision
        of products and services derived from utility providers (grid energy)
        not owned or controlled by the company. More specifically, it includes
        management of energy efficiency and intensity, energy mix, as well as
        grid reliance. Upstream (e.g., suppliers) and downstream (e.g., product
        use) energy use is not included in the scope.|

        |**GHGEMISSIONS**|**Greenhouse Gas Emissions** - the category addresses
        direct (Scope 1) greenhouse gas (GHG) emissions that a company generates
        through its operations. This includes GHG emissions from stationary
        (e.g., factories, power plants) and mobile sources (e.g., trucks,
        delivery vehicles, planes), whether a result of combustion of fuel or
        non-combusted direct releases during activities such as natural resource
        extraction, power generation, land use, or biogenic processes. The
        category further includes management of regulatory risks, environmental
        compliance, and reputational risks and opportunities, as they related to
        direct GHG emissions. The seven GHGs covered under the Kyoto Protocol
        are included within the category— carbon dioxide (CO2 ), methane (CH4),
        nitrous oxide (N2O), hydrofluorocarbons (HFCs), perfluorocarbons (PFCs),
        sulfur hexafluoride (SF6), and nitrogen trifluoride (NF3).|

        |**HUMANRIGHTSANDCOMRELS**|**Human Rights and Community Relations** -
        the category addresses management of the relationship between businesses
        and the communities in which they operate, including, but not limited
        to, management of direct and indirect impacts on core human rights and
        the treatment of indigenous peoples. More specifically, such management
        may cover socio-economic community impacts, community engagement,
        environmental justice, cultivation of local workforces, impact on local
        businesses, license to operate, and environmental/social impact
        assessments. The category does not include environmental impacts such as
        air pollution or waste which, although they may impact the health and
        safety of members of local communities, are addressed in separate
        categories.|

        |**LABORPRACTICES**|**Labor Practices** - the category addresses the
        company's ability to uphold commonly accepted labor standards in the
        workplace, including compliance with labor laws and internationally
        accepted norms and standards. This includes, but is not limited to,
        ensuring basic human rights related to child labor, forced or bonded
        labor, exploitative labor, fair wages and overtime pay, and other basic
        workers' rights. It also includes minimum wage policies and provision of
        benefits, which may influence how a workforce is attracted, retained,
        and motivated. The category further addresses a company's relationship
        with organized labor and freedom of association.|

        |**MGTOFLEGALANDREGENV**|**Management of the Legal and Regulatory
        Environment** - the category addresses a company's approach to engaging
        with regulators in cases where conflicting corporate and public
        interests may have the potential for long-term adverse direct or
        indirect environmental and social impacts. The category addresses a
        company's level of reliance upon regulatory policy or monetary
        incentives (such as subsidies and taxes), actions to influence industry
        policy (such as through lobbying), overall reliance on a favorable
        regulatory environment for business competitiveness, and ability to
        comply with relevant regulations. It may relate to the alignment of
        management and investor views of regulatory engagement and compliance at
        large.|

        |**MATSOURCINGANDEFF**|**Materials Sourcing and Efficiency** - the
        category addresses issues related to the resilience of materials supply
        chains to impacts of climate change and other external environmental and
        social factors. It captures the impacts of such external factors on
        operational activity of suppliers, which can further affect availability
        and pricing of key resources. It addresses a company's ability to manage
        these risks through product design, manufacturing, and end-of-life
        management, such as by using of recycled and renewable materials,
        reducing the use of key materials (dematerialization), maximizing
        resource efficiency in manufacturing, and making R&D investments in
        substitute materials. Additionally, companies can manage these issues by
        screening, selection, monitoring, and engagement with suppliers to
        ensure their resilience to external risks. It does not address issues
        associated with environmental and social externalities created by
        operational activity of individual suppliers, which is covered in a
        separate category.|

        |**MATERIALITY**|**Materiality** - this category represents a composite
        score 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/)|

        |**PHYIMPACTSOFCLIMATECHG**|**Physical Impacts of Climate Change** - the
        category addresses the company's ability to manage risks and
        opportunities associated with direct exposure of its owned or controlled
        assets and operations to actual or potential physical impacts of climate
        change. It captures environmental and social issues that may arise from
        operational disruptions due to physical impacts of climate change. It
        further captures socioeconomic issues resulting from companies failing
        to incorporate climate change consideration in products and services
        sold, such as insurance policies and mortgages. The category relates to
        the company's ability to adapt to increased frequency and severity of
        extreme weather, shifting climate, sea level risk, and other expected
        physical impacts of climate change. Management may involve enhancing
        resiliency of physical assets and/or surrounding infrastructure as well
        as incorporation of climate change-related considerations into key
        business activities (e.g., mortgage and insurance underwriting, planning
        and development of real estate projects).|

        |**PDANDLIFECYCLEMGT**|**Product Design and Lifecycle Management** - the
        category addresses incorporation of environmental, social, and
        governance (ESG) considerations in characteristics of products and
        services provided or sold by the company. It includes, but is not
        limited to, managing the lifecycle impacts of products and services,
        such as those related to packaging, distribution, use-phase resource
        intensity, and other environmental and social externalities that may
        occur during their use-phase or at the end of life. The category
        captures a company's ability to address customer and societal demand for
        more sustainable products and services as well as to meet evolving
        environmental and social regulation. It does not address direct
        environmental or social impacts of the company's operations nor does it
        address health and safety risks to consumers from product use, which are
        covered in other categories.|

        |**PRODQUALITYANDSFTY**|**Product Quality and Safety** - the category
        addresses issues involving unintended characteristics of products sold
        or services provided that may create health or safety risks to
        end-users. It addresses a company's ability to offer manufactured
        products and/or services that meet customer expectations with respect to
        their health and safety characteristics. It includes, but is not limited
        to, issues involving liability, management of recalls and market
        withdrawals, product testing, and chemicals/content/ ingredient
        management in products.|

        |**SELLPRACANDPRODLABEL**|**Selling Practices and Product Labeling** -
        the category addresses social issues that may arise from a failure to
        manage the transparency, accuracy, and comprehensibility of marketing
        statements, advertising, and labeling of products and services. It
        includes, but is not limited to, advertising standards and regulations,
        ethical and responsible marketing practices, misleading or deceptive
        labeling, as well as discriminatory or predatory selling and lending
        practices. This may include deceptive or aggressive selling practices in
        which incentive structures for employees could encourage the sale of
        products or services that are not in the best interest of customers or
        clients.|

        |**SUPPLYCHAINMGT**|**Supply Chain Management** - the category addresses
        management of environmental, social, and governance (ESG) risks within a
        company's supply chain. It addresses issues associated with
        environmental and social externalities created by suppliers through
        their operational activities. Such issues include, but are not limited
        to, environmental responsibility, human rights, labor practices, and
        ethics and corruption. Management may involve screening, selection,
        monitoring, and engagement with suppliers on their environmental and
        social impacts. The category does not address the impacts of external
        factors – such as climate change and other environmental and social
        factors – on suppliers' operations and/or on the availability and
        pricing of key resources, which is covered in a separate category.|

        |**SYSTEMICRISKMGT**|**Systemic Risk Management** - the category
        addresses the company's contributions to, or management of systemic
        risks resulting from large-scale weakening or collapse of systems upon
        which the economy and society depend. This includes financial systems,
        natural resource systems, and technological systems. It addresses the
        mechanisms a company has in place to reduce its contributions to
        systemic risks and to improve safeguards that may mitigate the impacts
        of systemic failure. For financial institutions, the category also
        captures the company's ability to absorb shocks arising from financial
        and economic stress and meet stricter regulatory requirements related to
        the complexity and interconnectedness of companies in the industry.|

        |**WASTEANDHZRDMATSMGT**|**Waste and Hazardous Materials Management** -
        the category addresses environmental issues associated with hazardous
        and non-hazardous waste generated by companies. It addresses a company's
        management of solid wastes in manufacturing, agriculture, and other
        industrial processes. It covers treatment, handling, storage, disposal,
        and regulatory compliance. The category does not cover emissions to air
        or wastewater, nor does it cover waste from end-of-life of products,
        which are addressed in separate categories.|

        |**WATERANDWASTEWATERMGT**|**Water and Wastewater Management** - the
        category addresses a company's water use, water consumption, wastewater
        generation, and other impacts of operations on water resources, which
        may be influenced by regional differences in the availability and
        quality of and competition for water resources. More specifically, it
        addresses management strategies including, but not limited to, water
        efficiency, intensity, and recycling. Lastly, the category also
        addresses management of wastewater treatment and discharge, including
        groundwater and aquifer pollution.|


        ### Helper Input

        **ALL** = Simply gives the ability to request all categories in a single
        request without having to explicitly list out all 26 in the request.
        *This is not the same as "ALLCATEGORIES" which is a single overall score
        for the company and returned as default.*
      example:
        - AIRQUALITY
        - BUSINESSETHICS
        - HUMANRIGHTSANDCOMRELS
    sasbArticlesCategories:
      type: array
      default:
        - ALLCATEGORIES
      items:
        type: string
      description: >
        Comma seperated list of one or more SASB category names as described
        below. The default value is **ALLCATEGORIES**.


        ### SASB Categories

        |**SASB Category Inputs**|**Description**|

        |||

        |**ALLCATEGORIES**|**All Categories** - Provides articles tagged to all
        26 categories of SASB. Equivalent to providing all 26 categories|

        |**SASBMATERIALITY**|**SASBMateriality**- provides articles tagged to
        material categories according to SASB's materiality framework. When
        provided, only material categories for each company is fetched|

        |**ACCESSANDAFFORDABILITY**|**Access and Affordability** - The category
        addresses a company's ability to ensure broad access to its products and
        services, specifically in the context of underserved markets and/or
        population groups. It includes the management of issues related to
        universal needs, such as the accessibility and affordability of health
        care, financial services, utilities , education, and
        telecommunications.|

        |**AIRQUALITY**|**Air Quality** - the category addresses management of
        air quality impacts resulting from stationary (e.g., factories, power
        plants) and mobile sources (e.g., trucks, delivery vehicles, planes) as
        well as industrial emissions. Relevant airborne pollutants include, but
        are not limited to, oxides of nitrogen (NOx), oxides of sulfur (SOx),
        volatile organic compounds (VOCs), heavy metals, particulate matter, and
        chlorofluorocarbons. The category does not include GHG emissions, which
        are addressed in a separate category.|

        |**BUSINESSETHICS**|**Business Ethics** - the category addresses the
        company's approach to managing risks and opportunities surrounding
        ethical conduct of business, including fraud, corruption, bribery and
        facilitation payments, fiduciary responsibilities, and other behavior
        that may have an ethical component. This includes sensitivity to
        business norms and standards as they shift over time, jurisdiction, and
        culture. It addresses the company's ability to provide services that
        satisfy the highest professional and ethical standards of the industry,
        which means to avoid conflicts of interest, misrepresentation, bias, and
        negligence through training employees adequately and implementing
        policies and procedures to ensure employees provide services free from
        bias and error.|

        |**BUSMODELRESILIENCE**|**Business Model Resilience** - the category
        addresses an industry's capacity to manage risks and opportunities
        associated with incorporating social, environmental, and political
        transitions into long-term business model planning. This includes
        responsiveness to the transition to a low-carbon and climate-constrained
        economy, as well as growth and creation of new markets among unserved
        and underserved socioeconomic populations. The category highlights
        industries in which evolving environmental and social realities may
        challenge companies to fundamentally adapt or may put their business
        models at risk.|

        |**COMPETITIVEBEHAVIOR**|**Competitive Behavior** - the category covers
        social issues associated with existence of monopolies, which may
        include, but are not limited to, excessive prices, poor quality of
        service, and inefficiencies. It addresses a company's management of
        legal and social expectation around monopolistic and anti-competitive
        practices, including issues related to bargaining power, collusion,
        price fixing or manipulation, and protection of patents and intellectual
        property (IP).|

        |**CRITINCIDENTRISKMGT**|**Critical Incident Risk Management** - the
        category addresses the company's use of management systems and scenario
        planning to identify, understand, and prevent or minimize the occurrence
        of low-probability, high-impact accidents and emergencies with
        significant potential environmental and social externalities. It relates
        to the culture of safety at a company, its relevant safety management
        systems and technological controls, the potential human, environmental,
        and social implications of such events occurring, and the long-term
        effects to an organization, its workers, and society should these events
        occur.|

        |**CUSTOMERPRIVACY**|**Customer Privacy** - the category addresses
        management of risks related to the use of personally identifiable
        information (PII) and other customer or user data for secondary purposes
        including but not limited to marketing through affiliates and
        non-affiliates. The scope of the category includes social issues that
        may arise from a company's approach to collecting data, obtaining
        consent (e.g., opt-in policies), managing user and customer expectations
        regarding how their data is used, and managing evolving regulation. It
        excludes social issues arising from cybersecurity risks, which are
        covered in a separate category.|

        |**CUSTWELFARE**|**Customer Welfare** - the category addresses customer
        welfare concerns over issues including, but not limited to, health and
        nutrition of foods and beverages, antibiotic use in animal production,
        and management of controlled substances. The category addresses the
        company's ability to provide consumers with manufactured products and
        services that are aligned with societal expectations. It does not
        include issues directly related to quality and safety malfunctions of
        manufactured products and services, but instead addresses qualities
        inherent to the design and delivery of products and services where
        customer welfare may be in question. The scope of the category also
        captures companies' ability to prevent counterfeit products.|

        |**DATASECURITY**|**Data Security** - the category addresses management
        of risks related to collection, retention, and use of sensitive,
        confidential, and/or proprietary customer or user data. It includes
        social issues that may arise from incidents such as data breaches in
        which personally identifiable information (PII) and other user or
        customer data may be exposed. It addresses a company's strategy,
        policies, and practices related to IT infrastructure, staff training,
        record keeping, cooperation with law enforcement, and other mechanisms
        used to ensure security of customer or user data.|

        |**ECOLOGICALIMPACTS**|**Ecological Impacts** - the category addresses
        management of the company's impacts on ecosystems and biodiversity
        through activities including, but not limited to, land use for
        exploration, natural resource extraction, and cultivation, as well as
        project development, construction, and siting. The impacts include, but
        are not limited to, biodiversity loss, habitat destruction, and
        deforestation at all stages – planning, land acquisition, permitting,
        development, operations, and site remediation. The category does not
        cover impacts of climate change on ecosystems and biodiversity.|

        |**EMPENGDIVANDINC**|**Employee Engagement Diversity and Inclusion** -
        the category addresses a company's ability to ensure that its culture
        and hiring and promotion practices embrace the building of a diverse and
        inclusive workforce that reflects the makeup of local talent pools and
        its customer base. It addresses the issues of discriminatory practices
        on the bases of race, gender, ethnicity, religion, sexual orientation,
        and other factors.|

        |**EMPHEALTHANDSAFETY**|**Employee Health and Safety** - the category
        addresses a company's ability to create and maintain a safe and healthy
        workplace environment that is free of injuries, fatalities, and illness
        (both chronic and acute). It is traditionally accomplished through
        implementing safety management plans, developing training requirements
        for employees and contractors, and conducting regular audits of their
        own practices as well as those of their subcontractors. The category
        further captures how companies ensure physical and mental health of
        workforce through technology, training, corporate culture, regulatory
        compliance, monitoring and testing, and personal protective equipment.|

        |**ENERGYMGT**|**Energy Management** - the category addresses
        environmental impacts associated with energy consumption. It addresses
        the company's management of energy in manufacturing and/or for provision
        of products and services derived from utility providers (grid energy)
        not owned or controlled by the company. More specifically, it includes
        management of energy efficiency and intensity, energy mix, as well as
        grid reliance. Upstream (e.g., suppliers) and downstream (e.g., product
        use) energy use is not included in the scope.|

        |**GHGEMISSIONS**|**Greenhouse Gas Emissions** - the category addresses
        direct (Scope 1) greenhouse gas (GHG) emissions that a company generates
        through its operations. This includes GHG emissions from stationary
        (e.g., factories, power plants) and mobile sources (e.g., trucks,
        delivery vehicles, planes), whether a result of combustion of fuel or
        non-combusted direct releases during activities such as natural resource
        extraction, power generation, land use, or biogenic processes. The
        category further includes management of regulatory risks, environmental
        compliance, and reputational risks and opportunities, as they related to
        direct GHG emissions. The seven GHGs covered under the Kyoto Protocol
        are included within the category— carbon dioxide (CO2 ), methane (CH4),
        nitrous oxide (N2O), hydrofluorocarbons (HFCs), perfluorocarbons (PFCs),
        sulfur hexafluoride (SF6), and nitrogen trifluoride (NF3).|

        |**HUMANRIGHTSANDCOMRELS**|**Human Rights and Community Relations** -
        the category addresses management of the relationship between businesses
        and the communities in which they operate, including, but not limited
        to, management of direct and indirect impacts on core human rights and
        the treatment of indigenous peoples. More specifically, such management
        may cover socio-economic community impacts, community engagement,
        environmental justice, cultivation of local workforces, impact on local
        businesses, license to operate, and environmental/social impact
        assessments. The category does not include environmental impacts such as
        air pollution or waste which, although they may impact the health and
        safety of members of local communities, are addressed in separate
        categories.|

        |**LABORPRACTICES**|**Labor Practices** - the category addresses the
        company's ability to uphold commonly accepted labor standards in the
        workplace, including compliance with labor laws and internationally
        accepted norms and standards. This includes, but is not limited to,
        ensuring basic human rights related to child labor, forced or bonded
        labor, exploitative labor, fair wages and overtime pay, and other basic
        workers' rights. It also includes minimum wage policies and provision of
        benefits, which may influence how a workforce is attracted, retained,
        and motivated. The category further addresses a company's relationship
        with organized labor and freedom of association.|

        |**MGTOFLEGALANDREGENV**|**Management of the Legal and Regulatory
        Environment** - the category addresses a company's approach to engaging
        with regulators in cases where conflicting corporate and public
        interests may have the potential for long-term adverse direct or
        indirect environmental and social impacts. The category addresses a
        company's level of reliance upon regulatory policy or monetary
        incentives (such as subsidies and taxes), actions to influence industry
        policy (such as through lobbying), overall reliance on a favorable
        regulatory environment for business competitiveness, and ability to
        comply with relevant regulations. It may relate to the alignment of
        management and investor views of regulatory engagement and compliance at
        large.|

        |**MATSOURCINGANDEFF**|**Materials Sourcing and Efficiency** - the
        category addresses issues related to the resilience of materials supply
        chains to impacts of climate change and other external environmental and
        social factors. It captures the impacts of such external factors on
        operational activity of suppliers, which can further affect availability
        and pricing of key resources. It addresses a company's ability to manage
        these risks through product design, manufacturing, and end-of-life
        management, such as by using of recycled and renewable materials,
        reducing the use of key materials (dematerialization), maximizing
        resource efficiency in manufacturing, and making R&D investments in
        substitute materials. Additionally, companies can manage these issues by
        screening, selection, monitoring, and engagement with suppliers to
        ensure their resilience to external risks. It does not address issues
        associated with environmental and social externalities created by
        operational activity of individual suppliers, which is covered in a
        separate category.|

        |**PHYIMPACTSOFCLIMATECHG**|**Physical Impacts of Climate Change** - the
        category addresses the company's ability to manage risks and
        opportunities associated with direct exposure of its owned or controlled
        assets and operations to actual or potential physical impacts of climate
        change. It captures environmental and social issues that may arise from
        operational disruptions due to physical impacts of climate change. It
        further captures socioeconomic issues resulting from companies failing
        to incorporate climate change consideration in products and services
        sold, such as insurance policies and mortgages. The category relates to
        the company's ability to adapt to increased frequency and severity of
        extreme weather, shifting climate, sea level risk, and other expected
        physical impacts of climate change. Management may involve enhancing
        resiliency of physical assets and/or surrounding infrastructure as well
        as incorporation of climate change-related considerations into key
        business activities (e.g., mortgage and insurance underwriting, planning
        and development of real estate projects).|

        |**PDANDLIFECYCLEMGT**|**Product Design and Lifecycle Management** - the
        category addresses incorporation of environmental, social, and
        governance (ESG) considerations in characteristics of products and
        services provided or sold by the company. It includes, but is not
        limited to, managing the lifecycle impacts of products and services,
        such as those related to packaging, distribution, use-phase resource
        intensity, and other environmental and social externalities that may
        occur during their use-phase or at the end of life. The category
        captures a company's ability to address customer and societal demand for
        more sustainable products and services as well as to meet evolving
        environmental and social regulation. It does not address direct
        environmental or social impacts of the company's operations nor does it
        address health and safety risks to consumers from product use, which are
        covered in other categories.|

        |**PRODQUALITYANDSFTY**|**Product Quality and Safety** - the category
        addresses issues involving unintended characteristics of products sold
        or services provided that may create health or safety risks to
        end-users. It addresses a company's ability to offer manufactured
        products and/or services that meet customer expectations with respect to
        their health and safety characteristics. It includes, but is not limited
        to, issues involving liability, management of recalls and market
        withdrawals, product testing, and chemicals/content/ ingredient
        management in products.|

        |**SELLPRACANDPRODLABEL**|**Selling Practices and Product Labeling** -
        the category addresses social issues that may arise from a failure to
        manage the transparency, accuracy, and comprehensibility of marketing
        statements, advertising, and labeling of products and services. It
        includes, but is not limited to, advertising standards and regulations,
        ethical and responsible marketing practices, misleading or deceptive
        labeling, as well as discriminatory or predatory selling and lending
        practices. This may include deceptive or aggressive selling practices in
        which incentive structures for employees could encourage the sale of
        products or services that are not in the best interest of customers or
        clients.|

        |**SUPPLYCHAINMGT**|**Supply Chain Management** - the category addresses
        management of environmental, social, and governance (ESG) risks within a
        company's supply chain. It addresses issues associated with
        environmental and social externalities created by suppliers through
        their operational activities. Such issues include, but are not limited
        to, environmental responsibility, human rights, labor practices, and
        ethics and corruption. Management may involve screening, selection,
        monitoring, and engagement with suppliers on their environmental and
        social impacts. The category does not address the impacts of external
        factors – such as climate change and other environmental and social
        factors – on suppliers' operations and/or on the availability and
        pricing of key resources, which is covered in a separate category.|

        |**SYSTEMICRISKMGT**|**Systemic Risk Management** - the category
        addresses the company's contributions to, or management of systemic
        risks resulting from large-scale weakening or collapse of systems upon
        which the economy and society depend. This includes financial systems,
        natural resource systems, and technological systems. It addresses the
        mechanisms a company has in place to reduce its contributions to
        systemic risks and to improve safeguards that may mitigate the impacts
        of systemic failure. For financial institutions, the category also
        captures the company's ability to absorb shocks arising from financial
        and economic stress and meet stricter regulatory requirements related to
        the complexity and interconnectedness of companies in the industry.|

        |**WASTEANDHZRDMATSMGT**|**Waste and Hazardous Materials Management** -
        the category addresses environmental issues associated with hazardous
        and non-hazardous waste generated by companies. It addresses a company's
        management of solid wastes in manufacturing, agriculture, and other
        industrial processes. It covers treatment, handling, storage, disposal,
        and regulatory compliance. The category does not cover emissions to air
        or wastewater, nor does it cover waste from end-of-life of products,
        which are addressed in separate categories.|

        |**WATERANDWASTEWATERMGT**|**Water and Wastewater Management** - the
        category addresses a company's water use, water consumption, wastewater
        generation, and other impacts of operations on water resources, which
        may be influenced by regional differences in the availability and
        quality of and competition for water resources. More specifically, it
        addresses management strategies including, but not limited to, water
        efficiency, intensity, and recycling. Lastly, the category also
        addresses management of wastewater treatment and discharge, including
        groundwater and aquifer pollution.|


        ### Helper Input

        **ALL** = Simply gives the ability to request all categories in a single
        request without having to explicitly list out all 26 in the request.
        *This is not the same as "ALLCATEGORIES" which is a single overall score
        for the company and returned as default.*
      example:
        - AIRQUALITY
        - BUSINESSETHICS
        - HUMANRIGHTSANDCOMRELS
    rankCategories:
      type: array
      default:
        - ALL
      items:
        type: string
      minItems: 1
      maxItems: 2
      description: >
        The Categories representing overall or composite rankings from all
        underlying 26 SASB Categories.


        ### SASB Categories

        |**SASB Category Inputs**|**Description**|

        |||

        |**ALLCATEGORIES**|**All Categories** - The company's overall SASB Rank.
        This value is equal to the cumulative average of all 26 SASB categories.

        |**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/)|


        ### Helper Input

        **ALL** = Simply gives the ability to request all categories in a single
        request without having to explicitly list each available category. 
      example:
        - ALLCATEGORIES
        - MATERIALITY
    frequency:
      type: string
      enum:
        - D
        - W
        - M
        - CY
        - ''
      default: D
      description: |
        Controls the display frequency of the data returned.
          * **D** = Daily
          * **W** = Weekly, based on the last day of the week of the start date.
          * **M** = Monthly, based on the last trading day of the month.
          * **CY** = Calendar Annual, based on the last trading day of the calendar year.
          
    fiscalPeriodStart:
      type: string
      description: >
        Fiscal period start is expressed in YYYY formats. The input start date
        must be before the input end date. Future dates (T+1) are not accepted
        in this endpoint.
      example: '2020'
    fiscalPeriodEnd:
      type: string
      description: >
        Fiscal period end is expressed in YYYY formats. The input start date
        must be before the input end date. Future dates (T+1) are not accepted
        in this endpoint.
      example: '2021'
    indicators:
      type: array
      default:
        - ALL
      items:
        type: string
      description: >
        The indicators are the Principal Adverse Impact (PAI) metrics which
        consists of General, Mandatory and Additional indicators which supports
        the SFDR reporting. The data can also be requested for individual sub
        topic codes in addition to the indicators mentioned below -
          
        |**SFDR PAI Indicators**|**Description**|

        |||

        |**MandatoryIndicators**| Mandatory indicators are the indicators which
        must be reported under the EU Sustainable Finance Disclosure Regulation
        (SFDR).|

        |**AdditionalIndicators**| These are additional environmental and social
        indicators as mentioned in additional tables as provided in the Annex 1
        table in the SFDR RTS report.|

        |**GHGEmissions**| This mandatory indicator includes metrics related to
        greenhouse emissions such as - Scope 1, 2, and 3 emissions, footprint
        and intensity and energy consumption from non-renewable and high climate
        sectors.|

        |**Biodiversity**| This mandatory indicator includes metrics pertaining
        to biodiversity and a company's impacts on biodiversity-sensitive
        areas.|

        |**Water**| This mandatory indicator includes data relating to emissions
        to water as made by the companies.|

        |**Waste**| This mandatory indicator includes data relating to hazardous
        waste as generated by the companies.|

        |**SocialEmployeeMatters**| This mandatory indicator includes
        employee-related metrics like gender diversity, pay gap and
        social-related metrics like violation of UNGC/OECD principles and
        exposure to controversial weapons.|

        |**Emissions**| This additional indicator includes metrics related to
        air pollutants, inorganic pollutants and ozone depleting substance. |

        |**EnergyPerformance**| This additional indicator includes metrics
        related to various sources of non-renewable energy as used by the
        companies. |

        |**WaterWasteMaterialEmissions**| This mandatory indicator includes
        employee-related metrics like gender diversity, pay gap and
        social-related metrics like violation of UNGC/OECD principles and
        exposure to controversial weapons.|

        |**AdditionalEmployeeMatters**| This additional indicator includes
        metrics related to workplace discrimination and safety, whistleblower
        mechanism and supplier code of conduct.|

        |**HumanRights**| This additional indicator includes metrics related to
        both policies and performance of a company in the areas of human rights,
        forced labor and human trafficking.|

        |**AntiCorruptionAntiBribery**| This additional indicator includes data
        related to company violations of anti-corruption and anti-bribery laws,
        and resulting fines.|
      example:
        - Water
        - HumanRights
    fieldsSasbSpotlights:
      title: fields
      type: array
      items:
        type: string
      description: >
        Request available SASB Spotlights data fields to be included in the
        response.
         Default is all fields. _fsymId_,_orgId_, _date_, _spotlightId_, _groupId_ and _requestId_ are always included.
         
          |field|description|
          |||
          |fsymId|Factset Regional Security Identifier|
          |orgId|Unique identifier assigned that is applied on an organization level|
          |spotlightId|Unique identifier assigned identifying a Spotlight ESG event that is detected at the company level, within a single category.|
          |requestId|Identifier that was used for the request.|
          |primaryArticleHeadline|Headline of primary Spotlight article.| 
          |liveDate|Date when a Spotlight meets confidence threshold and is considered a Spotlight. This date should never precede start date.|
      example:
        - spotlightId
        - groupId
    calculation:
      type: boolean
      description: >
        This parameter would return the PAI data based on the input provided.
        All the data for indicators or subtopics requested are returned when the
        input is `true` and the SFDR required metrics are only returned when the
        input is`false`
      default: true
      example: true
    feelback:
      type: boolean
      description: >
        This parameter would return the latest PAI data based on the indicators
        or subtopics requested. The parameter should not be used in conjuction
        `fiscalPeriodStart` and `fiscalPeriodEnd`
      default: false
      example: false
    primaryOnly:
      type: boolean
      description: |
        Return only primary spotlights when set to true
      default: true
      example: true
    fieldsSdgSpotlights:
      title: fields
      type: array
      items:
        type: string
      description: >
        Request available SDG Spotlights data fields to be included in the
        response.

        Default is all fields. _fsymId_,_orgId_, _date_, _spotlightId_,
        _groupId_ and _requestId_ are always included.
         
          |field|description|
          |-|-|
          |orgId|Unique identifier assigned by Truvalue that is applied on an organization level |
          |spotlightId|Unique identifier assigned by Truvalue identifying a Spotlight ESG event that is detected at the company level, within a single category. |
          |orgName|The current name of the organization according to Truvalue (not point-in-time)|
          |groupId|Unique identifier assigned by Truvalue identifying a Spotlight group using the Spotlight ID of the Primary Spotlight. |
          |primarySpotlight|Value indicating the primary Spotlight in a Spotlight Group. It could be either "Yes" or "No".|
          |spotlightCategory|SDG category tagged to each Spotlight.| 
          |status|Indicates status of a spotlight, which can be one of Completed or Ongoing. |
          |removed|Displays the date a Spotlight was removed from the dataset, if it has been removed.| 
          |startDate|Date when a Spotlight has met the volume threshold for Spotlight consideration. Score and volume change metadata are associated with this date.|
          |liveDate|Date when a Spotlight meets confidence threshold and is considered a Spotlight. This date should never precede start_date. |          
          |firstArticleDate|Date of earliest article in the Spotlight as of the Start Date. |
          |finalArticleDate|Date of final article in the Spotlight. This value can change over the course of the Spotlight until the Spotlight is marked as completed.|    
          |organizationalVolumeThreshold| The article volume needed to create a Spotlight, as set by the company's overall volume level classification on the Start Date. | 
          |totalSpotlightVolume|Total number of articles in the Spotlight. This number will change until the Spotlight is marked as completed.|          
          |startDateVolume|Number of articles in the Spotlight on the Start Date when it met the volume threshold. Does not include the number of articles that were added to the Spotlight after the Spotlight Start Date.|
          |primaryArticleSource|Source of the primary article.| 
          |primaryArticleUrl|URL of the primary article.|           
          |primaryArticleHeadline|Headline of primary Spotlight article.|          
          |primaryArticleBulletpoints|Bullet points summarizing the primary article. |
          |meanArtScoreFinalDate|Average score of articles in Spotlight on Final Article Date. This score will continue to change until the Spotlight is marked as completed.|   
          |meanArtScoreStartDate|Average score of articles in Spotlight on Start Date. This score will not change throughout the history of the spotlight.|          
          |meanPulseScore|Average of pulse scores for each day from First Article Date to Final Article Date, including scores for both Start Date and Final Article Date.|
          |primaryArticleSource|Headline of primary Spotlight article.| 
          |pulseBeforeFirstArticle|Pulse score for category at end-of-day on day before the First Article Date. |           
          |pulseOnFinalArticleDate|Pulse score for category at the end-of-day on the Final Article Date.|          
          |pulseOnStartDate|Pulse score for the category at the end-of-day on the Start Date. |
          |zScoreOnFinalDate|Z-score for Spotlight as of Final Article Date. This score will continue to change until the Spotlight is marked as completed.|       
          |zScoreOnStartDate|Z-score for Spotlight as of Start Date. This score will not change throughout the history of the spotlight.|
          |startoutLvlOnFinalDate|Describes if the spotlight is a High, Medium, or Low standout spotlight.  This score will continue to change until the Spotlight is marked as completed.| 
          |startoutLvlOnStartDate|Describes if the spotlight is a High, Medium, or Low standout spotlight.|          
      example:
        - orgId
        - spotlightId
        - status
    isRemoved:
      type: boolean
      description: >
        This parameter would return the spotlights removed in the response(i.e.
        Spotlight is marked as Rejected but has a firstApprovedOnDate))when set
        to `true`

        Only Spotlights that are marked as approved will be returned when set to
        `false`
      default: false
      example: false
    articlesFields:
      title: fields
      type: array
      items:
        type: string
      description: |
        Request available Articles data fields to be included in the response.
         Default is all fields. _fsymId_ and _articleId_ are always included.
         
         <h3>Common Fields</h3> 
          |field|description|
          |||
          |fsymId|Factset Regional Security Identifier|
          |articleId|Unique ID of the article assigned by Truvalue|          
          
         <h3> Articles Fields</h3>
         
          |field|description|
          |||
          |datePub|Publication date of the article expressed in YYYY-MM-DD format|
          |title|Title of the article|
          |source|Source of the article|
          |categories|categories assigned by Truvalue|
          |bullets|AI-generated bullet point summary for each article. Note, including bullets increases response size drastically|
          |author|Author of the article|
          |url|URL of the article|
          |language|Language code of the article|
          |orgName| Organization name assigned by Truvalue|
          |orgId| Unique identifier assigned by Truvalue that is applied on an organization level
          
      example:
        - datePub
    errorResponse:
      type: object
      title: Error Response
      properties:
        status:
          description: status
          type: string
          example: Bad Request
        timestamp:
          description: timestamp in YYYY-MM-DD HH:MM:SS.SSS
          type: string
          example: '2019-11-01 11:09:41.918'
          format: date-time
        path:
          description: The Endpoint path {package}/version/{endpoint}
          type: string
          example: /factset-esg/v1/sasb-scores
        message:
          description: The plain text error message
          type: string
          example: Validation Error
        subErrors:
          description: subErrors related to the error message. Null if not applicable.
          type: object
          nullable: true
          properties:
            object:
              description: the operation ID
              type: string
            field:
              description: Parameter Field Name
              type: string
            message:
              description: Error message
              type: string
            rejectedValue:
              description: Rejected Values in an Array
              type: array
              items:
                type: string
  responses:
    '400':
      description: >-
        Bad Request. This can occur for several reasons. Please review the
        "message" for more details.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/errorResponse'
          examples:
            Bad Request - Date Format:
              $ref: '#/components/examples/badRequestDateFormat'
            Bad Request - Missing Required Parameter:
              $ref: '#/components/examples/badRequestRequiredParameter'
            Bad Request - Future Date:
              $ref: '#/components/examples/badRequestFutureDate'
            Bad Request - Invalid Parameter:
              $ref: '#/components/examples/badRequestInvalidParameters'
            Bad Request - Malformed JSON:
              $ref: '#/components/examples/badRequestMalformedJSON'
            Bad Request - Read Timeout:
              $ref: '#/components/examples/badRequestReadTimeout'
    '401':
      description: >-
        Unauthenticated USERNAME-SERIAL. Ensure you are logged in and have
        successfully generated an API KEY for the IP range you are connecting
        from. For more help, select the **Report Issue** in the top right corner
        of this Developer Portal specification card and choose Connectivity 401
        or 403 Responses.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/errorResponse'
          examples:
            Bad Request - Date Format:
              $ref: '#/components/examples/unauthenticated'
    '403':
      description: >-
        The USERNAME-SERIAL used to request the endpoint is not authorized to
        access it. The request was a legal request, but the server is refusing
        to respond. Please reach out to FactSet Account Team for assistance with
        authorization.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/errorResponse'
          examples:
            Bad Request - Date Format:
              $ref: '#/components/examples/forbidden'
    '408':
      description: >-
        Request Time-Out. This error would be returned if the request takes more
        than 29 seconds.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/errorResponse'
          examples:
            Request Time-Out:
              $ref: '#/components/examples/requestTimeOut'
    '415':
      description: >-
        Unsupported Media Type. This error may be returned when the caller sends
        a resource in a format that is not accepted by the server. This can be
        fixed by ensuring that Content-Type header is set to the correct value.
        In this instance, "application/json" would be the appropriate value.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/errorResponse'
          examples:
            Bad Request - Date Format:
              $ref: '#/components/examples/unsupportedMediaType'
    '500':
      description: Internal Server Error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/errorResponse'
          examples:
            Internal Server Error - Not Writable:
              $ref: '#/components/examples/notWritable'
            Internal Server Error - General Exception:
              $ref: '#/components/examples/generalException'
  examples:
    singleSasbScores:
      summary: Single SASB Score Type for all categories for a Single Entity (AMZN-US).
      description: |
        Results of Amazon.com's (AMZN-US) Pulse Score for all categories.
      value:
        data:
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: ACCESSANDAFFORDABILITY
            sasbScore: 42.0589785474386
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: AIRQUALITY
            sasbScore: 29.8807816941901
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: ALLCATEGORIES
            sasbScore: 49.1044372161141
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: BUSINESSETHICS
            sasbScore: 30.6074308481714
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: BUSMODELRESILIENCE
            sasbScore: 41.8940425184173
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: COMPETITIVEBEHAVIOR
            sasbScore: 32.5921215119197
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: CRITINCIDENTRISKMGT
            sasbScore: 45.3820575553375
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: CUSTOMERPRIVACY
            sasbScore: 54.9645092108536
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: CUSTWELFARE
            sasbScore: 68.5579215857227
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: DATASECURITY
            sasbScore: 35.4099360664856
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: ECOLOGICALIMPACTS
            sasbScore: 51.5562478316789
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: EMPENGDIVANDINC
            sasbScore: 55.6395516005745
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: EMPHEALTHANDSAFETY
            sasbScore: 51.7344801598622
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: ENERGYMGT
            sasbScore: 77.591147035024
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: GHGEMISSIONS
            sasbScore: 56.9085694943306
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: HUMANRIGHTSANDCOMRELS
            sasbScore: 46.5119869803688
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: LABORPRACTICES
            sasbScore: 49.8005302032842
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: MATERIALITY
            sasbScore: 51.6289633279129
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: MATSOURCINGANDEFF
            sasbScore: 59.6849308135668
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: MGTOFLEGALANDREGENV
            sasbScore: 52.3487226050073
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: PDANDLIFECYCLEMGT
            sasbScore: 54.5033074297044
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: PHYIMPACTSOFCLIMATECHG
            sasbScore: 47.376430062074
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: PRODQUALITYANDSFTY
            sasbScore: 47.5437583105162
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: SELLPRACANDPRODLABEL
            sasbScore: 25.1319878766169
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: SUPPLYCHAINMGT
            sasbScore: 57.6323871116413
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: SYSTEMICRISKMGT
            sasbScore:
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbScore: 53.6422678837999
            sasbCategory: WASTEANDHZRDMATSMGT
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: WATERANDWASTEWATERMGT
            sasbScore: 63.2635158281821
            scoreType: PULSE
    multipleSasbScores:
      summary: >-
        Multiple SASB Score Types for multiple categories for multiple entities
        (AMZN-US, TSLA-US).
      description: >
        Results of Amazon.com's (AMZN-US) and Tesla's (TSLA-US) Pulse Score and
        Insight Scores for the GHGEMISSIONS, ENERGYMGT, and AIRQUALITY
        categories as of the end of 2019.
      value:
        data:
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: GHGEMISSIONS
            sasbScore: 56.9085694943306
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: ENERGYMGT
            sasbScore: 77.591147035024
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: AIRQUALITY
            sasbScore: 31.7995775552977
            scoreType: INSIGHT
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: GHGEMISSIONS
            sasbScore: 58.2256095507061
            scoreType: INSIGHT
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            sasbCategory: ENERGYMGT
            sasbScore: 77.5417217969538
            scoreType: INSIGHT
          - date: '2019-12-31'
            fsymId: 006XY7-E
            requestId: TSLA-US
            sasbCategory: AIRQUALITY
            sasbScore: 23.2905772623506
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 006XY7-E
            requestId: TSLA-US
            sasbCategory: GHGEMISSIONS
            sasbScore: 45.4393012313057
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 006XY7-E
            requestId: TSLA-US
            sasbCategory: ENERGYMGT
            sasbScore: 72.9857842933469
            scoreType: PULSE
          - date: '2019-12-31'
            fsymId: 006XY7-E
            requestId: TSLA-US
            sasbCategory: AIRQUALITY
            sasbScore: 45.1584395022811
            scoreType: INSIGHT
          - date: '2019-12-31'
            fsymId: 006XY7-E
            requestId: TSLA-US
            sasbCategory: GHGEMISSIONS
            sasbScore: 62.7899213017756
            scoreType: INSIGHT
          - date: '2019-12-31'
            fsymId: 006XY7-E
            requestId: TSLA-US
            sasbCategory: ENERGYMGT
            sasbScore: 72.5839570199912
            scoreType: INSIGHT
    multipleSasbRanks:
      summary: ESG Ranks for a small list of companies
      description: >
        The Materiality ESG Rank for a list of companies with different Rank
        Values.
      value:
        - date: '2021-03-17'
          fsymId: 000Y35-E
          requestId: UDR
          sasbCategory: MATERIALITY
          sasbRank: Leader
        - date: '2021-03-17'
          fsymId: 0DX8BF-E
          requestId: QRVO
          sasbCategory: MATERIALITY
          sasbRank: Above Average
        - date: '2021-03-17'
          fsymId: 0BTZL3-E
          requestId: PLD
          sasbCategory: MATERIALITY
          sasbRank: Average
        - date: '2021-03-17'
          fsymId: 000T4W-E
          requestId: PH
          sasbCategory: MATERIALITY
          sasbRank: Below Average
        - date: '2021-03-17'
          fsymId: 0018R5-E
          requestId: EIX
          sasbCategory: MATERIALITY
          sasbRank: Laggard
    singleSasbScoresAll:
      summary: All SASB Score Types for a Single Entity (AMZN-US).
      description: |
        Results of all of Amazon.com's (AMZN-US) score types for all categories.
      value:
        data:
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            scoreType: PULSE
            accessAndAffordability: 42.0589785474386
            airQuality: 29.8807816941901
            allCategories: 49.1044372161141
            businessEthics: 30.6074308481714
            businessModelResilience: 41.8940425184173
            competitiveBehavior: 32.5921215119197
            criticalIncidentRiskManagement: 45.3820575553375
            customerPrivacy: 54.9645092108536
            customerWelfare: 68.5579215857227
            dataSecurity: 35.4099360664856
            ecologicalImpacts: 51.5562478316789
            employeeEngagementDiversityandInclusion: 55.6395516005745
            employeeHealthAndSafety: 51.7344801598622
            energyManagement: 77.591147035024
            gHGEmissions: 56.9085694943306
            humanRightsandCommunityRelations: 46.5119869803688
            laborPractices: 49.8005302032842
            managementOfTheLegalAndRegulatoryEnvironment: 52.3487226050073
            materialsSourcingAndEfficiency: 59.6849308135668
            materiality: 51.6289633279129
            physicalImpactsOfClimateChange: 47.376430062074
            productQualityAndSafety: 47.5437583105162
            productDesignAndLifecycleManagement: 54.5033074297044
            sellingPracticesAndProductLabeling: 25.1319878766169
            supplyChainManagement: 57.6323871116413
            systemicRiskManagement:
            wasteAndHazardousMaterialsManagement: 53.6422678837999
            waterAndWastewaterManagement: 63.2635158281821
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            scoreType: INSIGHT
            accessAndAffordability: 45.2871164055503
            airQuality: 31.7995775552977
            allCategories: 48.7784015048572
            businessEthics: 29.0595391537146
            businessModelResilience: 41.4267562646694
            competitiveBehavior: 37.4310702369829
            criticalIncidentRiskManagement: 47.1770323345133
            customerPrivacy: 51.0466308185259
            customerWelfare: 65.6088869939384
            dataSecurity: 36.4144549087561
            ecologicalImpacts: 53.5198334703469
            employeeEngagementDiversityandInclusion: 51.6211555985687
            employeeHealthAndSafety: 51.9969732000783
            energyManagement: 77.5417217969538
            gHGEmissions: 58.2256095507061
            humanRightsandCommunityRelations: 47.6520630159677
            laborPractices: 47.9135370248821
            managementOfTheLegalAndRegulatoryEnvironment: 53.2891571822248
            materialsSourcingAndEfficiency: 59.6136703395178
            materiality: 52.3074861591898
            physicalImpactsOfClimateChange: 49.067304640778
            productQualityAndSafety: 47.0751290440629
            productDesignAndLifecycleManagement: 55.6433670734186
            sellingPracticesAndProductLabeling: 34.8744853568419
            supplyChainManagement: 56.2935849114148
            systemicRiskManagement:
            wasteAndHazardousMaterialsManagement: 49.1669278931352
            waterAndWastewaterManagement: 44.0074903798373
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            scoreType: MOMENTUM
            accessAndAffordability: 50
            airQuality: 24.8262326920412
            allCategories: 46.7777287484055
            businessEthics: 33.2682039474115
            businessModelResilience: 50
            competitiveBehavior: 32.1865983125787
            criticalIncidentRiskManagement: 61.5357494698256
            customerPrivacy: 28.7074089851989
            customerWelfare: 61.6697407422535
            dataSecurity: 50
            ecologicalImpacts: 78.5195686624825
            employeeEngagementDiversityandInclusion: 37.0389720339055
            employeeHealthAndSafety: 24.2999555887815
            energyManagement: 30.3251167845643
            gHGEmissions: 47.5390445469897
            humanRightsandCommunityRelations: 76.9501040784801
            laborPractices: 50
            managementOfTheLegalAndRegulatoryEnvironment: 39.1407213276058
            materialsSourcingAndEfficiency: 72.9422492651727
            materiality: 64.7142418727952
            physicalImpactsOfClimateChange: 76.6818333600152
            productQualityAndSafety: 38.0139492743302
            productDesignAndLifecycleManagement: 66.1257090033607
            sellingPracticesAndProductLabeling: 33.1926899781698
            supplyChainManagement: 50
            systemicRiskManagement:
            wasteAndHazardousMaterialsManagement: 80.0173364413861
            waterAndWastewaterManagement: 81.6948955578184
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            scoreType: CAT_VOL_TTM
            accessAndAffordability: 179
            airQuality: 36
            allCategories: 13447
            businessEthics: 536
            businessModelResilience: 40
            competitiveBehavior: 2059
            criticalIncidentRiskManagement: 134
            customerPrivacy: 886
            customerWelfare: 285
            dataSecurity: 1047
            ecologicalImpacts: 109
            employeeEngagementDiversityandInclusion: 628
            employeeHealthAndSafety: 454
            energyManagement: 816
            gHGEmissions: 1043
            humanRightsandCommunityRelations: 109
            laborPractices: 2093
            managementOfTheLegalAndRegulatoryEnvironment: 786
            materialsSourcingAndEfficiency: 45
            materiality: 3850
            physicalImpactsOfClimateChange: 11
            productQualityAndSafety: 499
            productDesignAndLifecycleManagement: 473
            sellingPracticesAndProductLabeling: 188
            supplyChainManagement: 827
            systemicRiskManagement: 0
            wasteAndHazardousMaterialsManagement: 98
            waterAndWastewaterManagement: 66
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            scoreType: ART_VOL_TTM
            accessAndAffordability:
            airQuality:
            allCategories: 9861
            businessEthics:
            businessModelResilience:
            competitiveBehavior:
            criticalIncidentRiskManagement:
            customerPrivacy:
            customerWelfare:
            dataSecurity:
            ecologicalImpacts:
            employeeEngagementDiversityandInclusion:
            employeeHealthAndSafety:
            energyManagement:
            gHGEmissions:
            humanRightsandCommunityRelations:
            laborPractices:
            managementOfTheLegalAndRegulatoryEnvironment:
            materialsSourcingAndEfficiency:
            materiality: 3529
            physicalImpactsOfClimateChange:
            productQualityAndSafety:
            productDesignAndLifecycleManagement:
            sellingPracticesAndProductLabeling:
            supplyChainManagement:
            systemicRiskManagement:
            wasteAndHazardousMaterialsManagement:
            waterAndWastewaterManagement:
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            scoreType: DYNAMIC_MAT
            accessAndAffordability: 1.33115192979847
            airQuality: 0.267717706551647
            allCategories:
            businessEthics: 3.98601918643564
            businessModelResilience: 0.297464118390719
            competitiveBehavior: 15.3119654941623
            criticalIncidentRiskManagement: 0.996504796608909
            customerPrivacy: 6.58883022235443
            customerWelfare: 2.11943184353387
            dataSecurity: 7.78612329887707
            ecologicalImpacts: 0.81058972261471
            employeeEngagementDiversityandInclusion: 4.67018665873429
            employeeHealthAndSafety: 3.37621774373466
            energyManagement: 6.06826801517067
            gHGEmissions: 7.756376887038
            humanRightsandCommunityRelations: 0.81058972261471
            laborPractices: 15.5648099947944
            managementOfTheLegalAndRegulatoryEnvironment: 5.84516992637763
            materialsSourcingAndEfficiency: 0.334647133189559
            materiality:
            physicalImpactsOfClimateChange: 0.0818026325574478
            productQualityAndSafety: 3.71086487692422
            productDesignAndLifecycleManagement: 3.51751319997025
            sellingPracticesAndProductLabeling: 1.39808135643638
            supplyChainManagement: 6.15007064772812
            systemicRiskManagement: 0
            wasteAndHazardousMaterialsManagement: 0.728787090057262
            waterAndWastewaterManagement: 0.490815795344687
    multipleSasbScoresAll:
      summary: Multiple SASB Score Types Multiple Entities (AMZN-US, TSLA-US).
      description: >
        Results of Amazon.com's (AMZN-US) and Tesla's (TSLA-US) Pulse & Insight
        Scores for all categories.
      value:
        data:
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            scoreType: PULSE
            accessAndAffordability: 42.0589785474386
            airQuality: 29.8807816941901
            allCategories: 49.1044372161141
            businessEthics: 30.6074308481714
            businessModelResilience: 41.8940425184173
            competitiveBehavior: 32.5921215119197
            criticalIncidentRiskManagement: 45.3820575553375
            customerPrivacy: 54.9645092108536
            customerWelfare: 68.5579215857227
            dataSecurity: 35.4099360664856
            ecologicalImpacts: 51.5562478316789
            employeeEngagementDiversityandInclusion: 55.6395516005745
            employeeHealthAndSafety: 51.7344801598622
            energyManagement: 77.591147035024
            gHGEmissions: 56.9085694943306
            humanRightsandCommunityRelations: 46.5119869803688
            laborPractices: 49.8005302032842
            managementOfTheLegalAndRegulatoryEnvironment: 52.3487226050073
            materialsSourcingAndEfficiency: 59.6849308135668
            materiality: 51.6289633279129
            physicalImpactsOfClimateChange: 47.376430062074
            productQualityAndSafety: 47.5437583105162
            productDesignAndLifecycleManagement: 54.5033074297044
            sellingPracticesAndProductLabeling: 25.1319878766169
            supplyChainManagement: 57.6323871116413
            systemicRiskManagement:
            wasteAndHazardousMaterialsManagement: 53.6422678837999
            waterAndWastewaterManagement: 63.2635158281821
          - date: '2019-12-31'
            fsymId: 001MF1-E
            requestId: AMZN-US
            scoreType: INSIGHT
            accessAndAffordability: 45.2871164055503
            airQuality: 31.7995775552977
            allCategories: 48.7784015048572
            businessEthics: 29.0595391537146
            businessModelResilience: 41.4267562646694
            competitiveBehavior: 37.4310702369829
            criticalIncidentRiskManagement: 47.1770323345133
            customerPrivacy: 51.0466308185259
            customerWelfare: 65.6088869939384
            dataSecurity: 36.4144549087561
            ecologicalImpacts: 53.5198334703469
            employeeEngagementDiversityandInclusion: 51.6211555985687
            employeeHealthAndSafety: 51.9969732000783
            energyManagement: 77.5417217969538
            gHGEmissions: 58.2256095507061
            humanRightsandCommunityRelations: 47.6520630159677
            laborPractices: 47.9135370248821
            managementOfTheLegalAndRegulatoryEnvironment: 53.2891571822248
            materialsSourcingAndEfficiency: 59.6136703395178
            materiality: 52.3074861591898
            physicalImpactsOfClimateChange: 49.067304640778
            productQualityAndSafety: 47.0751290440629
            productDesignAndLifecycleManagement: 55.6433670734186
            sellingPracticesAndProductLabeling: 34.8744853568419
            supplyChainManagement: 56.2935849114148
            systemicRiskManagement:
            wasteAndHazardousMaterialsManagement: 49.1669278931352
            waterAndWastewaterManagement: 44.0074903798373
          - date: '2019-12-31'
            fsymId: 006XY7-E
            requestId: TSLA-US
            scoreType: PULSE
            accessAndAffordability: 19.8991633890875
            airQuality: 23.2905772623506
            allCategories: 52.911737113525
            businessEthics: 39.1211782302831
            businessModelResilience: 29.7721106372505
            competitiveBehavior: 50.4163483764114
            criticalIncidentRiskManagement: 26.8680863668702
            customerPrivacy: 29.3258749542644
            customerWelfare: 51.9969085864493
            dataSecurity: 36.0419540845249
            ecologicalImpacts: 58.4672518855912
            employeeEngagementDiversityandInclusion: 31.5304369602106
            employeeHealthAndSafety: 33.8344297008399
            energyManagement: 72.9857842933469
            gHGEmissions: 45.4393012313057
            humanRightsandCommunityRelations: 31.4577788341291
            laborPractices: 28.4284955943267
            managementOfTheLegalAndRegulatoryEnvironment: 58.1750427526841
            materialsSourcingAndEfficiency: 53.7706963321778
            materiality: 55.1032983481847
            physicalImpactsOfClimateChange: 73.0899461856753
            productQualityAndSafety: 53.0673269450418
            productDesignAndLifecycleManagement: 62.9524015035917
            sellingPracticesAndProductLabeling: 32.1878644936152
            supplyChainManagement: 55.4715119699682
            systemicRiskManagement:
            wasteAndHazardousMaterialsManagement: 63.0462307469371
            waterAndWastewaterManagement: 47.2180030410809
          - date: '2019-12-31'
            fsymId: 006XY7-E
            requestId: TSLA-US
            scoreType: INSIGHT
            accessAndAffordability: 36.4339936031108
            airQuality: 45.1584395022811
            allCategories: 51.3621892900637
            businessEthics: 30.9860551027365
            businessModelResilience: 41.9063658537357
            competitiveBehavior: 39.9719556600142
            criticalIncidentRiskManagement: 25.584323436216
            customerPrivacy: 58.1473132918238
            customerWelfare: 59.2795705239299
            dataSecurity: 37.9864063258869
            ecologicalImpacts: 52.274389565693
            employeeEngagementDiversityandInclusion: 45.6471849328826
            employeeHealthAndSafety: 42.0435844871342
            energyManagement: 72.5839570199912
            gHGEmissions: 62.7899213017756
            humanRightsandCommunityRelations: 34.5859534881831
            laborPractices: 40.4730274799731
            managementOfTheLegalAndRegulatoryEnvironment: 57.0361222386219
            materialsSourcingAndEfficiency: 59.0092142170228
            materiality: 56.5677841347743
            physicalImpactsOfClimateChange: 55.5433477881575
            productQualityAndSafety: 46.2418059689498
            productDesignAndLifecycleManagement: 61.7418966064751
            sellingPracticesAndProductLabeling: 29.311099521335
            supplyChainManagement: 58.6354828109347
            systemicRiskManagement:
            wasteAndHazardousMaterialsManagement: 40.8339619234545
            waterAndWastewaterManagement: 43.0869678105995
    singleSasbScoresAllPost:
      summary: All SASB Score Types for a Single Entity (AMZN-US).
      description: Post request body example to fetch all SASB Score types for AMZN-US.
      value:
        ids:
          - AMZN-US
        scoreTypes:
          - ALL
        startDate: '2019-12-31'
        endDate: '2019-12-31'
        frequency: D
        calendar: SEVENDAY
    multipleSasbScoresPost:
      summary: >-
        Multiple SASB Scores Types with Multiple SASB Categories for Multiple
        Entities (FDS-US, TSLA-US, AAPL-US).
      description: >-
        Post request body example to fetch Pulse, Insight, and Momentum Scores
        of the FDS-US, TSLA-US, AAPL-US for the HUMANRIGHTSANDCOMRELS,
        SUPPLYCHAINMGT, and ENERGYMGT categories as of 2019.
      value:
        ids:
          - FDS-US
          - TSLA-US
          - AAPL-US
        scoreTypes:
          - PULSE
          - INSIGHT
          - MOMENTUM
        categories:
          - HUMANRIGHTSANDCOMRELS
          - SUPPLYCHAINMGT
          - ENERGYMGT
        startDate: '2019-12-31'
        endDate: '2019-12-31'
        frequency: D
        calendar: SEVENDAY
    singleSasbScoresPost:
      summary: Single SASB Score Type for all categories for a Single Entity (AMZN-US).
      description: Post request body example to fetch all Pulse Scores for AMZN-US.
      value:
        ids:
          - AMZN-US
        scoreTypes:
          - PULSE
        startDate: '2019-12-31'
        endDate: '2019-12-31'
        frequency: D
        calendar: SEVENDAY
    multipleSasbScoresAllPost:
      summary: >-
        Multiple SASB Scores Types with Multiple SASB Categories for (FDS-US),
        (TSLA-US), and (AAPL-US).
      description: >-
        Post request body example to fetch Pulse, Insight, and Momentum Scores
        of the FDS-US, TSLA-US, AAPL-US for the [HUMANRIGHTSANDCOMRELS],
        [SUPPLYCHAINMGT], and [ENERGYMGT] categories as of 2019.
      value:
        ids:
          - FDS-US
          - TSLA-US
          - AAPL-US
        scoreTypes:
          - PULSE
          - INSIGHT
          - MOMENTUM
        categories:
          - HUMANRIGHTSANDCOMRELS
          - SUPPLYCHAINMGT
          - ENERGYMGT
        startDate: '2019-12-31'
        endDate: '2019-12-31'
        frequency: D
        calendar: SEVENDAY
    singleSdgScores:
      summary: Single Score Type for all SDG categories for a single entity (AMZN-US).
      description: Results for Amazon.com's SDG scores for Pulse Scores.
      value:
        - date: '2020-05-02'
          fsymId: 001MF1-E
          requestId: AMZN-US
          scoreType: PULSE
          impact: 52.9
          goal1NoPoverty: 37.1
          goal2ZeroHunger: 57.25
          goal3GoodHealthAndWellbeing: 34.47
          goal4QualityEducation: 68.59
          goal5GenderEquality: 24.99
          goal6CleanWaterAndSanitation: 51.56
          goal7AffordableAndCleanEnergy: 83.75
          goal8DecentWorkAndEconomicGrowth: 54.68
          goal9IndustryInnovationAndInfrastructure: 50
          goal10ReducedInequalities: 49.37
          goal11SustainableCitiesAndCommunities: 42.78
          goal12ResponsibleConsumptionAndProduction: 54.6
          goal13ClimateAction: 59.23
          goal14LifeBelowWater: 64.58
          goal15LifeOnLand: 72.88
          goal16PeaceJusticeAndStrongInstitutions: 41.57
    multipleSdgScores:
      summary: >-
        Multiple Score Types for 4 SDG categories for multiple entities
        (AMZN-US, TSLA-US).
      description: >-
        Results for Amazon.com & Tesla's Pulse, Insight, and Momentum Scores for
        4 SDG categories.
      value:
        - date: '2020-05-02'
          fsymId: 001MF1-E
          requestId: AMZN-US
          scoreType: PULSE
          goal1NoPoverty: 37.1
          goal2ZeroHunger: 57.25
          goal3GoodHealthAndWellbeing: 34.47
          goal4QualityEducation: 68.59
        - date: '2020-05-02'
          fsymId: 001MF1-E
          requestId: AMZN-US
          scoreType: INSIGHT
          goal1NoPoverty: 43
          goal2ZeroHunger: 60.24
          goal3GoodHealthAndWellbeing: 33.28
          goal4QualityEducation: 67.38
        - date: '2020-05-02'
          fsymId: 001MF1-E
          requestId: AMZN-US
          scoreType: MOMENTUM
          goal1NoPoverty: 35.8
          goal2ZeroHunger: 20.81
          goal3GoodHealthAndWellbeing: 35.33
          goal4QualityEducation: 50
        - date: '2020-05-02'
          fsymId: 006XY7-E
          requestId: TSLA-US
          scoreType: PULSE
          goal1NoPoverty: 44.46
          goal2ZeroHunger: 39.89
          goal3GoodHealthAndWellbeing: 38.93
          goal4QualityEducation: 69.24
        - date: '2020-05-02'
          fsymId: 006XY7-E
          requestId: TSLA-US
          scoreType: INSIGHT
          goal1NoPoverty: 39.77
          goal2ZeroHunger: 54.73
          goal3GoodHealthAndWellbeing: 39.98
          goal4QualityEducation: 64.87
        - date: '2020-05-02'
          fsymId: 006XY7-E
          requestId: TSLA-US
          scoreType: MOMENTUM
          goal1NoPoverty: 79.1
          goal2ZeroHunger: 23.25
          goal3GoodHealthAndWellbeing: 56.71
          goal4QualityEducation: 62.98
    singleSdgScoresPost:
      summary: Single Score Type for all SDG categories for a single entity (AMZN-US).
      description: >-
        Post Body Request Example to fetch Pulse SDG Scores for all SDG
        categories for Amazon.com (AMZN-US).
      value:
        data:
          ids:
            - AMZN-US
          scoreTypes:
            - PULSE
          categories:
            - IMPACT,
            - GOAL1NOPOVERTY,
            - GOAL2ZEROHUNGER,
            - GOAL3GOODHEALTHANDWELLBEING,
            - GOAL4QUALITYEDUCATION,
            - GOAL5GENDEREQUALITY,
            - GOAL6CLEANWATERANDSANITATION,
            - GOAL7AFFORDABLEANDCLEANENERGY,
            - GOAL8DECENTWORKANDECONOMICGROWTH,
            - GOAL9INDUSTRYINNOVATIONANDINFRASTRUCTURE,
            - GOAL10REDUCEDINEQUALITIES,
            - GOAL11SUSTAINABLECITIESANDCOMMUNITIES,
            - GOAL12RESPONSIBLECONSUMPTIONANDPRODUCTION,
            - GOAL13CLIMATEACTION,
            - GOAL14LIFEBELOWWATER,
            - GOAL15LIFEONLAND,
            - GOAL16PEACEJUSTICEANDSTRONGINSTITUTIONS
          startDate:
            - '2020-05-02'
          endDate:
            - '2020-05-02'
          frequency:
            - D
    multipleSdgScoresPost:
      summary: >-
        Multiple Score Types for 4 SDG categories for multiple entities
        (AMZN-US, TSLA-US).
      description: >-
        Post Body Request Example to fetch Pulse, Insight, and Momentum Scores
        for 4 SDG categories (GOAL1NOPOVERTY, GOAL2ZEROHUNGER,
        GOAL3GOODHEALTHANDWELLBEING, GOAL4QUALITYEDUCATION) for multiple
        entities (AMZN-US, TSLA-US).
      value:
        data:
          ids:
            - AMZN-US,
            - TSLA-US
          scoreTypes:
            - PULSE,
            - IMPULSE,
            - MOMENTUM
          categories:
            - GOAL1NOPOVERTY,
            - GOAL2ZEROHUNGER,
            - GOAL3GOODHEALTHANDWELLBEING,
            - GOAL4QUALITYEDUCATION
          startDate:
            - '2020-05-02'
          endDate:
            - '2020-05-02'
          frequency:
            - D
    badRequestDateFormat:
      summary: Bad Request - Date Format
      description: >-
        This bad request occurs when a request doesn't use the YYYY-MM-DD in the
        date parameters. To resolve, convert your date to YYYY-MM-DD.
      value:
        status: Bad Request
        timestamp: '2019-10-31 16:08:07.945'
        path: /factset-esg/v1/{endpoint}
        message: >-
          The date parameter 'startDate' must be in the following date format:
          YYYY-MM-DD
        subErrors:
    badRequestRequiredParameter:
      summary: Bad Request - Required Parameter Missing
      description: >-
        This error message occurs when the request does not include the required
        parameters. Required parameters are indicated with a red asterisks
        symbol in the specification file.
      value:
        status: Bad Request
        timestamp: '2020-06-12 15:48:42.016'
        path: /factset-esg/v1/{endpoint}
        message: The parameter 'ids' is required and may not be empty.
        subErrors:
    badRequestFutureDate:
      summary: Bad Request - Future Date
      description: >-
        This error message occurs when a future date is requested in the
        startDate and endDate parameters. Please revise your request to include
        dates as of today's current date or any prior historical date.
      value:
        status: Bad Request
        timestamp: '2020-06-12 15:52:48.091'
        path: /factset-esg/v1/{endpoint}
        message: >-
          The use of future dates is not applicable in this endpoint. Please
          revise your request to include dates up to today's current date.
        subErrors:
    badRequestInvalidParameters:
      summary: Bad Request - Invalid Parameters
      description: >-
        This error message occurs when a request parameter is used in which is
        not recognized by the service. Please revise your request to include
        only the parameters listed in the specification. Typical causes are
        spelling mistakes and use of improper casing.
      value:
        status: Bad Request
        timestamp: '2020-06-12 15:58:54.068'
        path: /factset-esg/v1/{endpoint}
        message: >-
          Invalid Parameter (s): fakeParameterName1 fakeParameterName2. Please
          modify your request to use parameters outlined in the specification
          for this endpoint.
        subErrors:
    badRequestMalformedJSON:
      summary: Bad Request - Malformed JSON Request
      description: >-
        This error may be returned when the request body is specified as JSON,
        but is not in proper JSON format.
      value:
        status: Bad Request
        timestamp: '2019-11-05 09:48:29.18'
        path: /factset-esg/v1/{endpoint}
        message: Malformed JSON Request
        subErrors:
    badRequestReadTimeout:
      summary: Bad Request - Read Timeout
      description: >-
        This error may be returned if it takes more than 29 seconds to hear back
        from the data fetch service.
      value:
        status: Bad Request
        timestamp: '2019-11-04 16:18:38.949'
        path: /factset-esg/v1/{endpoint}
        message: The request took too long. Try again with a smaller request.
        subErrors:
    unauthenticated:
      summary: User Authentication Failed
      description: >-
        This occurs when a user is not properly authenticated or recognized by
        the service. Please double check the USERNAME-SERIAL and API-Key used to
        request and ensure you are within the IP range specified for the Key.
        Report Issue under 401 error for help with troubleshooting.
      value:
        status: User Authentication Failed
        timestamp: '2019-10-31 16:08:07.945'
        path: /factset-esg/v1/{endpoint}
        message: User Authentication Failed.
        subErrors:
    forbidden:
      summary: Forbidden
      description: >-
        The USERNAME-SERIAL used to request the endpoint is not authorized to
        access it. The request was a legal request, but the server is refusing
        to respond. Please reach out to FactSet Account Team for assistance with
        authorization.
      value:
        status: Forbidden
        timestamp: '2020-06-12 16:08:51.731'
        path: /factset-esg/v1/{endpoint}
        message: >-
          USERNAME-SERIAL does not have permission to use
          /factset-esg/v1/{endpoint}
        subErrors:
    unsupportedMediaType:
      summary: Unsupported Media Type
      description: >-
        This bad request occurs when the media type passed in the request is not
        supported. Currently the APIs only support 'application/json'.
      value:
        status: Unsupported Media Type
        timestamp: '2019-11-05 09:42:27.237'
        path: /factset-esg/v1/{endpoint}
        message: >-
          text/html media type is not supported. Supported media types are
          application/json
        subErrors:
    requestTimeOut:
      summary: Request Time Out
      description: >-
        Request Time-Out. This error would be returned if the request takes more
        than 29 seconds.
      value:
        status: Request Time Out
        timestamp: '2019-11-05 09:42:27.237'
        path: /factset-esg/v1/{endpoint}
        message: The request took too long. Try again with a smaller request.
        subErrors:
    notWritable:
      summary: Internal Server Error - Not Writable
      description: >-
        This error may be returned when the server encounters an error writing
        the JSON response.
      value:
        status: Internal Server Error
        timestamp: '2019-11-05 09:48:29.18'
        path: /factset-esg/v1/{endpoint}
        message: Error writing JSON output
        subErrors:
    generalException:
      summary: Internal Server Error - General Exception
      description: >-
        This is the most general error that can be returned to by the service.
        Please `Report Issue` to FactSet.
      value:
        status: Internal Server Error
        timestamp: '2019-11-01 10:36:01.944'
        path: /factset-esg/v1/{endpoint}
        message: Unexpected error
        subErrors: