Factset Factset Entity API

openapi: 3.0.3
info:
  title: Factset Analytics Datastore About Factset Entity 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: Factset Entity
paths:
  /factset-entity/v1/entity-references:
    get:
      summary: Factset Returns an entity reference profiles for an individual entity
      description: 'Returns an Entity reference profile for the requested Entity Id(s). Data points include - Ultimate Parent Id, Credit Parent Id, Headquarters location details, Website URL, and Business Description.

        '
      tags:
      - Factset Entity
      operationId: getEntityReferences
      parameters:
      - $ref: '#/components/parameters/ids'
      responses:
        '200':
          description: Fetches Entity Reference data for a list of ids.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/entityReferenceResponse'
        '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:
      summary: Factset Returns an entity reference data for a list of ids.
      description: 'Returns an entity reference object for the requested entity ids. Data points include - ultimate parent id, headquarters location details, credit parent id, website, and business description.

        '
      tags:
      - Factset Entity
      operationId: postEntityReferences
      requestBody:
        required: true
        description: Request Body to request a list of Entity Reference objects.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/entityReferenceRequest'
      responses:
        '200':
          description: Entity Reference data items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/entityReferenceResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-entity/v1/entity-securities:
    get:
      summary: Factset Returns all Equity Exchange Listings and all debt instruments issued for the requested entity.
      description: 'Returns all Equity Exchange Listings (ticker-exchange) and all debt instruments (cusips) issued for the requested entity.

        '
      tags:
      - Factset Entity
      operationId: getEntitySecurities
      parameters:
      - $ref: '#/components/parameters/ids'
      - $ref: '#/components/parameters/securityType'
      responses:
        '200':
          description: Entity Security data items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/entitySecuritiesResponse'
        '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:
      summary: Factset Returns all Equity Exchange Listings and all debt instruments issued for the requested entity.
      description: 'Returns all Equity Exchange Listings (ticker-exchange) and all debt instruments (cusips) issued for the requested entity.

        '
      tags:
      - Factset Entity
      operationId: postEntitySecurities
      requestBody:
        required: true
        description: Request Body to request a list of Entity Security objects.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/entitySecuritiesRequest'
      responses:
        '200':
          description: Successful Response producing an array of Entity Security Objects
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/entitySecuritiesResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-entity/v1/entity-structures:
    get:
      summary: Factset Returns all active or inactive entities and respective levels below the requested entity id.
      description: 'Returns all active or inactive entities below the requested entity id.

        '
      tags:
      - Factset Entity
      operationId: getEntityStructure
      parameters:
      - $ref: '#/components/parameters/structureIds'
      - $ref: '#/components/parameters/level'
      - $ref: '#/components/parameters/active'
      responses:
        '200':
          description: Fetches Entity Structure
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/entityStructureResponse'
        '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:
      summary: Factset Returns all active or inactive entities below the requested entity id.
      description: 'Returns all active or inactive entities and respective levels below the requested entity id.

        '
      tags:
      - Factset Entity
      operationId: postEntityStructure
      requestBody:
        required: true
        description: Request Body to request a list of Entity Structure objects.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/entityStructureRequest'
      responses:
        '200':
          description: Entity Structure data items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/entityStructureResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-entity/v1/ultimate-entity-structures:
    get:
      summary: Factset Returns the full ultimate parent entity hiearachy. Control levels and active status of underlying entities.
      description: 'Returns full ultimate entity structure including ultimate parent and all subordinates. Will accept entity from any level of entity structure or active vs. inactive status of entity.

        '
      tags:
      - Factset Entity
      operationId: getUltimateEntityStructure
      parameters:
      - $ref: '#/components/parameters/structureIds'
      - $ref: '#/components/parameters/level'
      - $ref: '#/components/parameters/active'
      responses:
        '200':
          description: Fetches Ultimate Entity Structure data for a list of ids.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ultimateEntityStructureResponse'
        '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:
      summary: Factset Returns all active or inactive entities and respective levels below the requested entity id.
      description: 'Returns all active or inactive entities and respective levels below the requested entity id.

        '
      tags:
      - Factset Entity
      operationId: postUltimateEntityStructure
      requestBody:
        required: true
        description: Request Body to request a list of Ultimate Entity Structure objects.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ultimateEntityStructureRequest'
      responses:
        '200':
          description: Ultimate Entity Structure data items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ultimateEntityStructureResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-entity/v1/entity-reference-chi:
    get:
      summary: Factset Returns entity reference data in Chinese for an individual entity.
      description: 'Returns entity reference data in Chinese for the requested Id(s). Data points include Business Description and Entity Name in both simplified and traditional Chinese.

        '
      tags:
      - Factset Entity
      operationId: getEntityReferenceChi
      parameters:
      - $ref: '#/components/parameters/idsChi'
      responses:
        '200':
          description: Fetches Entity Reference data in Chinese for a list of ids.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/entityReferenceChiResponse'
        '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:
      summary: Factset Returns entity reference data in Chinese for an individual entity.
      description: 'Returns entity reference data in Chinese for the requested Id(s). Data points include Business Description and Entity Name in both simplified and traditional Chinese.

        '
      tags:
      - Factset Entity
      operationId: getEntityReferenceChiForList
      requestBody:
        required: true
        description: Request Body to request a list of Entity Reference Chinese objects.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/entityReferenceChiRequest'
      responses:
        '200':
          description: Fetches Entity Reference data in Chinese for a list of ids.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/entityReferenceChiResponse'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
  /factset-entity/v1/hist-credit-parent:
    get:
      summary: Factset Returns historical credit parents for the requested id(s).
      description: 'Returns the credit parent for requested fixed income ids. Point in time credit parent retrieval is

        also available if an asOfDate is provided. The full credit parent history of a security is returned if

        no asOfDate is provided.


        This endpoint uses a seven day calendar to account for changes that occur on all seven days of the week.

        '
      tags:
      - Factset Entity
      operationId: getHistCredParent
      parameters:
      - $ref: '#/components/parameters/hcpIds'
      - $ref: '#/components/parameters/asOfDate'
      responses:
        '200':
          description: Fetches Credit Parents
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/creditParentResponse'
        '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:
      summary: Factset Returns historical credit parents for the requested id(s).
      description: 'Returns the credit parent for requested fixed income ids. Point in time credit parent retrieval is

        also available if an asOfDate is provided. The full credit parent history of a security is returned if

        no asOfDate is provided.


        This endpoint uses a seven day calendar to account for changes that occur on all seven days of the week.

        '
      tags:
      - Factset Entity
      operationId: postHistCredParent
      requestBody:
        required: true
        description: Request Body to request a list of credit parent objects.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/creditParentRequest'
      responses:
        '200':
          description: Credit parent data items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/creditParentResponse'
        '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:
  schemas:
    entitySecurities:
      title: Entity Securities
      type: object
      properties:
        fsymId:
          type: string
          description: FactSet Ultimate Parent ID of the Requested Security ID
          example: 001MF1-E
          nullable: true
        fsymSecurityId:
          type: string
          description: FactSet Security ID (-S).
          example: F3PS31-S
          nullable: true
        fsymListingId:
          type: string
          description: FactSet Listing ID (-L). Corresponds to the listing exchange for the requested security. Not applicable for FI instruments.
          example: LVR478-L
          nullable: true
        securityType:
          type: string
          description: The Security Type Code. Security Type Code details and mapping are described on Online Assistant Page 15776 for Equity and Page 16014 for Fixed Income.
          example: BDNT
          enum:
          - SHARE
          - PREFEQ
          - MF_C
          - MF_O
          - ETF_ETF
          - ETF_UVI
          - ETF_NAV
          - ADR
          - GDR
          - NVDR
          - DR
          - ALIEN
          - PREF
          - WARRANT
          - RIGHT
          - UNIT
          - STRUCT
          - TEMP
          - CONV
          - BDNT
          - PFD
          - PASS
          - MM
          - RMBS
          - ABS
          - COVR
          - LKS
          - LAUTH
          - BLDN
          - CMBS
          nullable: true
        listingExchange:
          type: string
          description: The securities primary listing exchange.
          example: NAS
          nullable: true
        securityName:
          type: string
          description: Security name
          example: Amazon.com, Inc. 1.9% 21-AUG-2020
          nullable: true
        fsymEntityId:
          type: string
          description: Unique FactSet-generated identifier representing an entity.
          example: 001MF1-E
          nullable: true
        fsymTickerExchange:
          type: string
          description: The security's ticker-exchange, representing the listing exchange symbol.
          example: AMZN-NAS
          nullable: true
        fsymTickerRegion:
          type: string
          description: The security's regional ticker.
          example: AMZN-US
          nullable: true
        activeFlag:
          type: integer
          description: Indicates if security is active. 1 = Active; 0 = Inactive.
          example: 1
          enum:
          - 0
          - 1
          nullable: true
        requestId:
          type: string
          description: Identifier used in `ids` parameter.  When list of identifiers used, they will be parsed and resolved individually.
          example: AMZN-US
    hcpIds:
      title: ids
      description: 'Security identifiers. FactSet Identifiers, tickers, CUSIP and SEDOL are accepted input.

        '
      type: array
      items:
        type: string
      minItems: 1
      maxItems: 50
      example:
      - CYQYNL-S
      - G17920AA0
      - US40434YTB38
    utlimateEntityStructure:
      title: Ultimate Entity Structure
      type: object
      properties:
        fsymId:
          type: string
          description: Unique FactSet-generated identifier representing an entity for the current entity identifier (-E)
          example: 001MF1-E
          nullable: true
        fsymEntityId:
          type: string
          description: Unique FactSet-generated identifier representing an entity
          example: 001MF1-E
          nullable: true
        ultimateParentId:
          type: string
          description: The ultimate parent id of the entity.
          example: 001MF1-E
          nullable: true
        parentEntityId:
          type: string
          description: Within the hierarchy, this id represents the immediate parent entity id for the level directly above. Ultimate parent id will return a blank string.
          example: 001MF1-E
          nullable: true
        level:
          type: integer
          description: Level within the ultimate entity structure. This is taken from the perspective of the ultimate parent id and the full entity hierarchy.
          example: 3
          nullable: true
        inactive:
          type: integer
          description: A flag for inactive securities; whereby 1 = inactive and 0 = active.
          example: 0
          nullable: true
        description:
          type: string
          description: The proper name and entity type for the entity.
          example: Whole Foods Market, Inc. (Subsidiary)
          nullable: true
        requestId:
          type: string
          description: Identifier used in `ids`.
          example: AMZN-US
    entityReferenceRequest:
      title: Entity Reference Request
      description: Entity Reference Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/ids'
      required:
      - ids
    creditParentRequest:
      title: Historical Credit Parent Request
      description: Historical Credit Parent Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/hcpIds'
        asOfDate:
          $ref: '#/components/schemas/asOfDate'
      required:
      - ids
    ids:
      title: ids
      description: 'Security or Entity identifiers. FactSet Identifiers, tickers, CUSIP and SEDOL are accepted input.

        '
      type: array
      items:
        type: string
      minItems: 1
      maxItems: 3000
      example:
      - FDS-US
      - 0FPWZZ-E
      - TSLA-US
    active:
      title: active
      description: Controls active or inactive securities returned in the hierarchy. Enter 1 to return only active entities, 0 for inactive entities, and -1 for all active and inactive.
      type: integer
      default: -1
      example: 1
      maximum: 1
      minimum: -1
    creditParent:
      title: Credit Parent
      type: object
      properties:
        fsymId:
          type: string
          description: Unique FactSet-generated identifier representing an entity for the current entity identifier (-E)
          example: 0028BD-E
          nullable: true
        requestId:
          type: string
          description: Identifier used in `ids`.
          example: CYQYNL-S
        entityProperName:
          type: string
          description: The proper name for the credit parent entity.
          example: BNP Paribas S.A. Class A
          nullable: true
        factsetCreditParentId:
          type: string
          description: This id represents the credit parent entity id.
          example: 0028BD-E
          nullable: true
        asOfDate:
          type: string
          format: date
          description: The effective date of this record in YYYY-MM-DD format. If an asOfDate is not specified in the request, this field will be null in the response.
          example: '2020-01-01'
          nullable: true
        effectiveStartDate:
          type: string
          format: date
          description: The initial effective date of this record in YYYY-MM-DD format.
          example: '1996-05-28'
          nullable: true
        effectiveEndDate:
          type: string
          format: date
          description: The last day on which this record is effective date in YYYY-MM-DD format.
          example: '2001-05-28'
          nullable: true
    entityStructureResponse:
      type: object
      title: Entity Structure Response
      properties:
        data:
          description: Array of Entity Structure objects.
          type: array
          items:
            $ref: '#/components/schemas/entityStructure'
    idsChi:
      title: ids
      description: 'Security or Entity identifiers. FactSet Identifiers, tickers, CUSIP, BBG and SEDOL are accepted input.

        '
      type: array
      items:
        type: string
      minItems: 1
      maxItems: 1500
      example:
      - 05X6LC-E
      - 062T6N-E
    entityReferenceChiRequest:
      title: Entity Reference Chinese Request
      description: Entity Reference Request Body
      type: object
      properties:
        ids:
          $ref: '#/components/schemas/idsChi'
      required:
      - ids
    entityStructure:
      title: Entity Structure
      type: object
      properties:
        fsymId:
          type: string
          description: Unique FactSet-generated identifier representing an entity for the current entity identifier (-E)
          example: 001MF1-E
          nullable: true
        fsymEntityId:
          type: string
          description: Unique FactSet-generated identifier representing an entity
          example: 001MF1-E
          nullable: true
        ultimateParentId:
          type: string
          description: The ultimate parent id of the entity.
          example: 001MF1-E
          nullable: true
        parentEntityId:
          type: string
          description: Within the hierarchy, this id represents the immediate parent entity id for the level directly above. Ultimate parent id will return a blank string.
          example: 001MF1-E
          nullable: true
        level:
          type: integer
          description: Controls the levels returned in the hierarchy. Use -1 to return all levels, or 1-n for a specific level.
          example: 2
          nullable: true
        inactive:
          type: integer
          description: A flag for inactive securities; whereby 1 = inactive and 0 = active.
          example: 0
          nullable: true
        description:
          type: string
          description: The proper name and entity type for the entity.
          example: Whole Foods Market, Inc. (Subsidiary)
          nullable: true
        requestId:
          type: string
          description: Identifier used in `ids`.
          example: AMZN-US
    ultimateEntityStructureResponse:
      type: object
      title: Entity Structure Response
      properties:
        data:
          description: Array of Entity Structure objects.
          type: array
          items:
            $ref: '#/components/schemas/utlimateEntityStructure'
    entityReferenceChi:
      title: Entity Profile
      type: object
      properties:
        fsymId:
          type: string
          description: Unique FactSet-generated identifier representing an entity for the current entity identifier (-E)
          example: 062T6N-E
          nullable: true
        fsymEntityId:
          type: string
          description: Unique FactSet-generated identifier representing an entity
          example: 062T6N-E
          nullable: true
        simplifiedChineseName:
          type: string
          description: The entity name in Simplified Chinese.
          example: 百川能源股份有限公司
          nullable: true
        traditionalChineseName:
          type: string
          description: The entity name in Traditional Chinese.
          example: 百川能源股份有限公司
          nullable: true
        entityProperName:
          type: string
          description: Name that the entity is commonly referred to as, normalized and in proper case.
          example: Bestsun Energy Co., Ltd.
          nullable: true
        simplifiedChineseDescription:
          type: string
          description: Extended business description for the requested entity in Simplified Chinese.
          example: 百川能源股份有限公司前身为武汉长江印刷股份有限(集团)公司,系由原武汉印刷厂、北京京华信托投资公司、深圳万科企业股份有限公司联合发起组建,于1992年3月18日正式成立。公司主营业务为城市管道燃气销售、燃气工程安装、燃气具销售。
          nullable: true
        traditionalChineseDescription:
          type: string
          description: Extended business description for the requested entity in Traditional Chinese.
          example: 百川能源股份有限公司前身為武漢長江印刷股份有限(集團)公司,系由原武漢印刷廠、北京京華信託投資公司、深圳萬科企業股份有限公司聯合發起組建,於1992年3月18日正式成立。公司主營業務為城市管道燃氣銷售、燃氣工程安裝、燃氣具銷售。
          nullable: true
        requestId:
          type: string
          description: Identifier used in "ids" parameter. When list of identifiers used, they will be parsed and resolved individually.
          example: 062T6N-E
    entityReferenceChiResponse:
      type: object
      title: Entity Reference Chinese Response
      properties:
        data:
          description: Array of Entity Reference objects.
          type: array
          items:
            $ref: '#/components/schemas/entityReferenceChi'
    entityReferenceResponse:
      type: object
      title: Entity Reference Response
      properties:
        data:
          description: Array of Entity Reference objects.
          type: array
          items:
            $ref: '#/components/schemas/entityReference'
    entityReference:
      title: Entity Profile
      type: object
      properties:
        fsymId:
          type: string
          description: Unique FactSet-generated identifier representing an entity for the current entity identifier (-E)
          example: 001MF1-E
          nullable: true
        entityProperName:
          type: string
          description: Name that the entity is commonly referred to as, normalized and in proper case.
          example: Amazon.com, Inc.
          nullable: true
        fsymEntityId:
          type: string
          description: Unique FactSet-generated identifier representing an entity
          example: 001MF1-E
          nullable: true
        ultimateParentId:
          type: string
          description: The ultimate parent id of the entity.
          example: 001MF1-E
          nullable: true
        ultimateParentName:
          type: string
          description: Name that the ultimate parent entity is commonly referred to as, normalized and in proper case."
          example: Amazon.com, Inc.
          nullable: true
        creditParentId:
          type: string
          description: 'The credit parent id in which issues debt instruments. The credit parent differs from the ultimate parent if the ultimate parent does not inherit the credit risk associated with an issuer''s debt offerings.

            Credit Parent''s are not Assigned to the Extinct Issues, Governments, Asset-Backed Securities, Trusts, Foundations, Private Equity, Venture Capital, Hedge Funds, or Mutual Funds. FactSet assigns credit parents based on the following methodology -

            * If an issuer (entity A) is considered a direct subsidiary of another entity (entity B), where the parent entity (entity B) has a 100% controlling interest in the issuer (entity A), then the parent entity (entity B) is considered the credit parent.

            * If an operating business is purchased as a portfolio company/operating company (entity A) by a group of private equity firms that establish a holding company (entity B) structure to reflect the collective ownership, and the portfolio company/operating company (entity A) issues debt as part of acquisition financing, then the portfolio company/operating company (entity A) is deemed to be the credit parent, not the holding company (entity B).

            * An issuer must have active debt.

            '
          example: 001MF1-E
          nullable: true
        parentEquityId:
          type: string
          description: The regional parent equity listing id.
          example: MCNYYL-R
          nullable: true
        privateEntityFlag:
          type: integer
          description: Returns 1 if the entity is a Private Company, otherwise, 0.
          example: 0
          nullable: true
        publicEntityFlag:
          type: integer
          description: Returns 1 if the entity is a Public Company, otherwise, 0.
          example: 1
          nullable: true
        securityType:
          type: string
          description: Security type of the identifier, For descriptions of the each security type, visit [OA 15776](https://my.apps.factset.com/oa/pages/15776)
          example: SHARE
          nullable: true
        website:
          type: string
          description: Web page address for the entity
          example: http://www.amazon.com
          nullable: true
        incorporationDate:
          type: string
          format: date
          description: Year the entity was incorporated in YYYY-MM-DD format.
          example: '1996-05-28'
          nullable: true
        countryOfRisk:
          type: string
          description: 'Entity''s Country of Risk. FactSet has a determined methodology for assigning a country of risk to public and private entities, based on the following -

            * Country of Headquarters

            * Country of Incorporation

            * Country of Primary Exchange (the country where most liquid equity listings trade)

            '
          example: US
          nullable: true
        incorporationCountry:
          type: string
          description: ISO Country code where the entity is incorporated
          example: US
          nullable: true
        businessDescription:
          type: string
          description: Extended business description for the requested entity.
          example: 'Amazon.com, Inc. engages in the provision of Online retail shopping services. It operates through the following business segments: North America, International, and Amazon Web Services (AWS). The North America segment includes retail sales of consumer products and subscriptions through North America-focused websites such as www.amazon.com and www.amazon.ca. The International segment offers retail sales of consumer products and subscriptions through internationally-focused websites. The Amazon Web Services segment involves in the global sales of compute, storage, database, and AWS service offerings for start-ups, enterprises, government agencies, and academic institutions. The company was founded by Jeffrey P. Bezos in July 1994 and is headquartered in Seattle, WA.'
          nullable: true
        phone:
          type: string
          description: The entity's international phone number.
          example: +1.206.266.1000
          nullable: true
        headquartersStreet:
          type: string
          description: The ent

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