FactSet Stocks API for Digital Portals

Search for equity instruments based on stock-specific parameters, request EOD benchmark key figures and selected fundamentals (end of fiscal year and potential daily updates).

OpenAPI Specification

factset-stocks-api-for-digital-portals-openapi.yml Raw ↑
openapi: 3.0.0
info:
  title: FactSet Stocks API for Digital Portals
  description: |-

    Search for equity instruments based on stock-specific parameters, request
    EOD benchmark key figures and selected fundamentals (end of fiscal year
    and potential daily updates).
  version: '2'
servers:
  - url: https://api.factset.com/wealth/v1
paths:
  /company/keyItems/current/getByInstrument:
    post:
      tags:
        - Company
        - Keys
        - Items
        - Current
        - Instruments
      operationId: post/company/keyItems/current/getByInstrument
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: Fundamentals for a stock with potentially daily updates.
      description: >-
        Fundamentals for a stock with potentially daily updates; any other
        instrument yields empty values for stock-specific attributes. The price
        used to calculate the various price-dependent figures is unspecified and
        the exchange for that price is not identified. Dates are interpreted in
        the timezone of the data provider. For reported company fundamentals of
        the previous fiscal years (only closed fiscal years) see endpoint
        `/company/keyItems/fiscalYear/listByInstrument.`
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/PostCompanyKeyItemsCurrentGetByInstrumentRequest
      responses:
        '200':
          $ref: >-
            #/components/responses/PostCompanyKeyItemsCurrentGetByInstrument200Response
      parameters: []
  /company/keyItems/fiscalYear/listByInstrument:
    post:
      tags:
        - Company
        - Keys
        - Items
        - Fiscal
        - Year
        - Instruments
      operationId: post/company/keyItems/fiscalYear/listByInstrument
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: >-
        Selected fundamentals for a stock with values as of the end of a fiscal
        year.
      description: >-
        Selected fundamentals for a stock with values as of the end of a fiscal
        year; any other instrument yields empty values for stock-specific
        attributes. The endpoint allows the retrieval of data only for specified
        fiscal years by using the start and end properties. Since a fiscal year
        and a calendar year do not necessarily match with regard to their start
        and end dates, the year is derived as the calendar year occupied to a
        larger extent by the fiscal year, using a June through May fiscal year
        assignment. That means, fiscal years ending from the 1st of June onwards
        are assigned to the same calendar year. Dates are interpreted in the
        timezone of the location of the head office of the company.
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/PostCompanyKeyItemsFiscalYearListByInstrumentRequest
      responses:
        '200':
          $ref: >-
            #/components/responses/PostCompanyKeyItemsFiscalYearListByInstrument200Response
      parameters: []
  /company/estimates/listByInstrument:
    post:
      tags:
        - Company
        - Estimates
        - Instruments
      operationId: post/company/estimates/listByInstrument
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      description: >-
        Fiscal year estimates for selected figures of a stock. Data is available
        only for common shares; instruments such as preferred shares or
        depository receipts yield an empty result. For the share type, see
        endpoint `/instrument/category/list` using dataset 23. Data can be
        retrieved only for the current, the past, and three future fiscal years.
        For past fiscal years, the estimates are not being replaced by the
        reported figures. Since a fiscal year and a calendar year do not
        necessarily match with regard to their start and end dates, the year is
        derived as the calendar year occupied to a larger extent by the fiscal
        year, using a June through May fiscal year assignment. That means,
        fiscal years ending from the 1st of June onwards are assigned to the
        same calendar year. Dates are interpreted in the timezone of the
        location of the head office of the company.
      summary: Estimates for selected figures for a stock.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCompanyEstimatesListByInstrumentRequest'
      responses:
        '200':
          $ref: >-
            #/components/responses/PostCompanyEstimatesListByInstrument200Response
      parameters: []
  /stock/recommendation/aggregate/get:
    get:
      tags:
        - Stock
        - Recommendations
        - Aggregate
      operationId: get/stock/recommendation/aggregate/get
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: Target price and aggregated recommendations for a stock.
      description: Target price and aggregated recommendations for a stock.
      parameters:
        - name: identifier
          in: query
          schema:
            type: string
            pattern: >-
              ^([B-DF-HJ-NP-TV-Z0-9]{6}-[SLR])|([A-Z0-9.]{1,47}-[A-Z0-9]{2,4})|([0-9]{3,20})|([B-DF-HJ-NP-TV-Z0-9]{6}[0-9])|([A-Z]{2}[A-Z0-9]{9}[0-9])|([A-Z1-9][A-Z0-9]{5})|(0*[0-9]{1,9})|([A-Z0-9]{8}[0-9])$
            maxLength: 50
            exclusiveMaximum: false
            minLength: 3
            exclusiveMinimum: false
            description: Identifier to resolve.
          required: true
        - name: identifierType
          in: query
          schema:
            type: string
            description: Type of the identifier.
            x-enum-description:
              - MDG identifier of an instrument.
              - MDG identifier of a listing.
              - FactSet Permanent Identifier on security level.
              - FactSet Permanent Identifier on listing level.
              - Regional FactSet Permanent Identifier.
              - FactSet market symbol of a listing.
              - Regional FactSet ticker symbol.
              - SEDOL or IDII of a listing.
              - ISIN of an instrument.
              - WKN of an instrument.
              - Valor number of an instrument.
              - CUSIP or CINS identifier of an instrument
            enum:
              - idInstrument
              - idNotation
              - fdsPermanentIdentifierSecurity
              - fdsPermanentIdentifierListing
              - fdsPermanentIdentifierRegional
              - tickerExchange
              - tickerRegion
              - sedol
              - isin
              - wkn
              - valor
              - cusip
          required: true
        - name: _attributes
          in: query
          schema:
            type: array
            items:
              type: string
              maxLength: 100
              exclusiveMaximum: false
            uniqueItems: true
            maxItems: 50
          style: form
          explode: false
          description: Limit the attributes returned in the response to the specified set.
      responses:
        '200':
          $ref: '#/components/responses/GetStockRecommendationAggregateGet200Response'
  /stock/recommendation/aggregate/history/list:
    get:
      tags:
        - Stock
        - Recommendations
        - Aggregate
        - History
      operationId: get/stock/recommendation/aggregate/history/list
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: >-
        Current and historical trade recommendations and target prices for a
        stock.
      description: >-
        Current and historical trade recommendations and target prices for a
        stock.
      parameters:
        - name: identifier
          in: query
          schema:
            type: string
            pattern: >-
              ^([B-DF-HJ-NP-TV-Z0-9]{6}-[SLR])|([A-Z0-9.]{1,47}-[A-Z0-9]{2,4})|([0-9]{3,20})|([B-DF-HJ-NP-TV-Z0-9]{6}[0-9])|([A-Z]{2}[A-Z0-9]{9}[0-9])|([A-Z1-9][A-Z0-9]{5})|(0*[0-9]{1,9})|([A-Z0-9]{8}[0-9])$
            maxLength: 50
            exclusiveMaximum: false
            minLength: 3
            exclusiveMinimum: false
            description: Identifier to resolve.
          required: true
        - name: identifierType
          in: query
          schema:
            type: string
            description: Type of the identifier.
            x-enum-description:
              - MDG identifier of an instrument.
              - MDG identifier of a listing.
              - FactSet Permanent Identifier on security level.
              - FactSet Permanent Identifier on listing level.
              - Regional FactSet Permanent Identifier.
              - FactSet market symbol of a listing.
              - Regional FactSet ticker symbol.
              - SEDOL or IDII of a listing.
              - ISIN of an instrument.
              - WKN of an instrument.
              - Valor number of an instrument.
              - CUSIP or CINS identifier of an instrument
            enum:
              - idInstrument
              - idNotation
              - fdsPermanentIdentifierSecurity
              - fdsPermanentIdentifierListing
              - fdsPermanentIdentifierRegional
              - tickerExchange
              - tickerRegion
              - sedol
              - isin
              - wkn
              - valor
              - cusip
          required: true
        - name: snapshots
          in: query
          schema:
            type: array
            nullable: false
            items:
              type: string
              x-enum-description:
                - latest
                - one week ago
                - one month ago
                - three months ago
                - six months ago
                - one year ago
              enum:
                - latest
                - 1w
                - 1m
                - 3m
                - 6m
                - 1y
            description: Choice of historic snapshots for aggregated recommendations.
            uniqueItems: true
            maxItems: 6
            minItems: 1
          style: form
          explode: false
          required: true
        - name: _attributes
          in: query
          schema:
            type: array
            items:
              type: string
              maxLength: 100
              exclusiveMaximum: false
            uniqueItems: true
            maxItems: 50
          style: form
          explode: false
          description: Limit the attributes returned in the response to the specified set.
      responses:
        '200':
          $ref: >-
            #/components/responses/GetStockRecommendationAggregateHistoryList200Response
  /company/board/listByInstrument:
    get:
      tags:
        - Company
        - Board
        - Instruments
      operationId: get/company/board/listByInstrument
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: List of boards for a company, with their officers.
      description: >-
        List of boards for a company, with their officers. A given person may be
        a member ofdifferent boards of the same company but also a member of
        boards of different companies.
      parameters:
        - name: id
          in: query
          schema:
            type: string
            format: id64
            x-positive: true
            description: >-
              Identifier of the instrument representing company shares.Any other
              instrument yields empty values.
          required: true
        - name: _attributes
          in: query
          schema:
            type: array
            items:
              type: string
              maxLength: 100
              exclusiveMaximum: false
            uniqueItems: true
            maxItems: 50
          style: form
          explode: false
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          schema:
            type: string
            format: isoLanguage
            description: ISO 639-1 code of the language.
            maxLength: 2
            minLength: 2
            exclusiveMinimum: false
            exclusiveMaximum: false
      responses:
        '200':
          $ref: '#/components/responses/GetCompanyBoardListByInstrument200Response'
  /company/board/officer/function/delivery/list:
    get:
      tags:
        - Company
        - Board
        - Officer
        - Functions
        - Deliveries
      operationId: get/company/board/officer/function/delivery/list
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: List of officer functions as provided by a delivery.
      description: List of officer functions as provided by a delivery.
      responses:
        '200':
          $ref: >-
            #/components/responses/GetCompanyBoardOfficerFunctionDeliveryList200Response
      parameters:
        - name: _attributes
          in: query
          schema:
            type: array
            items:
              type: string
              maxLength: 100
              exclusiveMaximum: false
            uniqueItems: true
            maxItems: 50
          style: form
          explode: false
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          schema:
            type: string
            format: isoLanguage
            description: ISO 639-1 code of the language.
            maxLength: 2
            minLength: 2
            exclusiveMinimum: false
            exclusiveMaximum: false
  /company/board/type/list:
    get:
      tags:
        - Company
        - Board
        - Type
      operationId: get/company/board/type/list
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: List of company board types.
      description: List of company board types.
      responses:
        '200':
          $ref: '#/components/responses/GetCompanyBoardTypeList200Response'
      parameters:
        - name: _attributes
          in: query
          schema:
            type: array
            items:
              type: string
              maxLength: 100
              exclusiveMaximum: false
            uniqueItems: true
            maxItems: 50
          style: form
          explode: false
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          schema:
            type: string
            format: isoLanguage
            description: ISO 639-1 code of the language.
            maxLength: 2
            minLength: 2
            exclusiveMinimum: false
            exclusiveMaximum: false
  /stock/owner/list:
    get:
      tags:
        - Stock
        - Owner
      operationId: get/stock/owner/list
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: List of owners for a specific type of a company's shares.
      description: List of top-20 owners for a specific type of a company's shares.
      parameters:
        - name: identifier
          in: query
          schema:
            type: string
            pattern: >-
              ^([B-DF-HJ-NP-TV-Z0-9]{6}-[SLR])|([A-Z0-9.]{1,47}-[A-Z0-9]{2,4})|([0-9]{3,20})|([B-DF-HJ-NP-TV-Z0-9]{6}[0-9])|([A-Z]{2}[A-Z0-9]{9}[0-9])|([A-Z1-9][A-Z0-9]{5})|(0*[0-9]{1,9})|([A-Z0-9]{8}[0-9])$
            maxLength: 50
            exclusiveMaximum: false
            minLength: 3
            exclusiveMinimum: false
            description: Identifier to resolve.
          required: true
        - name: identifierType
          in: query
          schema:
            type: string
            description: Type of the identifier.
            x-enum-description:
              - MDG identifier of an instrument.
              - MDG identifier of a listing.
              - FactSet Permanent Identifier on security level.
              - FactSet Permanent Identifier on listing level.
              - Regional FactSet Permanent Identifier.
              - FactSet market symbol of a listing.
              - Regional FactSet ticker symbol.
              - SEDOL or IDII of a listing.
              - ISIN of an instrument.
              - WKN of an instrument.
              - Valor number of an instrument.
              - CUSIP or CINS identifier of an instrument
            enum:
              - idInstrument
              - idNotation
              - fdsPermanentIdentifierSecurity
              - fdsPermanentIdentifierListing
              - fdsPermanentIdentifierRegional
              - tickerExchange
              - tickerRegion
              - sedol
              - isin
              - wkn
              - valor
              - cusip
          required: true
        - name: _attributes
          in: query
          schema:
            type: array
            items:
              type: string
              maxLength: 100
              exclusiveMaximum: false
            uniqueItems: true
            maxItems: 50
          style: form
          explode: false
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          schema:
            type: string
            format: isoLanguage
            description: ISO 639-1 code of the language.
            maxLength: 2
            minLength: 2
            exclusiveMinimum: false
            exclusiveMaximum: false
      responses:
        '200':
          $ref: '#/components/responses/GetStockOwnerList200Response'
  /stock/composite/profile/getByNotation:
    get:
      tags:
        - Stock
        - Composite
        - Profiles
        - Notation
      operationId: get/stock/composite/profile/getByNotation
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: >-
        Provides key elements of a stock profile together with the profile of
        the issuing company.
      description: >-
        Provides key elements of a stock profile together with the profile of
        the issuing company.
      parameters:
        - name: identifier
          in: query
          schema:
            type: string
            pattern: >-
              ^([B-DF-HJ-NP-TV-Z0-9]{6}-[LR])|([A-Z0-9.]{1,47}-[A-Z0-9]{2,4})|([0-9]{3,20})$
            maxLength: 50
            exclusiveMaximum: false
            minLength: 3
            exclusiveMinimum: false
            description: Identifier to resolve.
          required: true
        - name: identifierType
          in: query
          schema:
            type: string
            description: Type of the identifier.
            x-enum-description:
              - MDG identifier of a listing.
              - FactSet market symbol of a listing.
              - >-
                Regional FactSet ticker symbol, identifying the primary listing
                in the region.
              - FactSet Permanent Identifier on listing level.
              - >-
                Regional FactSet Permanent Identifier, identifying the primary
                listing in the region.
            enum:
              - idNotation
              - tickerExchange
              - tickerRegion
              - fdsPermanentIdentifierListing
              - fdsPermanentIdentifierRegional
          required: true
        - name: _attributes
          in: query
          schema:
            type: array
            items:
              type: string
              maxLength: 100
              exclusiveMaximum: false
            uniqueItems: true
            maxItems: 50
          style: form
          explode: false
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          schema:
            type: string
            format: isoLanguage
            description: ISO 639-1 code of the language.
            maxLength: 2
            minLength: 2
            exclusiveMinimum: false
            exclusiveMaximum: false
      responses:
        '200':
          $ref: >-
            #/components/responses/GetStockCompositeProfileGetByNotation200Response
  /stock/dividend/list:
    post:
      tags:
        - Stock
        - Dividends
      operationId: post/stock/dividend/list
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 4
      x-supportsPermissionDeniedResponse: false
      summary: List of dividends for a stock.
      description: List of dividends for a stock.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostStockDividendListRequest'
      responses:
        '200':
          $ref: '#/components/responses/PostStockDividendList200Response'
      parameters: []
  /stock/dividend/type/list:
    get:
      tags:
        - Stock
        - Dividends
        - Type
      operationId: get/stock/dividend/type/list
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: List of dividend types.
      description: List of dividend types.
      responses:
        '200':
          $ref: '#/components/responses/GetStockDividendTypeList200Response'
      parameters:
        - name: _attributes
          in: query
          schema:
            type: array
            items:
              type: string
              maxLength: 100
              exclusiveMaximum: false
            uniqueItems: true
            maxItems: 50
          style: form
          explode: false
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          schema:
            type: string
            format: isoLanguage
            description: ISO 639-1 code of the language.
            maxLength: 2
            minLength: 2
            exclusiveMinimum: false
            exclusiveMaximum: false
  /stock/notation/keyFigures/benchmark/month/1/get:
    get:
      tags:
        - Stock
        - Notation
        - Keys
        - Figures
        - Benchmark
        - Month
      operationId: get/stock/notation/keyFigures/benchmark/month/1/get
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: >-
        End-of-day (EOD) benchmark key figures of a stock for the time range of
        one month.
      description: >-
        End-of-day (EOD) benchmark key figures of a stock for the time range of
        one month.
      parameters:
        - name: identifier
          in: query
          schema:
            type: string
            pattern: >-
              ^([B-DF-HJ-NP-TV-Z0-9]{6}-[LR])|([A-Z0-9.]{1,47}-[A-Z0-9]{2,4})|([0-9]{3,20})$
            maxLength: 50
            exclusiveMaximum: false
            minLength: 3
            exclusiveMinimum: false
            description: Identifier to resolve.
          required: true
        - name: identifierType
          in: query
          schema:
            type: string
            description: Type of the identifier.
            x-enum-description:
              - MDG identifier of a listing.
              - FactSet market symbol of a listing.
              - >-
                Regional FactSet ticker symbol, identifying the primary listing
                in the region.
              - FactSet Permanent Identifier on listing level.
              - >-
                Regional FactSet Permanent Identifier, identifying the primary
                listing in the region.
            enum:
              - idNotation
              - tickerExchange
              - tickerRegion
              - fdsPermanentIdentifierListing
              - fdsPermanentIdentifierRegional
          required: true
        - name: idNotationBenchmark
          in: query
          schema:
            type: array
            nullable: false
            items:
              type: string
              format: id64
              x-positive: true
            uniqueItems: true
            minItems: 1
            maxItems: 3
            description: >-
              List of identifiers of benchmark notations. See the group
              description for the list

              of valid values.
          style: form
          explode: false
          required: true
        - name: _attributes
          in: query
          schema:
            type: array
            items:
              type: string
              maxLength: 100
              exclusiveMaximum: false
            uniqueItems: true
            maxItems: 50
          style: form
          explode: false
          description: Limit the attributes returned in the response to the specified set.
        - name: _language
          in: query
          schema:
            type: string
            format: isoLanguage
            description: ISO 639-1 code of the language.
            maxLength: 2
            minLength: 2
            exclusiveMinimum: false
            exclusiveMaximum: false
      responses:
        '200':
          $ref: >-
            #/components/responses/GetStockNotationKeyFiguresBenchmarkMonth1Get200Response
  /stock/notation/keyFigures/benchmark/week/1/get:
    get:
      tags:
        - Stock
        - Notation
        - Keys
        - Figures
        - Benchmark
        - Week
      operationId: get/stock/notation/keyFigures/benchmark/week/1/get
      x-supportsOffsetBasedPaging: false
      x-supportsOffsetBasedPagingWithoutTotal: false
      x-supportsCursorBasedPaging: false
      x-supportsCursorBasedPagingWithoutTotal: false
      x-supportsPush: false
      x-requiresUser: false
      x-requiresInternalClient: false
      x-disallowUser: false
      x-no-merge: false
      x-maxSortParameterCount: 10
      x-supportsPermissionDeniedResponse: false
      summary: >-
        End-of-day (EOD) benchmark key figures of a stock for the time range of
        one week.
      description: >-
        End-of-day (EOD) benchmark key figures of a stock for the time range of
        one week.
      parameters:
        - name: identifier
          in: query
          schema:
            type: string
            pattern: >-
              ^([B-DF-HJ-NP-TV-Z0-9]{6}-[LR])|([A-Z0-9.]{1,47}-[A-Z0-9]{2,4})|([0-9]{3,20})$
            maxLength: 50
            exclusiveMaximum: false
            minLength: 3
            exclusiveMinimum: false
            description: Identifier to resolve.
          required: true
        - name: identifierType
          in: query
          schema:
            type: string
            description: Type of the identifier.
            x-enum-description:
              - MDG identifier of a listing.
              - FactSet market symbol of a listing.
              - >-
                Regional FactSet ticker symbol, identifying the primary listing
                in the region.
              - FactSet Permanent Identifier on listing level.
              - >-
                Regional FactSet Permanent Identifier, identifying the primary
                listing in the region.
            enum:
              - idNotation
              - tickerExchange
              - tickerRegion
              - fdsPermanentIdentifierListing
              - fdsPermanentIdentifierRegional
          required: true
        - name: idNotationBenchmark
          in: query
          schema:
            type: array
            nullable: false
            items:
              type: string
              format: id64
              x-positive: true
            uniqueItems: true
            minItems: 1
            maxItems: 3
            description: >-
              List of identifiers of benchmark notations. See the group
              description for the list

              of valid values.
          style: form
          explode: false
          required: true
        - name: _attributes
          in: query
          schema:
            type: array
            items:
              type: string
           

# --- truncated at 32 KB (1331 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/factset/refs/heads/main/openapi/factset-stocks-api-for-digital-portals-openapi.yml