---
title: "Get Entities by ID"
method: POST
path: "/v1/knowledge-graph/entities/id"
tags: ["Entities"]
---

# Get Entities by ID

`POST /v1/knowledge-graph/entities/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.

## Request body

- GetEntitiesByIdRequest — Request body for retrieving entities by RavenPack ID
  - `values` string[], required — Array of IDs (up to 100)

## Response `200`

Successful response with entity data

- GetEntitiesByIdResponse — Response containing entity data mapped by RavenPack ID
  - `results` object, required — Object containing RavenPack IDs as keys and entity data as values
  - `metadata` object, required
    - `request_id` string, required — Unique request identifier
    - `timestamp` string, date-time, required — Timestamp of the response
  - `usage` Usage
    - `knowledge_graph_tokens` integer, required — Number of tokens consumed by this request.

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)