Factset Fundamentals API

openapi: 3.0.3
info:
  title: Factset Analytics Datastore About Fundamentals 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: Fundamentals
paths:
  /fundamentals:
    get:
      tags:
      - Fundamentals
      summary: Factset Returns Company Fundamental Data.
      operationId: getFdsFundamentals
      x-factset-sdk-ignore: true
      description: "Retrieves FactSet Fundamental standardized data for specified securities. Use the ```/metrics``` endpoint to retrieve a full list of valid metrics or data items.\n\n\nThe ```/fundamentals``` endpoint currently supports Long Running asynchronous requests up to **20 minutes** via batch parameter. Id limits are increased to 2000 ids per request when using batch capability. This 2000 id limit has been derived based on single metric for one day. This feature is available for all users.       \n"
      parameters:
      - $ref: '#/components/parameters/idsBatchMax2000'
      - $ref: '#/components/parameters/periodicity'
      - $ref: '#/components/parameters/fiscalPeriodStart'
      - $ref: '#/components/parameters/fiscalPeriodEnd'
      - $ref: '#/components/parameters/metrics'
      - $ref: '#/components/parameters/currency'
      - $ref: '#/components/parameters/updateType'
      - $ref: '#/components/parameters/batch'
      responses:
        '200':
          description: Fundamental data items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/fundamentalsResponse'
              examples:
                Result of Single Company (FDS-US), sales(FF_SALES) details for the given period:
                  $ref: '#/components/examples/resultOfSingleIdwithSingleMetricItem'
                Result of Multiple companies single metric item details:
                  $ref: '#/components/examples/resultOfMultipleIdwithSingleMetricItem'
                Result of Single Company (FDS-US), and Multiple Metrics (FF_SALES, FF_PE):
                  $ref: '#/components/examples/resultOfSingleIdwithMultipleMetricItem'
        '202':
          description: Batch request has been accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchStatusResponse'
              examples:
                Batch Request Accepted:
                  $ref: '#/components/examples/BatchStatusAcceptedResponse'
          headers:
            Location:
              description: Path to Batch Request status.
              schema:
                type: string
              example: batch-status?id=2df43e85-ea0f-45c6-bf4a-2baf4d1eaa3c
        '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:
      - Fundamentals
      summary: Factset Returns Company Fundamental Data.
      description: "Retrieves FactSet Fundamental standardized data for specified securities. Use the ```/metrics``` endpoint to retrieve a full list of valid metrics or data items.\n\n\nThe ```/fundamentals``` endpoint currently supports Long Running asynchronous requests up to **20 minutes** via batch parameter. Id limits are increased to 30000 ids per request when using batch capability. This 30000 id limit has been derived based on single metric for one day. This feature is available for all users. \n"
      operationId: getFdsFundamentalsForList
      requestBody:
        required: true
        description: Request object for requesting fundamentals data
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/fundamentalsRequest'
            examples:
              Single Company (FDS-US), sales(FF_SALES) details for the given period:
                $ref: '#/components/examples/postBodyOfSingleIdwithSingleMetricItem'
              Multiple Companies single metric item details:
                $ref: '#/components/examples/postBodyOfMultipleIdwithSingleMetricItem'
              Single Company (FDS-US), and Multiple Metrics (FF_SALES, FF_PE):
                $ref: '#/components/examples/postBodyOfSingleIdwithMultipleMetricItem'
              Batch Request for (FDS-US), and Multiple Metrics (FF_SALES, FF_PE):
                $ref: '#/components/examples/BatchFundamentalsRequestPost'
      responses:
        '200':
          description: Fundamental data items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/fundamentalsResponse'
              examples:
                Result of Single Company (FDS-US), sales(FF_SALES) details for the given period:
                  $ref: '#/components/examples/resultOfSingleIdwithSingleMetricItem'
                Result of Multiple Companies single metric item details:
                  $ref: '#/components/examples/resultOfMultipleIdwithSingleMetricItem'
                Result of Single Company (FDS-US), and Multiple Metrics (FF_SALES, FF_PE):
                  $ref: '#/components/examples/resultOfSingleIdwithMultipleMetricItem'
        '202':
          description: Batch request has been accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchStatusResponse'
              examples:
                Batch Request Accepted:
                  $ref: '#/components/examples/BatchStatusAcceptedResponse'
          headers:
            Location:
              description: Path to Batch Request status.
              schema:
                type: string
              example: batch-status?id=2df43e85-ea0f-45c6-bf4a-2baf4d1eaa3c
        '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'
