---
title: "Retrieve the HuBMAP ID and UUID for each entity id provided in a list."
method: POST
path: "/entities/batch-ids"
---

# Retrieve the HuBMAP ID and UUID for each entity id provided in a list.

`POST /entities/batch-ids`

## Request

- Base URL: `https://entity.api.hubmapconsortium.org`
- URL: `https://entity.api.hubmapconsortium.org/entities/batch-ids`
- Auth: one of:
  - API key in header `Authorization`
  - none

## Request body

- string[]: List of entity identifiers (HuBMAP IDs or UUIDs)

## Response `200`

Mapping of input entity identifiers to their resolved HuBMAP ID and UUID. If no items are found, will simply return empty.

- object

## Other responses

- `500`: Internal Error

## Changes

> 64 revisions in range; 12 not diffed.

- **2026-02-06** `53bdf4608a5f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api/changes/entities/batch-ids/post.md)

---

[API](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api.md) - [All operations](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hubmapconsortium/apis/hubmap-entity-api/revisions/6c71167ae1e0?raw)