---
title: "Get Tracking Information"
method: GET
path: "/v1/tracking"
tags: ["tracking"]
---

# Get Tracking Information

`GET /v1/tracking`

Retrieve package tracking information

## Query parameters

- `carrier_code` string
- `tracking_number` string

## Response `200`

The request was a success.

- GetTrackingLogResponseBody — A tracking information resource
  - `tracking_number` string — A tracking number for a package. The format depends on the carrier.
  - `tracking_url` string — Carrier Tracking Url, if available
  - `status_code` 'UN' | 'AC' | 'IT' | 'DE' | 'EX' | 'AT' | 'NY' — The tracking status codes |Value |Description |:--------- |:----------------------------------------------------- |`UN` | Unknown |`AC` | Accepted |`IT` | In Transit |`DE` | Delivered |`EX` | Exception |`AT` | Delivery Attempt |`NY` | Not Yet In System
  - `carrier_code` string — A [shipping carrier](https://www.shipengine.com/docs/carriers/setup/), such as `fedex`, `dhl_express`, `stamps_com`, etc.
  - `carrier_id` integer — The unique ID of the [carrier account](https://www.shipengine.com/docs/carriers/setup/) that was used to create this label
  - `status_description` string — Status description
  - `carrier_status_code` string — Carrier status code
  - `carrier_detail_code` string — Carrier detail code
  - `carrier_status_description` string — carrier status description
  - `ship_date` string, date-time — An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string that represents a date and time.
  - `estimated_delivery_date` string, date-time — An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string that represents a date and time.
  - `actual_delivery_date` string, date-time — An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string that represents a date and time.
  - `exception_description` string — Exception description
  - `events` TrackEvent[] — The events that have occured during the lifetime of this tracking number.
    - `occurred_at` string, date-time, required — An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string that represents a date and time.
    - `carrier_occurred_at` string, date-time — An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string that represents a date and time.
    - `description` string — Event description
    - `city_locality` string, required — City locality
    - `state_province` string, required — State province
    - `postal_code` string, required — Postal code
    - `country_code` string — A two-letter [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1)
    - `company_name` string — Company Name
    - `signer` string — Signer information
    - `event_code` string — Event Code
    - `carrier_detail_code` string, required — Carrier detail code
    - `status_code` 'UN' | 'AC' | 'IT' | 'DE' | 'EX' | 'AT' | 'NY', required — The tracking status codes |Value |Description |:--------- |:----------------------------------------------------- |`UN` | Unknown |`AC` | Accepted |`IT` | In Transit |`DE` | Delivered |`EX` | Exception |`AT` | Delivery Attempt |`NY` | Not Yet In System
    - `status_description` string, required — Event Status Description
    - `carrier_status_code` string, required — Carrier status code
    - `carrier_status_description` string, required — carrier status description
    - `latitude` number, double — Latitude coordinate of tracking event.
    - `longitude` number, double — Longitude coordinate of tracking event.

## Other responses

- `400` — The request contained errors.
- `404` — The specified resource does not exist.
- `500` — An error occurred on ShipEngine's side. > This error will automatically be reported to our engineers.

## Changes

- **2024-07-28** `99050ced80fa` — 15 warning, 23 info
  - deleted the `query` request parameter `carrier_id`
  - removed the optional property `allOf[subschema #1: tracking_information]/events/items/proof_of_delivery_url` from the response with the `200` status
  - removed the optional property `allOf[subschema #1: tracking_information]/events/items/status_detail_code` from the response with the `200` status
  - removed the optional property `allOf[subschema #1: tracking_information]/events/items/status_detail_description` from the response with the `200` status
  - …34 more

[Change history](https://skmtc.dev/shipengine/apis/shipengine-api/changes/v1/tracking/get.md)

---

[API](https://skmtc.dev/shipengine/apis/shipengine-api.md) · [All operations](https://skmtc.dev/shipengine/apis/shipengine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shipengine/shipengine-api/revisions/99050ced80fa/schema)