FactSet Symbology API

FactSet Symbology API provides symbol resolution services, allowing users to translate from familiar market symbols to FactSet's native symbology. FactSet's symbology sits at the center of its hub-and-spoke data model, enabling you to quickly_.

OpenAPI Specification

symbology-openapi-original.yml Raw ↑
openapi: 3.0.0
info:
  version: 3.3.0
  title: FactSet Symbology API
  contact:
    name: FactSet Research Systems
    email: [email protected]
  description: >
    The FactSet Symbology API provides symbol resolution services, allowing
    clients to translate market identifiers into various symbology types such
    as, FactSet Permanent Identifiers, CUSIP, ISIN, SEDOL, Tickers, and LEIs.
    <p>Factset's Symbology API sits at the center of its hub-and-spoke data
    model, enabling you to quickly harmonize the expanding catalog of Content
    APIs.</p>
servers:
  - url: https://api.factset.com/content
    description: Production
security:
  - BasicAuth: []
paths:
  /symbology/v3/identifier-resolution:
    get:
      tags:
        - Symbology
      summary: >-
        Factset Returns the specified output identifiers for the specified input identifier.
      operationId: identifierResolution
      description: >
        The Identifier Resolution endpoint provides flexibility for requesting
        and receiving both third-party and FactSet Permanent identifiers. Users
        can both input and output most of the listed identifiers, with
        exceptions noted below.  All input and output symbols must be declared,
        and users have the ability to resolve one input symbol to many different
        output symbols in one request. 

        * **BIC*** - Bank Identification Code (e.g. ABXXHKH1)

        * **CIK** - Edgar Central Index Keys (e.g. 0000100331)

        * **CRD** - Central Registration Depository (e.g. 149722)

        * **DUNS** - Dun & Bradstreet Data Universal Numbering System (e.g.
        687741991) (Input only)

        * **EIN** - Employer Identification Number (e.g. 953540776)

        * **FITCH*** - Fitch Ratings Identifier (e.g. 47504)

        * **LEI** - Legal Entity Identifier (e.g. 549300A6K7JX8EX2QZ33)

        * **MD*** - Moody's Ratings Identifier (e.g. 0823736553)

        * **SPR*** - S&P Ratings Identifier (e.g. 301939)

        * **VALOREN** - Valoren ("Valor") Identification (e.g. 685558) (Input
        only)

        * **WKN*** - German Securities Identification ("Wertpapierkennnummer")
        (e.g. A0MU9T)

        * **UKCH** - UK Company House Identifier (e.g.CE012494)

        * **RSSD** - Federal Reserve RSSD Identifier (1139297)

        * **SEDOL***

        * **CUSIP***

        * **fsymEntityId** - FactSet entity Id

        * **fsymSecurityId** - FactSet security level permanent identifier

        * **fsymRegionalId** - FactSet regional level permanent identifier

        * **fsymListingId** - FactSet listing level permanent identifier

        * **ISIN***

        * **tickerExchange** - Ticker Exchange is a marketplace where stocks,
        bonds, commodities, and derivatives are bought and sold. (e.g.
        GOOGL-NAS)

        * **tickerRegion** - Ticker Region is the geographical region or market
        segment where a particular stock or security is listed and traded. (e.g.
        GOOGL-US)

        * **bloombergFigi** - Bloomberg Listing/Regional/Security Identifier
        (output symbols: bloombergFigiListing, bloombergFigiRegional &
        bloombergFigiSecurity) (e.g. BBG009S39JY5)

        * **bloombergTicker** - Bloomberg Listing and Regional Ticker Identifier
        (output symbols: bloombergRegionalTicker & bloombergListingTicker) (e.g.
        GOOGL UW)

        * **GVKEY** - CompuStat Entity Identifier (e.g. 063172)(Input only)

        * **GVKEY & IID** - CompuStat Security Identifier (e.g.063172001) (Input
        only)

        * **JCN** - Japan Corporate Number (e.g. 9011101021173)

        * **LoanX** - Markit Bank Loan Security Identifier (e.g. LX130668)
        (Input only)

        * **MarkitRed** - Markit Entity Identifier (e.g. 3D337C) (Input only)


        **These symbol types require additional subscriptions. If you would like
        to gain access to these symbol types, please contact your FactSet
        Account Team or "Report Issue" above and our support teams can assist.*
      parameters:
        - $ref: '#/components/parameters/getIdsResolution'
        - $ref: '#/components/parameters/getInputSymbolType'
        - $ref: '#/components/parameters/getOutputSymbolTypes'
      responses:
        '200':
          description: Symbol translation objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/identifierResolutionResponse'
              examples:
                Translate Single Security or Entity Identifier:
                  $ref: '#/components/examples/singleIdentifierResolution'
                Translate Multiple Security or Entity Identifiers:
                  $ref: '#/components/examples/multipleIdentifierResolution'
        '400':
          description: >-
            Bad Request. This can occur for several reasons. Please review the
            "message" for more details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse'
              examples:
                Bad Request - Missing Required Parameter:
                  $ref: '#/components/examples/badRequestRequiredParameter'
                Bad Request - Invalid Parameter:
                  $ref: '#/components/examples/badRequestInvalidParameters'
                Bad Request - Malformed JSON:
                  $ref: '#/components/examples/badRequestMalformedJSON'
                Bad Request - Read Timeout:
                  $ref: '#/components/examples/badRequestReadTimeout'
        '401':
          $ref: '#/components/responses/401Legacy'
        '403':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse'
              examples:
                Forbidden:
                  $ref: '#/components/examples/forbidden'
                Forbidden Identifier:
                  $ref: '#/components/examples/forbiddenIdentifier'
        '415':
          $ref: '#/components/responses/415Legacy'
        '500':
          $ref: '#/components/responses/500Legacy'
    post:
      tags:
        - Symbology
      summary: Factset Returns the specified output identifiers for the given input identifier.
      description: >
        The Identifier Resolution endpoint provides flexibility for requesting
        and receiving both third-party and FactSet Permanent identifiers. Users
        can both input and output most of the listed identifiers, with
        exceptions noted below.  All input and output symbols must be declared,
        and users have the ability to resolve one input symbol to many different
        output symbols in one request. 

        * **BIC*** - Bank Identification Code (e.g. ABXXHKH1)

        * **CIK** - Edgar Central Index Keys (e.g. 0000100331)

        * **CRD** - Central Registration Depository (e.g. 149722)

        * **DUNS** - Dun & Bradstreet Data Universal Numbering System (e.g.
        687741991) (Input only)

        * **EIN** - Employer Identification Number (e.g. 953540776)

        * **FITCH*** - Fitch Ratings Identifier (e.g. 47504)

        * **LEI** - Legal Entity Identifier (e.g. 549300A6K7JX8EX2QZ33)

        * **MD*** - Moody's Ratings Identifier (e.g. 0823736553)

        * **SPR*** - S&P Ratings Identifier (e.g. 301939)

        * **VALOREN** - Valoren ("Valor") Identification (e.g. 685558) (Input
        only)

        * **WKN*** - German Securities Identification ("Wertpapierkennnummer")
        (e.g. A0MU9T)

        * **UKCH** - UK Company House Identifier (e.g.CE012494)

        * **RSSD** - Federal Reserve RSSD Identifier (1139297)

        * **SEDOL***

        * **CUSIP***

        * **fsymEntityId** - FactSet entity Id

        * **fsymSecurityId** - FactSet security level permanent identifier

        * **fsymRegionalId** - FactSet regional level permanent identifier

        * **fsymListingId** - FactSet listing level permanent identifier

        * **ISIN***

        * **tickerExchange** - Ticker Exchange, a marketplace where stocks,
        bonds, commodities, and derivatives are bought and sold. (e.g.
        GOOGL-NAS)

        * **tickerRegion** - Ticker Region, geographical region or market
        segment where a particular stock or security is listed and traded. (e.g.
        GOOGL-US)

        * **bloombergFigi** - Bloomberg Listing/Regional/Security Identifier
        (output symbols: bloombergFigiListing, bloombergFigiRegional &
        bloombergFigiSecurity ) (e.g. BBG009S39JY5)

        * **bloombergTicker** - Bloomberg Listing and Regional Ticker Identifier
        (output symbols: bloombergRegionalTicker & bloombergListingTicker) (e.g.
        GOOGL UW)

        * **GVKEY** - CompuStat Entity Identifier (e.g. 063172)(Input only)

        * **GVKEY & IID** - CompuStat Security Identifier (e.g.063172001) (Input
        only)

        * **JCN** - Japan Corporate Number (e.g. 9011101021173)

        * **LoanX** - Markit Bank Loan Security Identifier (e.g. LX130668)
        (Input only)

        * **MarkitRed** - Markit Entity Identifier (e.g. 3D337C) (Input only)


        **These symbol types require additional subscriptions. If you would like
        to gain access to these symbol types, please contact your FactSet
        Account Team or "Report Issue" above and our support teams can assist.*
      operationId: batchIdentifierResolution
      requestBody:
        required: true
        description: Request Body for Identifier Resolution.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/identifierResolutionRequest'
            examples:
              Translate Single Security or Entity Identifier:
                $ref: '#/components/examples/singleIdentifierResolutionPost'
              Translate Multiple Security or Entity Identifiers:
                $ref: '#/components/examples/multipleIdentifierResolutionPost'
      responses:
        '200':
          description: Symbol translation objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/identifierResolutionResponse'
              examples:
                Translate Single Security or Entity Identifier:
                  $ref: '#/components/examples/singleIdentifierResolution'
                Translate Multiple Security or Entity Identifiers:
                  $ref: '#/components/examples/multipleIdentifierResolution'
        '400':
          description: >-
            Bad Request. This can occur for several reasons. Please review the
            "message" for more details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse'
              examples:
                Bad Request - Missing Required Parameter:
                  $ref: '#/components/examples/badRequestRequiredParameter'
                Bad Request - Invalid Parameter:
                  $ref: '#/components/examples/badRequestInvalidParameters'
                Bad Request - Malformed JSON:
                  $ref: '#/components/examples/badRequestMalformedJSON'
                Bad Request - Read Timeout:
                  $ref: '#/components/examples/badRequestReadTimeout'
        '401':
          $ref: '#/components/responses/401Legacy'
        '403':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponse'
              examples:
                Forbidden:
                  $ref: '#/components/examples/forbidden'
                Forbidden Identifier:
                  $ref: '#/components/examples/forbiddenIdentifier'
        '415':
          $ref: '#/components/responses/415Legacy'
        '500':
          $ref: '#/components/responses/500Legacy'
  /symbology/v3/historical-identifier-resolution:
    get:
      tags:
        - Symbology
      summary: >-
        Factset Returns the specified historical output identifiers for the given input identifier.
      operationId: historicalIdentifierResolution
      description: >
        This endpoint enables the retrieval of historical CUSIP, SEDOL, ISIN,
        and tickerRegion identifiers. Users can input any of the listed
        identifiers and resolve one input symbol to multiple different output
        symbols in a single request. Both input and output symbols must be
        declared. The `asOfDate` field allows users to retrieve the full history
        of an identifier or the specific identifiers as of the requested date. 

        * **BIC*** - Bank Identification Code (e.g. ABXXHKH1) (Input only)

        * **CIK** - Edgar Central Index Keys (e.g. 0000100331) (Input only)

        * **CRD** - Central Registration Depository (e.g. 149722) (Input only)

        * **DUNS** - Dun & Bradstreet Data Universal Numbering System (e.g.
        687741991) (Input only)

        * **EIN** - Employer Identification Number (e.g. 953540776) (Input only)

        * **FITCH*** - Fitch Ratings Identifier (e.g. 47504) (Input only)

        * **LEI** - Legal Entity Identifier (e.g. 549300A6K7JX8EX2QZ33) (Input
        only)

        * **MD*** - Moody's Ratings Identifier (e.g. 0823736553) (Input only)

        * **SPR*** - S&P Ratings Identifier (e.g. 301939) (Input only)

        * **VALOREN** - Valoren ("Valor") Identification (e.g. 685558) (Input
        only)

        * **WKN*** - German Securities Identification ("Wertpapierkennnummer")
        (e.g. A0MU9T) (Input only)

        * **UKCH** - UK Company House Identifier (e.g.CE012494) (Input only)

        * **RSSD** - Federal Reserve RSSD Identifier (1139297) (Input only)

        * **SEDOL***

        * **CUSIP***

        * **fsymEntityId** - FactSet entity Id (Input only)

        * **fsymSecurityId** - FactSet security level permanent identifier
        (Input only)

        * **fsymRegionalId** - FactSet regional level permanent identifier
        (Input only)

        * **fsymListingId** - FactSet listing level permanent identifier (Input
        only)

        * **ISIN***

        * **tickerExchange** - Ticker Exchange is a marketplace where stocks,
        bonds, commodities, and derivatives are bought and sold. (e.g.
        GOOGL-NAS) (Input only)

        * **tickerRegion** - Ticker Region is the geographical region or market
        segment where a particular stock or security is listed and traded. (e.g.
        GOOGL-US)

        * **bloombergFigi** - Bloomberg Listing/Regional/Security Identifier
        (output symbols: bloombergFigiListing, bloombergFigiRegional &
        bloombergFigiSecurity ) (e.g. BBG009S39JY5) (Input only)

        * **bloombergTicker** - Bloomberg Listing and Regional Ticker Identifier
        (output symbols: bloombergRegionalTicker & bloombergListingTicker) (e.g.
        GOOGL UW) (Input only)

        * **GVKEY** - CompuStat Entity Identifier (e.g. 063172) (Input only)

        * **GVKEY & IID** - CompuStat Security Identifier (e.g.063172001) (Input
        only)

        * **JCN** - Japan Corporate Number (e.g. 9011101021173) (Input only)

        * **LoanX** - Markit Bank Loan Security Identifier (e.g. LX130668)
        (Input only)

        * **MarkitRed** - Markit Entity Identifier (e.g. 3D337C) (Input only) 


        **These symbol types require additional subscriptions. If you would like
        to gain access to these symbol types, please contact your FactSet
        Account Team or "Report Issue" above and our support teams can assist.*
      parameters:
        - $ref: '#/components/parameters/getIdsResolution'
        - $ref: '#/components/parameters/getHistoricalInputSymbolType'
        - $ref: '#/components/parameters/getHistoricalOutputSymbolTypes'
        - $ref: '#/components/parameters/getAsOfDate'
      responses:
        '200':
          description: Symbol translation objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/identifierResolutionHistoricalResponse'
              examples:
                Translate Single Security or Entity Identifier:
                  $ref: '#/components/examples/singleHistoricalIdentifierResolution'
                Translate Multiple Security or Entity Identifiers:
                  $ref: '#/components/examples/multipleHistoricalIdentifierResolution'
        '400':
          description: >-
            Bad Request. This can occur for several reasons. Please review the
            "message" for more details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponseHistorical'
              examples:
                Bad Request - Missing Required Parameter:
                  $ref: '#/components/examples/badRequestRequiredParameterHistorical'
                Bad Request - Invalid Parameter:
                  $ref: '#/components/examples/badRequestInvalidParametersHistorical'
                Bad Request - Malformed JSON:
                  $ref: '#/components/examples/badRequestMalformedJSONHistorical'
                Bad Request - Read Timeout:
                  $ref: '#/components/examples/badRequestReadTimeoutHistorical'
        '401':
          $ref: '#/components/responses/401'
        '403':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponseHistorical'
              examples:
                Forbidden:
                  $ref: '#/components/examples/forbiddenHistorical'
                Forbidden Identifier:
                  $ref: '#/components/examples/forbiddenIdentifierHistorical'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
    post:
      tags:
        - Symbology
      summary: >-
        Factset Returns the specified historical output identifiers for the given input identifier.
      description: >
        This endpoint enables the retrieval of historical CUSIP, SEDOL, ISIN,
        and tickerRegion identifiers. Users can input any of the listed
        identifiers and resolve one input symbol to multiple different output
        symbols in a single request. Both input and output symbols must be
        declared. The `asOfDate` field allows users to retrieve the full history
        of an identifier or the specific identifiers as of the requested date. 

        * **BIC*** - Bank Identification Code (e.g. ABXXHKH1) (Input only)

        * **CIK** - Edgar Central Index Keys (e.g. 0000100331) (Input only)

        * **CRD** - Central Registration Depository (e.g. 149722) (Input only)

        * **DUNS** - Dun & Bradstreet Data Universal Numbering System (e.g.
        687741991) (Input only)

        * **EIN** - Employer Identification Number (e.g. 953540776) (Input only)

        * **FITCH*** - Fitch Ratings Identifier (e.g. 47504) (Input only)

        * **LEI** - Legal Entity Identifier (e.g. 549300A6K7JX8EX2QZ33) (Input
        only)

        * **MD*** - Moody's Ratings Identifier (e.g. 0823736553) (Input only)

        * **SPR*** - S&P Ratings Identifier (e.g. 301939) (Input only)

        * **VALOREN** - Valoren ("Valor") Identification (e.g. 685558) (Input
        only)

        * **WKN*** - German Securities Identification ("Wertpapierkennnummer")
        (e.g. A0MU9T) (Input only)

        * **UKCH** - UK Company House Identifier (e.g.CE012494) (Input only)

        * **RSSD** - Federal Reserve RSSD Identifier (1139297) (Input only)

        * **SEDOL***

        * **CUSIP***

        * **fsymEntityId** - FactSet entity Id (Input only)

        * **fsymSecurityId** - FactSet security level permanent identifier
        (Input only)

        * **fsymRegionalId** - FactSet regional level permanent identifier
        (Input only)

        * **fsymListingId** - FactSet listing level permanent identifier (Input
        only)

        * **ISIN***

        * **tickerExchange** - Ticker Exchange, a marketplace where stocks,
        bonds, commodities, and derivatives are bought and sold. (e.g.
        GOOGL-NAS) (Input only)

        * **tickerRegion** - Ticker Region, geographical region or market
        segment where a particular stock or security is listed and traded. (e.g.
        GOOGL-US)

        * **bloombergFigi** - Bloomberg Listing/Regional/Security Identifier
        (output symbols: bloombergFigiListing, bloombergFigiRegional &
        bloombergFigiSecurity ) (e.g. BBG009S39JY5) (Input only)

        * **bloombergTicker** - Bloomberg Listing and Regional Ticker Identifier
        (output symbols: bloombergRegionalTicker & bloombergListingTicker) (e.g.
        GOOGL UW) (Input only)

        * **GVKEY** - CompuStat Entity Identifier (e.g. 063172) (Input only)

        * **GVKEY & IID** - CompuStat Security Identifier (e.g.063172001) (Input
        only)

        * **JCN** - Japan Corporate Number (e.g. 9011101021173) (Input only)

        * **LoanX** - Markit Bank Loan Security Identifier (e.g. LX130668)
        (Input only)

        * **MarkitRed** - Markit Entity Identifier (e.g. 3D337C) (Input only)


        **These symbol types require additional subscriptions. If you would like
        to gain access to these symbol types, please contact your FactSet
        Account Team or "Report Issue" above and our support teams can assist.*
      operationId: batchHistoricalIdentifierResolution
      requestBody:
        required: true
        description: Request Body for Historical Identifier Resolution.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/identifierResolutionHistoricalRequest'
            examples:
              Translate Single Security or Entity Identifier:
                $ref: '#/components/examples/singleHistoricalIdentifierResolutionPost'
              Translate Multiple Security or Entity Identifiers:
                $ref: >-
                  #/components/examples/multipleHistoricalIdentifierResolutionPost
      responses:
        '200':
          description: Symbol translation objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/identifierResolutionHistoricalResponse'
              examples:
                Translate Single Security or Entity Identifier:
                  $ref: '#/components/examples/singleHistoricalIdentifierResolution'
                Translate Multiple Security or Entity Identifiers:
                  $ref: '#/components/examples/multipleHistoricalIdentifierResolution'
        '400':
          description: >-
            Bad Request. This can occur for several reasons. Please review the
            "message" for more details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponseHistorical'
              examples:
                Bad Request - Missing Required Parameter:
                  $ref: '#/components/examples/badRequestRequiredParameterHistorical'
                Bad Request - Invalid Parameter:
                  $ref: '#/components/examples/badRequestInvalidParametersHistorical'
                Bad Request - Malformed JSON:
                  $ref: '#/components/examples/badRequestMalformedJSONHistorical'
                Bad Request - Read Timeout:
                  $ref: '#/components/examples/badRequestReadTimeoutHistorical'
        '401':
          $ref: '#/components/responses/401'
        '403':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorResponseHistorical'
              examples:
                Forbidden:
                  $ref: '#/components/examples/forbiddenHistorical'
                Forbidden Identifier:
                  $ref: '#/components/examples/forbiddenIdentifierHistorical'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
