---
title: "Gets all aliases of a device"
method: GET
path: "/aliases/v2/{trackingId}"
tags: ["Aliases"]
---

# Gets all aliases of a device

`GET /aliases/v2/{trackingId}`

Gets all aliases of a device identified by the `trackingId`.

If the request is supplied with a `type` query parameter, the response will contain
only aliases of the given type.

## Query parameters

- `pageToken` string
- `count` integer
- `type` string

## Response `200`

Successful

The aliases were 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 — A map of key-value pairs where the key is the type of the alias and the value is an array of `externalId`s.

## 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)