---
title: "Get an existing tracker"
method: GET
path: "/public/v1/trackers/{trackerId}"
tags: ["📦 Trackers"]
---

# Get an existing tracker

`GET /public/v1/trackers/{trackerId}`

This endpoint return an existing `Tracker` for a given identifier.

## Path parameters

- `trackerId` string, required

## Query parameters

- `searchBy` 'trackerId' | 'clientTrackerId'

## Response `200`

OK

- Tracker
  - `trackerId` string, required — The id of the tracker that is providing this tracking.
  - `trackingNumber` string, required — The tracking number which the tracker is following.
  - `shipmentReference` string, nullable, required — Your reference for this shipment, provided at the tracker's creation. Unlike clientTrackerId, this value is not validated for uniqueness.
  - `courierCode` union — Code of the courier(s) handling the shipment.
    - string[]
    - string
  - `clientTrackerId` string, nullable, required — Your unique identifier for this shipment, provided at the tracker's creation. Ship24 validates its uniqueness across all your active trackers.
  - `isSubscribed` boolean, required — Indicates whether the tracker is active. A value of `false` means the tracker is archived and will not be used for tracking.
  - `isTracked` boolean, required — Indicates whether we are actively tracking the parcel. A value of `true` means new data is being searched for, while `false` indicates tracking has stopped due to delivery, inactivity, or unsubscription. Existing tracking results will remain accessible; however, new data will not be fetched, and notifications will no longer be sent.
  - `createdAt` string, date-time, required — The date and time at which the tracker was created.

## Other responses

- `401` — Unauthorized - No valid API key provided.
- `403` — Forbidden - The API key provided does not have permissions to perform the request.
- `404` — Not Found - The requested resource does not exist.
- `429` — Rate limit exceeded. The client has sent too many requests in a given amount of time.

---

[API](https://skmtc.net/botbrains-io/apis/ship24-tracking-api.md) · [All operations](https://skmtc.net/botbrains-io/apis/ship24-tracking-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/botbrains-io/ship24-tracking-api/revisions/9d68f8b1d086/schema)