components:
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
  parameters:
    getIdsResolution:
      name: ids
      in: query
      schema:
        type: array
        items:
          type: string
        minItems: 1
        maxItems: 3000
      required: true
      explode: false
      description: >
        Requested security or entity identifiers. All requested identifiers must
        be of the same type. This request value is sent back in the response as,
        `requestId'. <p>***ids limit** =  100 per request*</p>
          *<p>NOTE:  GET Method URL request lines are also limited to a total
          length of 8192 bytes (8KB). In cases where the service allows for thousands
          of ids, which may lead to exceeding this request line limit of 8KB, its
          advised for any requests with large request lines to be requested through
          the respective "POST" method.</p>*
      examples:
        singleMarketId:
          summary: One Security or Entity Identifier
          value:
            - GOOGL-US
        multipleMarketIds:
          summary: Multiple Security or Entity Identifiers
          value:
            - GOOGL-US
            - AAPL-US
            - MSFT-US
    getInputSymbolType:
      name: inputSymbolType
      in: query
      schema:
        type: string
        enum:
          - BIC
          - CIK
          - CRD
          - DUNS
          - EIN
          - FITCH
          - LEI
          - MD
          - SPR
          - VALOREN
          - WKN
          - UKCH
          - RSSD
          - SEDOL
          - CUSIP
          - fsymEntityId
          - fsymSecurityId
          - fsymRegionalId
          - fsymListingId
          - ISIN
          - tickerExchange
          - tickerRegion
          - bloombergFigi
          - bloombergTicker
          - GVKEY
          - GVKEY & IID
          - JCN
          - LoanX
          - MarkitRed
        default: tickerRegion
      required: true
      description: >
        The type of symbol being inputted. Only one type of symbol is accepted
        with each request.
    getHistoricalInputSymbolType:
      name: inputSymbolType
      in: query
      schema:
        type: string
        enum:
          - BIC
          - CIK
          - CRD
          - DUNS
          - EIN
          - FITCH
          - LEI
          - MD
          - SPR
          - VALOREN
          - WKN
          - UKCH
          - RSSD
          - SEDOL
          - CUSIP
          - fsymEntityId
          - fsymSecurityId
          - fsymRegionalId
          - fsymListingId
          - ISIN
          - tickerExchange
          - tickerRegion
          - bloombergFigi
          - bloombergTicker
          - GVKEY
          - GVKEY & IID
          - JCN
          - LoanX
          - MarkitRed
      required: true
      example: tickerRegion
      description: >
        The type of symbol being inputted. Only one type of symbol is accepted
        with each request.
    getOutputSymbolTypes:
      name: outputSymbolTypes
      in: query
      schema:
        type: array
        items:
          type: string
          enum:
            - BIC
            - CIK
            - CRD
            - EIN
            - FITCH
            - LEI
            - MD
            - SPR
            - WKN
            - UKCH
            - RSSD
            - SEDOL
            - CUSIP
            - fsymEntityId
            - fsymSecurityId
            - fsymRegionalId
            - fsymListingId
            - ISIN
            - tickerExchange
            - tickerRegion
            - JCN
            - bloombergListingTicker
            - bloombergRegionalTicker
            - bloombergFigiListing
            - bloombergFigiRegional
            - bloombergFigiSecurity
      required: true
      explode: false
      description: >-
        The type of symbols being outputted. Multiple types of symbols can be
        outputted with each request. The user must be authorized for the
        requested identifier type.
      example:
        - CUSIP
        - SEDOL
    getHistoricalOutputSymbolTypes:
      name: outputSymbolTypes
      in: query
      schema:
        type: array
        items:
          type: string
          enum:
            - SEDOL
            - CUSIP
            - ISIN
            - tickerRegion
      required: true
      explode: false
      description: >-
        The type of symbols being outputted. Multiple types of symbols can be
        outputted with each request. The user must be authorized for the
        requested identifier type.
      example:
        - CUSIP
        - SEDOL
    getAsOfDate:
      name: asOfDate
      in: query
      schema:
        type: string
        format: date
      required: false
      description: >
        As of date for historical symbol request in YYYY-MM-DD format.

        If no `asOfDate` is requested, the response will include the full
        history of the identifier.
      example: '2010-01-01'
  schemas:
    identifierResolutionRequest:
      title: Identifier Resolution Request
      description: Request object for Identifier Resolution endpoint.
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/getIdsResolution'
        inputSymbolType:
          $ref: '#/components/schemas/getInputSymbolType'
        outputSymbolTypes:
          $ref: '#/components/schemas/getOutputSymbolTypes'
      required:
        - ids
        - inputSymbolType
        - outputSymbolTypes
    identifierResolutionResponse:
      title: Identifier Resolution Response
      description: Response object for Identifier Resolution endpoint.
      type: object
      properties:
        data:
          description: Array of symbol translation objects.
          type: array
          items:
            $ref: '#/components/schemas/identifierResolution'
    identifierResolution:
      title: Identifier Resolution
      description: Identifier Resolution data object.
      type: object
      properties:
        requestId:
          type: string
          description: Identifier inputted in the request.
          example: GOOGL-US
          nullable: false
        inputSymbolType:
          type: string
          description: The type of identifier inputted in the request
          example: tickerRegion
          nullable: false
        name:
          type: string
          description: Name of the requested identifier
          example: Alphabet Inc. Class A
          nullable: true
        frefListingExchange:
          type: string
          description: >-
            The 3 digit fref exchange code for the primary exchange of the
            security
          example: USA
          nullable: true
        currency:
          type: string
          description: The 3 digit ISO code for the currency
          example: USD
          nullable: true
      additionalProperties:
        title: Requested output symbol type
        description: >
          The Key in the Key-Value pair is the name of the requested
          outputSymbolType. The Value in the Key-Value is the requestId
          translated to the outputSymbolType. 
        example: '"cusip": "02079K305"'
        nullable: true
        type: string
    identifierResolutionHistoricalRequest:
      title: Historical Identifier Resolution Request
      description: Request object for Historical Identifier Resolution endpoint.
      type: object
      properties:
        data:
          $ref: '#/components/schemas/identifierResolutionHistoricalRequestBody'
      required:
        - data
    identifierResolutionHistoricalRequestBody:
      title: Historical Identifier Resolution Request
      description: Request object for Historical Identifier Resolution endpoint.
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/getIdsResolution'
        inputSymbolType:
          $ref: '#/components/schemas/getHistoricalInputSymbolType'
        outputSymbolTypes:
          $ref: '#/components/schemas/getHistoricalOutputSymbolTypes'
        asOfDate:
          $ref: '#/components/schemas/getAsOfDate'
      required:
        - ids
        - inputSymbolType
        - outputSymbolTypes
    identifierResolutionHistoricalResponse:
      title: Historical Identifier Resolution Response
      description: Response object for Historical Identifier Resolution endpoint.
      type: object
      properties:
        data:
          description: Array of symbol translation objects.
          type: array
          items:
            $ref: '#/componen

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