---
title: "Gets a batch of metadata of multiple devices or shipments"
method: POST
path: "/metadata/v2/devices/batch"
tags: ["Metadata"]
---

# Gets a batch of metadata of multiple devices or shipments

`POST /metadata/v2/devices/batch`

Gets a batch of metadata of multiple devices or shipments. The device or shipment IDs are specified in the request body.

## Request body

- string[]

## Response `200`

Successful

The metadata was successfully retrieved.

- object
  - `count` integer — The number of items in the response.
  - `pageToken` string — A token that can be used to retrieve the next page of the response.
  - `data` object[], required
    - `data` object, required — Metadata JSON object
    - `id` string, required — This is a unique ID associated with the device data in HERE Tracking. For physical devices the `trackingId` gets assigned to a device when the device is claimed by a user, and for virtual devices it is an external device ID along with the device project `appId`. Alternatively, a valid `shipmentId` may be used.

## Other responses

- `400` — Bad request The request object is in an incorrect format or has values that are invalid or out of range. If available, further error details are provided in the response body.
- `401` — Unauthorized The request did not provide correct authentication details
- `403` — Forbidden The account does not have the correct privileges
- `404` — Not Found The specified resource was not found

---

[API](https://skmtc.net/here/apis/tracking.md) · [All operations](https://skmtc.net/here/apis/tracking/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/here/tracking/revisions/efa162f7023c/schema)