components:
  examples:
    BatchFundamentalsRequestPost:
      summary: Batch request for FF_SALES and FF_PE for FDS-US
      description: Requests the FDS-US Sales and Price-to-Earnings data for the period 2017-09-01 to 2018-03-01 on a quarterly basis with the preliminary data Values.
      value:
        data:
          ids:
          - FDS-US
          periodicity: QTR
          fiscalPeriod:
            start: '2017-09-01'
            end: '2018-03-01'
          metrics:
          - FF_SALES
          - FF_PE
          currency: USD
          updateType: RP
          batch: Y
    badRequestInvalidParameters:
      summary: Bad Request - Passing invalid Fundamental Metric Id
      description: This error message occurs when the user is passing Invalid Metric Id. Please use the helper endpoint */metrics* for the sample Fundamental Metric Id.
      value:
        errors:
        - id: adb01824-252f-4420-b0c6
          code: Bad Request
          links:
            about: /factset-fundamentals/v2/{endpoint}
          title: 'Given input is not a valid value for parameter: `metrics`'
    resultOfSingleIdwithMultipleMetricItem:
      summary: Result of Single Company and Multiple Metrics [FF_SALES, FF_PE]
      description: 'Results of the FDS-US Quarterly Sales and Price to Earnings data as of 2020-05-31

        '
      value:
        data:
        - requestId: FDS
          fsymId: SQFMK3-R
          metric: FF_SALES
          periodicity: QTR
          fiscalPeriod: 3
          fiscalYear: 2020
          fiscalPeriodLength: 92
          fiscalEndDate: '2020-05-31'
          reportDate: '2020-05-31'
          epsReportDate: '2020-06-25'
          updateType: Final
          currency: USD
          value: 374.083
        - requestId: FDS
          fsymId: SQFMK3-R
          metric: FF_PE
          periodicity: QTR
          fiscalPeriod: 3
          fiscalYear: 2020
          fiscalPeriodLength: 92
          fiscalEndDate: '2020-05-31'
          reportDate: '2020-05-31'
          epsReportDate: '2020-06-25'
          updateType: Final
          currency: USD
          value: 31.6769162623484
    postBodyOfSingleIdwithSingleMetricItem:
      summary: FDS-US company sales[FF_SALES] data for the given time period
      description: Requests the FDS-US sales data for the period 2017-09-01 to 2018-03-01 on a quarterly basis with the preliminary data Values.
      value:
        data:
          ids:
          - FDS-US
          periodicity: QTR
          fiscalPeriod:
            start: '2017-09-01'
            end: '2018-03-01'
          metrics:
          - FF_SALES
          currency: USD
          updateType: RP
    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 this, convert your date to YYYY-MM-DD.
      value:
        errors:
        - id: adb01824-252f-4420-b0c6
          code: Bad Request
          links:
            about: /factset-fundamentals/v2/{endpoint}
          title: 'The date parameter must be in the following date format: YYYY-MM-DD'
    postBodyOfMultipleIdwithSingleMetricItem:
      summary: Multiple companies single metric item [FF_SALES] details.
      description: Post body request example to fetch details of the FDS-US, IBM-US, AAPL-US sales data for the period 2017-09-01 to 2018-03-01 on a quarterly basis with the final data Values.
      value:
        data:
          ids:
          - FDS-US
          - IBM-US
          - AAPL-US
          periodicity: QTR
          fiscalPeriod:
            start: '2017-09-01'
            end: '2018-03-01'
          metrics:
          - FF_SALES
          currency: USD
          updateType: RP
    notWritable:
      summary: Internal Server Error - Not Writable
      description: This error may be returned when the server encounters an error writing the JSON response.
      value:
        errors:
        - id: adb01824-252f-4420-b0c6
          code: Internal Server Error
          links:
            about: /factset-fundamentals/v2/{endpoint}
          title: Error writing JSON output
    BatchStatusAcceptedResponse:
      description: Batch Status Accepted Response
      value:
        data:
          id: 2df43e85-ea0f-45c6-bf4a-2baf4d1eaa3c
          status: queued
          startTime: '2021-06-29T18:34:52.168Z'
          endTime: null
          error:
            id: 2df43e85-ea0f-45c6-bf4a-2baf4d1eaa3c
            code: GenericError
            title: the date parameter must be in YYYY-MM-DD format
    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:
        errors:
        - id: adb01824-252f-4420-b0c6
          code: Unsupported Media Type
          links:
            about: /factset-fundamentals/v2/{endpoint}
          title: text/html media type is not supported. Supported media types are application/json.
    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:
        errors:
        - id: adb01824-252f-4420-b0c6
          code: Internal Server Error
          links:
            about: /factset-fundamentals/v2/{endpoint}
          title: Unexpected error
    resultOfSingleIdwithSingleMetricItem:
      summary: Result of Single Company single metric item [FF_SALES] details.
      description: 'Results of the FDS-US sales data for the period 2017-09-01 to 2018-03-01 on a quarterly basis with the preliminary data Values.

        '
      value:
        data:
        - requestId: FDS-US
          fsymId: SQFMK3-R
          metric: FF_SALES
          periodicity: QTR
          fiscalPeriod: 1
          fiscalYear: 2018
          fiscalPeriodLength: 91
          fiscalEndDate: '2017-11-30'
          reportDate: '2017-11-30'
          epsReportDate: '2017-12-19'
          updateType: Final
          currency: USD
          value: 20.345
        - requestId: FDS-US
          fsymId: SQFMK3-R
          metric: FF_SALES
          periodicity: QTR
          fiscalPeriod: 2
          fiscalYear: 2018
          fiscalPeriodLength: 90
          fiscalEndDate: '2018-02-28'
          reportDate: '2018-02-28'
          epsReportDate: '2018-03-27'
          updateType: Final
          currency: USD
          value: 30.345
    badRequestMoreThanOneFundamentalMetricId:
      summary: Bad Request - More Than One Fundamental Metric Id
      description: This error message occurs when the user is passing more than one metric as input.
      value:
        errors:
        - id: adb01824-252f-4420-b0c6
          code: Bad Request
          links:
            about: /factset-fundamentals/v2/fundamentals
          title: 'getFdsFundamentals.metrics: size must be between 1 and 1'
    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:
        errors:
        - id: adb01824-252f-4420-b0c6
          code: Bad Request
          links:
            about: /factset-fundamentals/v2/{endpoint}
          title: The request took too long. Try again with a smaller request.
    forbidden:
      summary: Forbidden
      description: The USERNAME-SERIAL attempted to request the endpoint/ID which is not authorized to access. The request was legal, but the server is refusing to respond. Please reach out to FactSet Account Team for assistance with authorization.
      value:
        errors:
        - id: adb01824-252f-4420-b0c6
          code: Forbidden
          links:
            about: /factset-fundamentals/v2/{endpoint}
          title: User is not authorized for the id requested, please reach out to FactSet for support
    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 the Issue under 401 error for help with troubleshooting.
      value:
        errors:
        - id: adb01824-252f-4420-b0c6
          code: User Authentication Failed
          links:
            about: /factset-fundamentals/v2/{endpoint}
          title: User Authentication Failed.
    resultOfMultipleIdwithSingleMetricItem:
      summary: Result of Multiple Companies single metric item [FF_SALES] details.
      description: 'Results the FDS-US, IBM-US, AAPL-US sales data for the period 2017-09-01 to 2018-03-01 on a quarterly basis with the final data Values.

        '
      value:
        data:
        - requestId: FDS-US
          fsymId: SQFMK3-R
          metric: FF_SALES
          periodicity: QTR
          fiscalPeriod: 1
          fiscalYear: 2018
          fiscalPeriodLength: 91
          fiscalEndDate: '2017-11-30'
          reportDate: '2017-11-30'
          epsReportDate: '2017-12-19'
          updateType: Final
          currency: USD
          value: 329.141
        - requestId: FDS-US
          fsymId: SQFMK3-R
          metric: FF_SALES
          periodicity: QTR
          fiscalPeriod: 2
          fiscalYear: 2018
          fiscalPeriodLength: 90
          fiscalEndDate: '2018-02-28'
          reportDate: '2018-02-28'
          epsReportDate: '2018-03-27'
          updateType: Final
          currency: USD
          value: 335.231
        - requestId: IBM-US
          fsymId: SJY281-R
          metric: FF_SALES
          periodicity: QTR
          fiscalPeriod: 3
          fiscalYear: 2017
          fiscalPeriodLength: null
          fiscalEndDate: '2017-09-30'
          reportDate: '2017-09-30'
          epsReportDate: '2017-10-17'
          updateType: Final
          currency: USD
          value: 19153
        - requestId: IBM-US
          fsymId: SJY281-R
          metric: FF_SALES
          periodicity: QTR
          fiscalPeriod: 4
          fiscalYear: 2017
          fiscalPeriodLength: null
          fiscalEndDate: '2017-12-31'
          reportDate: '2017-12-31'
          epsReportDate: '2018-01-18'
          updateType: Final
          currency: USD
          value: 22543
        - requestId: AAPL-US
          fsymId: MH33D6-R
          metric: FF_SALES
          periodicity: QTR
          fiscalPeriod: 4
          fiscalYear: 2017
          fiscalPeriodLength: 91
          fiscalEndDate: '2017-09-30'
          reportDate: '2017-09-30'
          epsReportDate: '2017-11-02'
          updateType: Final
          currency: USD
          value: 52574
        - requestId: AAPL-US
          fsymId: MH33D6-R
          metric: FF_SALES
          periodicity: QTR
          fiscalPeriod: 1
          fiscalYear: 2018
          fiscalPeriodLength: 91
          fiscalEndDate: '2017-12-31'
          reportDate: '2017-12-30'
          epsReportDate: '2018-02-01'
          updateType: Final
          currency: USD
          value: 88477
    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:
        errors:
        - id: adb01824-252f-4420-b0c6
          code: Bad Request
          links:
            about: /factset-fundamentals/v2/{endpoint}
          title: Malformed JSON Request
    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 asterisk symbol in the specification file.
      value:
        errors:
        - id: adb01824-252f-4420-b0c6
          code: Bad Request
          links:
            about: /factset-fundamentals/v2/{endpoint}
          title: The parameter 'ids' is required and may not be empty.
    postBodyOfSingleIdwithMultipleMetricItem:
      summary: Requesting Quarterly FF_SALES and FF_PE for FDS-US
      description: Requests the FDS-US Sales and Price-to-Earnings data for the period 2017-09-01 to 2018-03-01 on a quarterly basis with the preliminary data Values.
      value:
        data:
          ids:
          - FDS-US
          periodicity: QTR
          fiscalPeriod:
            start: '2017-09-01'
            end: '2018-03-01'
          metrics:
          - FF_SALES
          - FF_PE
          currency: USD
          updateType: RP
  schemas:
    fiscalPeriod:
      type: object
      properties:
        start:
          description: 'The fiscal period start expressed as YYYY-MM-DD.  Calendar date that will fall back to the most recently completed period during resolution.

            '
          type: string
          example: '2012-01-01'
        end:
          type: string
          description: 'The fiscal period end expressed YYYY-MM-DD.  Calendar date that will fall back to the most recent completed period during resolution.

            '
          example: '2014-01-01'
    fundamentalRequestBody:
      title: Fundamentals Request Body
      description: Fundamentals request body elements
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/idsBatchMax30000'
        periodicity:
          $ref: '#/components/schemas/periodicity'
        fiscalPeriod:
          $ref: '#/components/schemas/fundamentalFiscalPeriod'
        metrics:
          $ref: '#/components/schemas/metrics'
        currency:
          $ref: '#/components/schemas/currency'
        updateType:
          $ref: '#/components/schemas/updateType'
        batch:
          $ref: '#/components/schemas/batch'
      required:
      - ids
      - metrics
    batchErrorObject:
      type: object
      nullable: true
      properties:
        id:
          description: A UUID for this particular occurrence of the problem.
          type: string
          example: adb01824-252f-4420-b0c6-35a1e3507ef5
        code:
          description: status
          type: string
          example: GenericError
        title:
          description: The plain text error message
          type: string
          example: Validation Error
    batch:
      description: 'Enables the ability to asynchronously "batch" the request, supporting a long-running request for up to 20 minutes. Upon requesting batch=Y, the service will respond back with an HTTP Status Code of 202. Once a batch request is submitted, use batch status to see if the job has been completed. Once completed, retrieve the results of the request via batch-result. When using Batch, ids limit is increased to 30000 ids per request, though limits on query string via GET method still apply. It''s advised to submit large lists of ids via POST method.

        '
      type: string
      enum:
      - Y
      - N
      default: N
    fundamentalValue:
      description: 'Value of the data metric requested. Note that the type of value is ''object'', and depending on the data metric requested, the value could be an object representation of a string or double. '
      oneOf:
      - type: string
        nullable: true
      - type: number
        format: double
        nullable: true
    fundamental:
      title: Fundamental Object
      type: object
      required:
      - fiscalPeriod
      description: FactSet Fundamentals Response item
      properties:
        requestId:
          description: Identifier that was used for the request.
          type: string
          example: IBM-US
        fsymId:
          description: FactSet Regional Security Identifier. Six alpha-numeric characters, excluding vowels, with an -R suffix (XXXXXX-R). Identifies the security's best regional security data series per currency. For equities, all primary listings per region and currency are allocated a regional-level permanent identifier. The regional-level permanent identifier will be available once a SEDOL representing the region/currency has been allocated and the identifiers are on FactSet.
          type: string
          example: SJY281-R
          nullable: true
        metric:
          description: The requested `metric` input, representing the Fundamental Data Item. For a definition of the item please use the /fundamentals/v#/metrics endpoint.
          type: string
          example: FF_SALES
          nullable: true
        periodicity:
          description: Periodicity or frequency of the fiscal periods, where ANN = Annual Original, ANN_R = Annual Latest, QTR = Quarterly Original, QTR_R = Quarterly Latest, SEMI = Semi-Annual Original, SEMI_R = Semi-Annual Latest, LTM = Last Twelve Months Original, LTM_R = Last Twelve Months Latest, LTMSG = Last Twelve Months Global, [OA17959](https://my.apps.factset.com/oa/pages/17959), LTM_SEMI = Last Twelve Months - Semi-Annual Data and YTD = Year-to-date. Please note that the coverage for SEMI_R and LTM_R may be limited as fewer companies report with these periodicities.
          type: string
          example: QTR
          enum:
          - ANN
          - ANN_R
          - QTR
          - QTR_R
          - SEMI
          - SEMI_R
          - CAL
          - LTM
          - LTM_R
          - LTMSG
          - LTM_SEMI
          - YTD
          nullable: true
        fiscalPeriod:
          description: 'Fiscal Period indicator. Returns an integer representing the fiscal period for the requested item and periodicity. QUARTERLY CODE: 1-Fist Quarter; 2-Second Quarter; 3-Third Quarter; 4-Fourth Quarter. SEMI-CODE: 1-First Semi-annual Period; 2-Second Semi-annual Period.'
          type: integer
          example: 4
          nullable: true
        fiscalYear:
          description: Fiscal year of the reported period in YYYY format.
          type: integer
          example: 2018
          nullable: true
        fiscalPeriodLength:
          description: Length of the fiscal period in days.
          type: integer
          example: 91
          nullable: true
        fiscalEndDate:
          description: The normalized data the fiscal period ended.
          type: string
          format: date
          example: '2017-12-31'
          nullable: true
        reportDate:
          description: The date the reported fiscal period ended.
          type: string
          format: date
          example: '2017-12-30'
          nullable: true
        epsReportDate:
          description: The date the EPS was reported for the requested periodicity. In YYYY-MM-DD format. Unavailable data returned as 0001-01-01.
          type: string
          format: date
          example: '2018-02-24'
          nullable: true
        updateType:
          description: 'Update Type: Preliminary - The period is updated from a report that usually contains limited or only key information., Final - The period is updated from a report where detailed information is available in financial statements including the notes to the line items.'
          type: string
          example: Preliminary
          nullable: true
          enum:
          - Preliminary
          - Final
        currency:
          description: 'Currency code for the data. For a list of currency ISO codes, visit [Online Assistant Page #1470](https://oa.apps.factset.com/pages/1470).'
          type: string
          example: USD
          nullable: true
        value:
          $ref: '#/components/schemas/fundamentalValue'
    BatchStatus:
      title: Batch Status
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: the id of batch request.
        startTime:
          type: string
          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.
        endTime:
          type: string
          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.
          nullable: true
        status:
          type: string
          enum:
          - queued
          - executing
          - created
          - failed
        error:
          $ref: '#/components/schemas/batchErrorObject'
    metrics:
      title: Metrics
      type: array
      description: 'Requested List of Financial Statement Items or Ratios. Use /metrics endpoint for a complete list of available FF_* metric items.

        '
      items:
        type: string
      minItems: 1
      maxItems: 1600
      example:
      - FF_SALES
    updateType:
      title: Update Type
      type: string
      enum:
      - RP
      - RF
      default: RP
      description: "Update Status flag:\n  * **RP** = Include preliminary data,\n  * **RF** = Only final data\n"
      example: RP
    periodicity:
      title: Periodicity
      type: string
      description: "Periodicity or frequency of the fiscal periods, where\n  * **ANN** = Annual Original,\n  * **ANN_R** = Annual Latest - *Includes Restatements*,\n  * **QTR** = Quarterly,\n  * **QTR_R** = Quarterly Latest - *Includes Restatements*,\n  * **SEMI** = Semi-Annual,\n  * **SEMI_R** = Semi-Annual Latest - *Includes Restatements*,\n  * **LTM** = Last Twelve Months,\n  * **LTM_R** = Last Twelve Months Latest - *Includes Restatements*,\n  * **LTM_SEMI** = Last Twelve Months - Semi-Annually Reported Data,\n  * **LTMSG** = Last Twelve Months Global [OA17959](https://my.apps.factset.com/oa/pages/17959) and\n  * **YTD** = Year-to-date\n<br><br>\nPlease note that the coverage for SEMI_R and LTM_R may be limited as fewer companies report with these periodicities.\n"
      enum:
      - ANN
      - ANN_R
      - QTR
      - QTR_R
      - SEMI
      - SEMI_R
      - LTM
      - LTM_R
      - LTMSG
      - LTM_SEMI
      - YTD
      default: ANN
      example: QTR
    errorResponse:
      type: object
      title: Error Response
      description: Error Default Response
      properties:
        errors:
          type: array
          description: An array containing errors
          items:
            $ref: '#/components/schemas/errorObject'
    fundamentalFiscalPeriod:
      $ref: '#/components/schemas/fiscalPeriod'
    currency:
      title: Currency
      description: 'Currency code for currency values. For a list of currency ISO codes, visit [Online Assistant Page #1470](https://oa.apps.factset.com/pages/1470).

        '
      type: string
      default: LOCAL
      example: USD
    errorObject:
      type: object
      properties:
        id:
          description: A UUID for this particular occurrence of the problem.
          type: string
          example: adb01824-252f-4420-b0c6-35a1e3507ef5
        code:
          description: status
          type: string
          example: Bad Request
        links:
          description: The Endpoint path {package}/version/{endpoint}
          type: object
          properties:
            about:
              description: details.
              type: string
              example: /factset-fundamentals/v1/{endpoint}
        title:
          description: The plain text error message
          type: string
          example: Validation Error
    fundamentalsRequest:
      title: Fundamentals Request Body
      description: Fundamentals request body elements
      type: object
      properties:
        data:
          $ref: '#/components/schemas/fundamentalRequestBody'
      required:
      - data
    BatchStatusResponse:
      title: Batch Status Response
      type: object
      properties:
        data:
          $ref: '#/components/schemas/BatchStatus'
    fundamentalsResponse:
      type: object
      title: Fundamentals Response
      description: Array of Fundamentals Objects
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/fundamental'
    idsBatchMax30000:
      type: array
      items:
        type: string
        minItems: 1
        maxItems: 30000
      description: "The requested list of security identifiers. Accepted ID types include Market Tickers, SEDOL, ISINs, CUSIPs, or FactSet Permanent Ids. \n<p>ids limit =  1000 per non-batch request / 30000 per batch request</p>\n"
      example:
      - FDS-US
  responses:
    '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'
    '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 the 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 - Unsupported Media Type:
              $ref: '#/components/examples/unsupportedMediaType'
    '403':
      description: The USERNAME-SERIAL attempted to request the endpoint is not authorized to access. The request was legal, 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 - forbidden:
              $ref: '#/components/examples/forbidden'
    '500':
      description: Internal Server Error

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