> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Entities by ID

> Retrieve entities by their RavenPack ID, a unique identifier used across the Bigdata.com ecosystem. Users can retrieve up to 100 entities per request.



## OpenAPI

````yaml /api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/entities/id
openapi: 3.0.3
info:
  title: Bigdata Knowledge Graph API
  version: 1.0.0
  description: >-
    Access structured data from the Knowledge Graph to find companies, people,
    places, and other entities with detailed information.
servers:
  - url: https://api.bigdata.com/
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /v1/knowledge-graph/entities/id:
    post:
      tags:
        - Entities
      summary: Get Entities by ID
      description: >-
        Retrieve entities by their RavenPack ID, a unique identifier used across
        the Bigdata.com ecosystem. Users can retrieve up to 100 entities per
        request.
      operationId: getEntitiesById
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetEntitiesByIdRequest'
      responses:
        '200':
          description: Successful response with entity data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEntitiesByIdResponse'
components:
  schemas:
    GetEntitiesByIdRequest:
      type: object
      properties:
        values:
          type: array
          items:
            type: string
          description: Array of IDs (up to 100)
          example:
            - D8442A
            - 3D4567
            - 6BD43B
            - 7373D4
            - FE1757
          maxItems: 100
      required:
        - values
      description: Request body for retrieving entities by RavenPack ID
    GetEntitiesByIdResponse:
      type: object
      properties:
        results:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/Entity'
          description: Object containing RavenPack IDs as keys and entity data as values
          example:
            D8442A:
              id: D8442A
              name: Apple Inc.
              description: >-
                Apple Inc. (formerly Apple Computer Inc.), incorporated on
                January 03, 1977, designs, manufactures, and markets mobile
                communication and media devices, personal computing products,
                and portable digital music players worldwide.
              type: PUBLIC
              country: US
              sector: Technology
              industry_group: Computer Hardware
              industry: Computer Hardware
              favicon: http://www.apple.com/favicon.ico
              webpage: http://www.apple.com
              isin_values:
                - CA03785Y1007
                - TH0150120408
                - TH0241121001
                - TH0809121500
                - US0378331005
              cusip_values:
                - '037833100'
                - 03785Y100
                - P0R684385
                - Y100G4352
                - Y49876132
                - Y689DP202
              sedol_values:
                - '2046251'
                - BNC31R1
                - BPXWT99
                - BRC1SP0
                - BVBDDG1
              listing_values:
                - XBKK:AAPL80
                - XNAS:AAPL
              category: companies
            7373D4:
              id: 7373D4
              name: iPhone
              description: >-
                iPhone is a line of smartphones designed and marketed by Apple
                Inc. It runs Apple's iOS mobile operating system.The first
                generation iPhone, aka Iphone 2G was revealed on January 9,
                2007.
              category: products
            3D4567:
              id: 3D4567
              name: United States of America
              description: >-
                The United States of America is a country located in North
                America.
              type: Country
              continent: North America
              country: US
              category: places
            6BD43B:
              id: 6BD43B
              name: Tim Cook
              description: >-
                Timothy Donald Cook (born on the 1st of October 1960) is an
                American business executive who has been serving as the CEO of
                Apple Inc. since August 2011, succeeding Steve Jobs. He is known
                for his leadership in expanding Apple's product line and
                services.
              position: Chief Executive Officer
              employer: Apple Inc.
              nationality: American
              gender: Male
              category: people
            FE1757:
              id: FE1757
              name: U.S. Dollar
              description: >-
                The U.S. Dollar is the official currency of the United States of
                America. It is also the currency of Bonaire, Saint Eustatius and
                Saba, Marshall Islands, Palau, Puerto Rico, Panama, British
                Virgin Islands, East Timor, Guam, Northern Mariana Islands, U.S.
                Virgin Islands, Micronesia, British Indian Ocean Territory,
                Zimbabwe, Ecuador, Turks and Caicos Islands, United States Minor
                Outlying Islands, American Samoa, El Salvador. It was introduced
                in 1792.
              type_name: Currency
              category: concepts
        metadata:
          type: object
          properties:
            request_id:
              type: string
              description: Unique request identifier
              example: f9211cf6-3cd0-4cc7-9759-d33ed3f68a3f
            timestamp:
              type: string
              format: date-time
              description: Timestamp of the response
              example: '2025-10-30T15:46:12.390150+00:00'
          required:
            - request_id
            - timestamp
      required:
        - results
        - metadata
      description: Response containing entity data mapped by RavenPack ID
    Entity:
      type: object
      properties:
        id:
          type: string
          description: RavenPack ID
          example: D8442A
        name:
          type: string
          description: Entity name
          example: Apple Inc.
        description:
          type: string
          description: Entity description
          example: >-
            Apple Inc. (formerly Apple Computer Inc.), incorporated on January
            03, 1977, designs, manufactures, and markets mobile communication
            and media devices, personal computing products, and portable digital
            music players worldwide.
        type:
          type: string
          description: Entity type
          example: PUBLIC
        country:
          type: string
          description: Country code
          example: US
        sector:
          type: string
          description: Business sector
          example: Technology
        industry_group:
          type: string
          description: Industry group
          example: Computer Hardware
        industry:
          type: string
          description: Industry
          example: Computer Hardware
        favicon:
          type: string
          description: Favicon URL
          example: http://www.apple.com/favicon.ico
        webpage:
          type: string
          description: Website URL
          example: http://www.apple.com
        isin_values:
          type: array
          items:
            type: string
          description: ISIN values
          example:
            - CA03785Y1007
            - US0378331005
        cusip_values:
          type: array
          items:
            type: string
          description: CUSIP values
          example:
            - '037833100'
            - 03785Y100
        sedol_values:
          type: array
          items:
            type: string
          description: SEDOL values
          example:
            - '2046251'
            - BNC31R1
        listing_values:
          type: array
          items:
            type: string
          description: Exchange listing identifiers
          example:
            - XBKK:AAPL80
            - XNAS:AAPL
        category:
          type: string
          description: Entity category
          example: companies
        position:
          type: string
          description: Position (for people)
          example: Chief Executive Officer
        employer:
          type: string
          description: Employer (for people)
          example: Apple Inc.
        nationality:
          type: string
          description: Nationality (for people)
          example: American
        gender:
          type: string
          description: Gender (for people)
          example: Male
        continent:
          type: string
          description: Continent (for places)
          example: North America
        type_name:
          type: string
          description: Type name (for concepts)
          example: Currency
      required:
        - id
        - name
        - category
      description: Entity with detailed information
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````