---
title: "Gets all aliases"
method: GET
path: "/aliases/v2"
tags: ["Aliases"]
---

# Gets all aliases

`GET /aliases/v2`

Gets all aliases of a project.

If `type` query parameter is provided, the response will contain
only aliases of the given type.

If `externalId` query parameter is specified, the
response will contain only aliases that match the given
external ID. The following wildcards can be used:
'*' matches any number of any characters,
'?' matches a single character.

If `after` query parameter is provided, the successful response will only
contain aliases that were created after the specified timestamp.
Parameters `after` and `pageToken` are mutually exclusive and cannot be provided at the same time.

The returned results are sorted in ascending order by the alias creation time.

## Query parameters

- `pageToken` string
- `count` integer
- `after` number
- `projectId` string — Project ID. Any HERE Tracking user must be a member of a Tracking project. The project ID can be implicitly resolved if the user calling the API is a member of a single project. If the user is a member of multiple projects, the `projectId` query parameter needs to be specified explicitly.

## 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[]
    - `aliases` object, required — A map of key-value pairs where the key is the type of the alias and the value is an array of externalIds.
    - `trackingId` string, required

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

---

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