Factset Sectional API

openapi: 3.0.3
info:
  title: Factset Analytics Datastore About Sectional API
  description: Allow clients to fetch precalculated Analytics through predeterministic URLs.
  contact:
    name: FactSet Research Systems
    url: https://developer.factset.com/contact
    email: api@factset.com
  license:
    name: Apache License, Version 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  version: 1.0.0
servers:
- url: https://api.factset.com
  description: Production
- url: https://api-sandbox.factset.com
  description: Sandbox
security:
- basicAuth: []
tags:
- name: Sectional
paths:
  /v1/cross-sectional:
    get:
      summary: Factset Retrieve Data Items (screening Formulas) for a List of Identifiers or Defined Universe.
      description: "The `/cross-sectional` endpoint is closely aligned with FactSets powerful data retrieval **Screening language** which is optimized for analysis of data items at single point in time for different entities and is extremely efficient for large universes.\n\n\nThe `/cross-sectional` endpoint supports Long Running asynchronous requests up to **10 minutes** via the `batch` parameter. *This feature is available to Individual Users subscribed to the Performance Package and Performance Package Plus Performance Tiers and all Production Users. If you are unsure which Performance Tier you are subscribed to or you would like to gain access to the batch capabilities, please contact your FactSet Account Team or \"Report Issue\" above and our support teams can assist.*\n\n***\n\n### Iterated Cross-Sectional Functionality\n\n\nThis endpoint supports the ability to automatically iterate through different cross sections over time. The **Iterated Cross-Sectional Functionality (ICSF)** expands the Cross-Sectional endpoint to support retrieving data items for *multiple dates*, allowing users to take advantage of the Screening engines efficiency even when history is required. \n\n\nUse the parameters `startDate`, `endDate`, and `frequency` in the Cross-Sectional endpoint to provide your desired dates. Specify 0 in date argument of the Screening formulas provided in the formulas parameter and/or the universe parameter. Lastly, the Iterated Cross-Sectional Functionality is required to run as a `batch` request. Therefore, the batch parameter must be set to Y. \n\n\nAccess to backtesting and batch functionality is required to leverage the Iterated Cross-Sectional Functionality. \n\n**When to use ICSF:**\n\nThe ICSF can offer better performance than Time-Series requests when the date range is relatively small, and so it is recommended to use ICSF if the number of IDs requested is greater than the number of dates. If the number of dates is greater than the number of IDs in the request, it is recommended to use Time-Series.\n\n*Note: This is a general rule of thumb and performance may vary depending on the formulas in use.*\n"
      tags:
      - Sectional
      operationId: getCrossSectionalData
      parameters:
      - $ref: '#/components/parameters/ids'
      - $ref: '#/components/parameters/symbolType'
      - $ref: '#/components/parameters/universe'
      - $ref: '#/components/parameters/universeType_cross_sectional'
      - $ref: '#/components/parameters/formulas_cross_sectional'
      - $ref: '#/components/parameters/backTestDate'
      - $ref: '#/components/parameters/calendar_cross_sectional'
      - $ref: '#/components/parameters/fsymId_cross_sectional'
      - $ref: '#/components/parameters/displayName_cross_sectional'
      - $ref: '#/components/parameters/flatten_cross_sectional'
      - $ref: '#/components/parameters/batch'
      - $ref: '#/components/parameters/startDate'
      - $ref: '#/components/parameters/endDate'
      - $ref: '#/components/parameters/frequency'
      responses:
        '200':
          description: Gets an array of `Response Objects` for a list of IDs and Screening formulas.
          headers:
            api-version:
              $ref: '#/components/headers/api-version'
            api-supported-versions:
              $ref: '#/components/headers/api-supported-versions'
            api-deprecated-versions:
              $ref: '#/components/headers/api-deprecated-versions'
            chain-id:
              $ref: '#/components/headers/chain-id'
            X-RateLimit-Limit-second:
              $ref: '#/components/headers/X-RateLimit-Limit-second'
            X-RateLimit-Remaining-second:
              $ref: '#/components/headers/X-RateLimit-Remaining-second'
            X-RateLimit-Limit-day:
              $ref: '#/components/headers/X-RateLimit-Limit-day'
            X-RateLimit-Remaining-day:
              $ref: '#/components/headers/X-RateLimit-Remaining-day'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/cross_sectional_response'
              examples:
                Single Equity Id and Single Equity Data Item:
                  $ref: '#/components/examples/cross-sectional-singleId-singleItem'
                Single Equity Id and Single Equity Data Item with fsymId=Y:
                  $ref: '#/components/examples/cross-sectional-singleId-singleItem-fsymId'
                Multiple Equity Ids and Multiple Equity Data Items:
                  $ref: '#/components/examples/cross-sectional-multipleId-multipleItem'
                Multiple Equity Ids and Multiple Equity Data Items with flatten=Y:
                  $ref: '#/components/examples/cross-sectional-multipleId-multipleItem-flatten'
                Multiple Equity Ids and Multiple Calculated Equity Data Items:
                  $ref: '#/components/examples/cross-sectional-multipleId-multipleCalculatedItem'
                Multiple Fixed Income Ids and Multiple Fixed Income Data Items:
                  $ref: '#/components/examples/cross-sectional-multipleFixedIncomeId-multipleItem'
                Small Equity Universe and Single Equity Data Item:
                  $ref: '#/components/examples/cross-sectional-smallUniv-singleItem'
                Debt Universe and Multiple Debt Data Items:
                  $ref: '#/components/examples/cross-sectional-debtUniv-multipleItem'
                Single ID and Multiple dates using ICSF with flatten = N:
                  $ref: '#/components/examples/cross-sectional-ICSF-singleItem-nonflatten'
                Multiple IDs and Multiple dates using ICSF with flatten = Y:
                  $ref: '#/components/examples/cross-sectional-ICSF-multipleItem-Flatten'
        '202':
          description: Batch request has been accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchStatusResponse'
              examples:
                Batch Request Accepted:
                  $ref: '#/components/examples/BatchStatusAcceptedResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '408':
          $ref: '#/components/responses/408'
        '415':
          $ref: '#/components/responses/415'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      summary: Factset Retrieve Data Items (screening Formulas) for a List of Identifiers or Defined Universe.
      description: "The `/cross-sectional` endpoint is closely aligned with FactSets powerful data retrieval **Screening language** which is optimized for analysis of data items at single point in time for different entities and is extremely efficient for large universes.\n\n\nThe `/cross-sectional` endpoint supports Long Running asynchronous requests up to **10 minutes** via the `batch` parameter. *This feature is available to Individual Users subscribed to the Performance Package and Performance Package Plus Performance Tiers and all Production Users. If you are unsure which Performance Tier you are subscribed to or you would like to gain access to the batch capabilities, please contact your FactSet Account Team or \"Report Issue\" above and our support teams can assist.*\n\n***\n\n### Iterated Cross-Sectional Functionality\n\n\nThis endpoint supports the ability to automatically iterate through different cross sections over time. The **Iterated Cross-Sectional Functionality (ICSF)** expands the Cross-Sectional endpoint to support retrieving data items for *multiple dates*, allowing users to take advantage of the Screening engines efficiency even when history is required. \n\n\nUse the parameters `startDate`, `endDate`, and `frequency` in the Cross-Sectional endpoint to provide your desired dates. Specify 0 in date argument of the Screening formulas provided in the formulas parameter and/or the universe parameter. Lastly, the Iterated Cross-Sectional Functionality is required to run as a `batch` request. Therefore, the batch parameter must be set to Y. \n\n\nAccess to backtesting and batch functionality is required to leverage the Iterated Cross-Sectional Functionality. \n\n**When to use ICSF:**\n\nThe ICSF can offer better performance than Time-Series requests when the date range is relatively small, and so it is recommended to use ICSF if the number of IDs requested is greater than the number of dates. If the number of dates is greater than the number of IDs in the request, it is recommended to use Time-Series. \n\n*Note: This is a general rule of thumb and performance may vary depending on the formulas in use.*\n"
      tags:
      - Sectional
      operationId: getCrossSectionalDataForList
      responses:
        '200':
          description: Gets an array of `Response Objects` for a list of IDs and Screening formulas.
          headers:
            api-version:
              $ref: '#/components/headers/api-version'
            api-supported-versions:
              $ref: '#/components/headers/api-supported-versions'
            api-deprecated-versions:
              $ref: '#/components/headers/api-deprecated-versions'
            chain-id:
              $ref: '#/components/headers/chain-id'
            X-RateLimit-Limit-second:
              $ref: '#/components/headers/X-RateLimit-Limit-second'
            X-RateLimit-Remaining-second:
              $ref: '#/components/headers/X-RateLimit-Remaining-second'
            X-RateLimit-Limit-day:
              $ref: '#/components/headers/X-RateLimit-Limit-day'
            X-RateLimit-Remaining-day:
              $ref: '#/components/headers/X-RateLimit-Remaining-day'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/cross_sectional_response'
              examples:
                Single Equity Id and Single Equity Data Item:
                  $ref: '#/components/examples/cross-sectional-singleId-singleItem'
                Single Equity Id and Single Equity Data Item with fsymId=Y:
                  $ref: '#/components/examples/cross-sectional-singleId-singleItem-fsymId'
                Multiple Equity Ids and Multiple Equity Data Items:
                  $ref: '#/components/examples/cross-sectional-multipleId-multipleItem'
                Multiple Equity Ids and Multiple Equity Data Items with flatten=Y:
                  $ref: '#/components/examples/cross-sectional-multipleId-multipleItem-flatten'
                Multiple Equity Ids and Multiple Calculated Equity Data Items:
                  $ref: '#/components/examples/cross-sectional-multipleId-multipleCalculatedItem'
                Multiple Fixed Income Ids and Multiple Fixed Income Data Items:
                  $ref: '#/components/examples/cross-sectional-multipleFixedIncomeId-multipleItem'
                Small Equity Universe and Single Equity Data Item:
                  $ref: '#/components/examples/cross-sectional-smallUniv-singleItem'
                Debt Universe and Multiple Debt Data Items:
                  $ref: '#/components/examples/cross-sectional-debtUniv-multipleItem'
                Single ID and Multiple dates using ICSF with flatten = N:
                  $ref: '#/components/examples/cross-sectional-ICSF-singleItem-nonflatten'
                Multiple IDs and Multiple dates using ICSF with flatten = Y:
                  $ref: '#/components/examples/cross-sectional-ICSF-multipleItem-Flatten'
        '202':
          description: Batch request has been accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchStatusResponse'
              examples:
                Batch Request Accepted:
                  $ref: '#/components/examples/BatchStatusAcceptedResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '408':
          $ref: '#/components/responses/408'
        '415':
          $ref: '#/components/responses/415'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
        '501':
          $ref: '#/components/responses/501'
        '503':
          $ref: '#/components/responses/503'
      requestBody:
        $ref: '#/components/requestBodies/cross-sectional-postBody'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    cross_sectional_request:
      title: Cross-Sectional Request Body
      description: '`/cross-sectional` Request Body'
      type: object
      properties:
        data:
          type: object
          properties:
            ids:
              title: ids
              description: 'Array of entity identifiers.


                The `ids` and `universe` parameters provide two different ways to specify

                the identifiers for which you want data retrieved. Please enter either the

                `ids` or `universe` parameter.

                '
              type: array
              items:
                type: string
              example:
              - FDS-US
              - IBM-US
              - XOM-US
            symbolType:
              title: symbolType
              type: string
              description: "Specify the type of symbols submitted in the `ids` parameter. This is only required when submitting ids that are not supported by default. \n\nAvailable symbol types -\n* DEFAULT - Accepted symbol types include Market Tickers, SEDOLs, ISINs, CUSIPs, or FactSet Permanent Ids.\n\n* BLOOMBERG - Accepted symbol types include Bloomberg Tickers and Bloomberg FIGIs. \n  * When submitting Bloomberg symbols, the Bloomberg symbol is translated to a FactSet Permanent Identifier which is then used to retrieve the requested FQL and Screening formulas. The Bloomberg\nsymbol submitted will be returned in the response in the field *requestId*. To see the FactSet Permanent Identifer that the Bloomberg symbol resolved to, use the `fsymId` parameter in addition to the `symbolType` parameter.\n  * Bloomberg symbols can not be submitted with other symbol types. \n  * Bloomberg Symbol Resolution is not available via Batch Requests.\n  \nBloomberg Symbol Resolution is included with the Individual User subscription. Users with a Production User subscription require additional access to submit Bloomberg symbols. If you would like to gain access to Bloomberg Symbol Resolution, please contact your FactSet Account Team or \"Report Issue\" above and our support teams can assist.\n"
            universe:
              title: universe
              description: 'Screening expression to limit the universe


                Please enter either the `ids` or `universe` parameter.

                '
              type: string
              example: FG_CONSTITUENTS(SP50,0,CLOSE)
            universeType:
              title: universeType
              description: "Specify the universe type to calculate the `universe` in.\n\nFind documentation below on how to build a screen for each universe type -\n  * Equity Screen - [Online Assistant Page 20606](https://my.apps.factset.com/oa/pages/20606)\n\n  * Debt Screen - [Online Assistant Page 20888](https://my.apps.factset.com/oa/pages/20888)\n\n  * Fund Screen - [Online Assistant Page 21384](https://my.apps.factset.com/oa/pages/21384)\n"
              type: string
              default: EQUITY
              example: DEBT
              enum:
              - EQUITY
              - DEBT
              - FUND
            formulas:
              title: Screening formulas
              description: Array of Screening formulas
              type: array
              items:
                type: string
              example:
              - P_PRICE(0)
              - FG_COMPANY_NAME
            backTestDate:
              title: backTestDate
              description: 'Specify the backtest date either in **YYYY-MM-DD**, **YYYYMMDD** or **MM/DD/YYYY** format.


                To learn more about backtesting, please visit [Online Assistant Page 20610](https://my.apps.factset.com/oa/pages/20610#backtest). User must have access to backtesting functionality.

                '
              type: string
              example: '2020-06-01'
            calendar:
              title: Calendar Setting
              description: Calendar of data returned.
              type: string
              example: SEVENDAY
              default: FIVEDAY
            fsymId:
              title: fsymId
              description: 'Specify **Y** for `fsymId` to return an additional response object for the data item fsymId which will contain the fsymIds of the requestIds, in addition to the response object containing the data item requestId. The default value for `fsymId` is **N**.


                The **fsymId** field returned is the FactSet Default Permanent Identifier for the `requestId`. For all supported `requestId` symbol types, the `fsymId` parameter will return the Regional Level PermId ''-R'' which identifies the securitys best regional security data series per currency. Currently, the fsymId parameter only supports equities. Accepted `requestId` symbol types include all FactSet Permanent Identifiers types, CUSIP, SEDOL, ISIN, and Tickers. Further documentation can be found at this [Online Assistant attachment](https://oa.apps.factset.com/cms/oaAttachment/64c3213a-f415-4c27-a336-92c73a72deed/24881).

                '
              type: string
              example: Y
              default: N
              enum:
              - Y
              - N
            displayName:
              title: displayName
              description: 'Define display names for the formulas inputted. Enter the list of display names in the same order as the formulas inputted. An additional field **displayName** will be returned in the data object for a formula.


                If the number of display names does not match the number of formulas provided, an error will be returned.


                To define the display name for a subset of the formulas, leave a blank in the position of the formula that won''t be renamed. For example - If three formulas are inputted, to define display names only for the first and third formula, enter *displayName=FORMULA_1,,FORMULA_3*. The **displayName** field will still be included in that formula, but will contain the formula as inputted.

                '
              type: array
              items:
                type: string
              example:
              - PRICE
              - COMPANY_NAME
            flatten:
              title: flatten
              description: 'Specify **Y** for `flatten` to return a flat, table-like JSON response model instead of the standard nested JSON response model. This option is provided for easier data processing and visualization. The default value for `flatten` is **N**.


                See the **Cross-Sectional Result Object Flattened** schema for more detail on the response structure for flattened output.

                '
              type: string
              example: Y
              default: N
              enum:
              - Y
              - N
            batch:
              title: batch
              description: 'Enables the ability to asynchronously "batch" the request, supporting a long-running request up to 10 minutes. Upon requesting "batch": "Y", the service will respond back with an HTTP Status Code of 202.


                Individual users are allowed 5 concurrent Batch Requests, while Production users are allowed 10 concurrent Batch Requests.


                *This feature is available to Individual Users subscribed to the Performance Package and Performance Package Plus Performance Tiers and all Production Users. If you are unsure which Performance Tier you are subscribed to or you would like to gain access to the batch capabilities, please contact your FactSet Account Team or "Report Issue" above and our support teams can assist.*


                Once a batch request is submitted, use `/batch-status` to see if the job has completed. Once completed, retrieve the results of the request via `/batch-result`. See the endpoints listed under *Batch Processing* for more information.

                '
              type: string
              example: Y
              default: N
              enum:
              - Y
              - N
            startDate:
              title: statDate
              description: 'Specify the start date for running the Iterated Cross Sectional Functionality request either in **YYYY-MM-DD**, **YYYYMMDD** or **MM/DD/YYYY** format.

                '
              type: string
              example: '2020-05-01'
            endDate:
              title: endDate
              description: 'Specify the end date for running the Iterated Cross Sectional Functionality request either in **YYYY-MM-DD**, **YYYYMMDD** or **MM/DD/YYYY** format.

                '
              type: string
              example: '2020-05-31'
            frequency:
              title: frequency
              description: 'Specify the frequency for running the Iterated Cross Sectional Functionality request. The following frequencies are supported **D**, **W**, **M**, **AM**, **CQ**, **AY**, or **CY**.


                To learn more about frequency, please visit [Online Assistant Page 1964](https://my.apps.factset.com/oa/pages/1964#frequency). User must have access to backtesting functionality.

                '
              type: string
              example: AM
              enum:
              - D
              - W
              - M
              - AM
              - CQ
              - AY
              - CY
          required:
          - formulas
          example: example_value
      required:
      - data
    cross_sectional_result_object_nonflattened:
      title: Cross-Sectional Non-Flattened Response Object
      description: An object returning the results for a single formula.
      type: object
      properties:
        universe:
          description: If `universe` is submitted instead of `ids`, then the universe attribute will display the universe expression requested.
          type: string
          example: (FG_CONSTITUENTS(SP50,0,CLOSE) AND P_PRICE(0,USD)<10)=1
        dataItemName:
          description: Name of data item (requestId, requested Screening formula, or fsymId)
          type: string
          example: P_PRICE(0)
        displayName:
          description: Display Name.
          type: string
          nullable: true
          example: PRICE
        result:
          type: array
          items:
            $ref: '#/components/schemas/cross_sectional_result_object_nonflattened_result_attribute'
          example: []
        dataType:
          description: Data type of the data item
          example: STRING
          type: string
          enum:
          - STRING
          - INTEGER
          - DOUBLE
        error:
          description: "Data item error indicator.\n * Zero  success\n * Non-zero  failure\n"
          type: integer
          example: 0
        errorMessage:
          description: If error is non-zero, errorMessage will display the Screening formula error.
          type: string
          nullable: true
          example: 'Error parsing formula arguments

            '
        warnings:
          description: Screening formula warnings. This attribute is only displayed if warnings are generated in the execution of the Screening formula.
          type: array
          items:
            type: object
            properties:
              description:
                description: Human readable message explaining the warning
                type: string
                nullable: true
              effect:
                description: Human readable message explaining the effect on the `result`
                type: string
                nullable: true
          example: []
      required:
      - dataItemName
      - error
      - result
      - dataType
    cross_sectional_response:
      title: Cross-Sectional Response
      type: object
      properties:
        data:
          description: Array of Cross-Sectional `Response Objects`
          type: array
          items:
            $ref: '#/components/schemas/cross_sectional_response_object_items'
          example: []
    cross_sectional_response_object_items:
      title: Cross-Sectional Response Object
      oneOf:
      - $ref: '#/components/schemas/cross_sectional_result_object_nonflattened'
      - $ref: '#/components/schemas/cross_sectional_result_object_flattened'
    BatchStatus:
      title: Batch Status
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: the id of batch request.
          example: abc123
        startTime:
          type: string
          nullable: true
          format: date-time
          description: Time when the batch request is started. This is in Eastern Time Zone. The date-time format is expressed as [YYYY-MM-DD]T[HH:MM:SSS], following ISO 8601.
          example: '2026-01-15T10:30:00Z'
        endTime:
          type: string
          nullable: true
          format: date-time
          description: Time when the batch request is ended. This is in Eastern Time Zone. The date-time format is expressed as [YYYY-MM-DD]T[HH:MM:SSS], following ISO 8601.
          example: '2026-01-15T10:30:00Z'
        status:
          type: string
          enum:
          - QUEUED
          - EXECUTING
          - DONE
          - FAILED
          example: QUEUED
        error:
          type: string
          nullable: true
          example: The parameter 'formulas' is required and may not be empty.
          description: Error message.
    cross_sectional_result_object_nonflattened_result_attribute:
      title: Result Attribute in Cross-Sectional Non-Flattened Response Object
      description: An array containing the values for the data item
      oneOf:
      - type: string
        nullable: true
        description: Array of strings
        example:
        - IBM
        - FDS
        - GE
        - GOOG
        - AAPL
        - MSFT
        - TSLA
      - type: number
        nullable: true
        description: Array of doubles
        format: double
        example:
        - 121.73
        - 333.29
        - 6.2
        - 1464.52
        - 114.96
        - 209.44
        - 421.2
      - type: integer
        nullable: true
        description: Array of integers
        example:
        - 42
        - 3
        - 14
        - 17
        - 29
        - 8
        - 36
    cross_sectional_result_object_flattened_addl:
      title: Key-Value Pair for Cross-Sectional Flattened Response Object
      description: 'The Key in the Key-Value pair will be the formula. If the `displayName` parameter is used, then the Key will be displayName specified for that formula. The Value in the Key-Value pair will be the result of the formula for that "row".

        '
      example: '"P_PRICE(0)": 142.32'
      oneOf:
      - type: string
        nullable: true
      - type: number
        format: double
        nullable: true
      - type: integer
        nullable: true
    error_detail:
      title: Error Object
      description: '`Error Object` is the response returned for an unsuccessful request.

        '
      type: object
      properties:
        id:
          description: Unique identifier for the request. Also known as the chain id.
          type: string
          example: 5EFCCA8940CAEA6B
          nullable: true
        code:
          description: Textual error code
          type: string
          example: notAuthenticated
          nullable: true
        title:
          description: A short, human-readable summary of the problem
          type: string
          example: There were either no, invalid, or expired credentials present in the request.
          nullable: true
        timestamp:
          description: timestamp in YYYY-MM-DD HH:MM:SS.SSS
          type: string
          format: date-time
          example: '2020-08-01 11:09:41.918'
          nullable: true
    BatchStatusResponse:
      title: Batch Status Response
      type: object
      properties:
        data:
          $ref: '#/components/schemas/BatchStatus'
    cross_sectional_result_object_flattened:
      title: Cross-Sectional Flattened Result Object
      description: '

        Data model returned when the parameter **flatten=Y** is used in the request. This flattened, simplified JSON data returned from **flatten=Y** can be conceptualized as a table (rows and columns) where each data object in the result is a row in the table and the field names are the column names.


        There will be one data object for each request containing the request, fsymId if requested, and Key-Value pairs for each data item (formula).

        '
      type: object
      properties:
        requestId:
          description: Identifier requested.
          type: string
          example: IBM-US
        fsymId:
          description: 'The **fsymId** field returned is the FactSet Default Permanent Identifier for the `requestId`. For all supported `requestId` symbol types, the `fsymId` parameter will return the Regional Level PermId ''-R'' which identifies the securitys best regional security data series per currency. Currently, the fsymId parameter only supports equities. Accepted `requestId` symbol types include all FactSet Permanent Identifiers types, CUSIP, SEDOL, ISIN, and Tickers. Further documentation can be found at this [Online Assistant attachment](https://oa.apps.factset.com/cms/oaAttachment/64c3213a-f415-4c27-a336-92c73a72deed/24881). Included only if the `fsymId` parameter is set to Y.

            '
          type: string
          nullable: true
          example: SJY281-R
      additionalProperties:
        $ref: '#/components/schemas/cross_sectional_result_object_flattened_addl'
      required:
      - requestId
  examples:
    cross-sectional-multipleId-multipleCalculatedItem:
      summary: Mutiple Ids and Multiple Calculated Equity Data Items
      description: '`cross-sectional` Request for to retrieve your own P/E ratio calculation from the last trading day of the companys most recent fiscal year, the percentage of revenue exposure in the US and Japan for the same date as the first data item, and indicator of indicate whether the latest fiscal year''s sales were higher or lower than the previous year''s sales for IBM, FDS, GE, GOOG, AAPL, MSFT, and TSLA

        '
      value:
        data:
        - dataItemName: requestId
          result:
          - IBM
          - FDS
          - GE
          - GOOG
          - AAPL
          - MSFT
          - TSLA
          dataType: STRING
          error: 0
        - dataItemName: P_PRICE(0Y)/FF_EPS(ANN_R,0Y)
          result:
          - 12.3145
          - 33.9323
          - -388.737
          - 38.3806
          - 40.3096
          - 38.9243
          - -873.152
          dataType: DOUBLE
          error: 0
        - dataItemName: FF_GEOREV_COUNTRY_PCT(840,ANN,0,RF)+FF_GEOREV_COUNTRY_PCT(392,ANN,0,

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