---
title: "Retrieves multiple documents by their IDs in a single request."
method: POST
path: "/{index_name}/mget"
---

# Retrieves multiple documents by their IDs in a single request.

`POST /{index_name}/mget`

To retrieve multiple documents by their IDs, the POST method must provide 1) a request body containing an array of document IDs in the _mget format, 2) a bearer token in the Authorization header supplied by HuBMAP. Results are limited to those authorized by the bearer token. Uses the <strong>entities</strong> index by default

## Path parameters

- `index_name` string, required

## Request body

- object

## Response `200`

Returns search hits from backend Elasticsearch that match the query defined in the request JSON

- object

## Other responses

- `303` — If the total response payload exceeds 10 MB, the response is returned via an S3 bucket. A 303 HTTP response code will be returned with the redirect URL where the query can be retrieved.
- `401` — A valid globus token in the `Authorization` header (Bearer scheme) is required in request
- `403` — The globus token used in the `Authorization` header doesn't have the right group access permission
- `404` — Bad request or no data found. A JSON body and appropriate Content-Type header are required in request, additionally if no data has been found based on the query when the produce-clt-manifest=true option is used.
- `504` — There is a maximum query and response time of 30 seconds. If the query response takes 30 seconds or longer, a 504 HTTP response code will be returned.

## Changes

- **2025-04-02** `c727e6e09a1c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hubmapconsortium/apis/hubmap-search-api/changes/:index_name/mget/post.md)

---

[API](https://skmtc.dev/hubmapconsortium/apis/hubmap-search-api.md) · [All operations](https://skmtc.dev/hubmapconsortium/apis/hubmap-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hubmapconsortium/hubmap-search-api/revisions/7557b0de2f46/schema)