---
title: "BasicTracking"
method: GET
path: "/shipments/tracking/history"
tags: ["Shipments"]
---

# BasicTracking

`GET /shipments/tracking/history`

This API method enables you to retrieve the status of a shipment by providing the transportation document number. By specifying the document number in the request, you can obtain information about the current location or status of the shipment, providing clients with real-time updates on the progress of their cargo.</br>
🔸This method works **only with the transportation document number (shipment number)** and does **not support searching by client order numbers or any external identifiers**.</br>
🔸**BasicTracking** provides a simplified tracking response focused on the shipment’s status history and, optionally, its related shipment numbers. Unlike **FullTracking**, it does not return detailed routing information, parcel-level data, undelivery reasons, return/redirect records, or extended metadata. This method is intended for quick, lightweight status checks.

## Query parameters

- `numbers[]` string
- `extended` string

## Response `200`

Tracking response schema

- object
  - `items` object[] — Array of items in the invoice.
    - `id` string — Transportation document id.
    - `number` string — Transportation document number.
    - `history_tracking` object[] — Array of tracking history statuses for the specified shipment.
      - `code` string — Tracking status code number. **A list of available statuses with their codes and descriptions of their meaning:** - `1` — Ready to send - `2` — Deleted - `4` — Accepted for sending - `5` — Sent from the Sender's Division - `6` — Arrived in the city of the Recipient - `7` — Arrived (at the Division) - `8` — Arrived (at the Postomat) - `9` — Closed - `10` — The shipment is closed and the money transfer is sent to the Sender - `11` — The shipment is closed and the sender has received the money transfer - `13` — Arrival at the transit sorting center - `16` — Departure from the transit sorting center - `17` — ArrivalTransitWarehouse (currently not used) - `19` — DepartureFromTransitWarehouse (currently not used) - `30` — Arrived at customs terminal - `31` — Departed from customs terminal - `99` — Delivery to Postomat is impossible (technical issues or oversized parcel) - `101` — Uploaded to the courier for delivery to the address - `102` — Returns (sender ordered a return) - `103` — Refusal of shipment - `104` — Redirecting - `105` — Utilization - `106` — Received and created return shipment of Documents/Document Subtypes - `110` — Shipment transferred to temporary storage - `111` — Failed delivery attempt (in case of targeted delivery) - `112` — Delivery date postponed (for targeted delivery) - `113` — Storage period expired (Postomat) - `114` — Awaiting customs clearance - `115` — Arrived at customs terminal - `116` — Broker refusal — under resolution - `117` — Cargo not found or lost (customs) - `118` — Forbidden content — delivery impossible (customs) - `119` — Customs clearance in progress - `120` — Customs clearance completed - `121` — Sent to destination city after customs - `122` — Preparing for transfer to customs - `123` — Awaiting information from the recipient - `125` — Preparing for transfer to customs - `126` — Preparing for transfer to customs - `127` — Customs declaration data verification in progress - `128` — Processing accompanying documents prior to customs - `130` — Import prohibited by customs - `131` — Return of uncleared cargo - `132` — Preparing for return - `133` — Client communication regarding a customs comment - `134` — The international shipment has been handed over to the customs broker for processing - `135` — The international shipment has been placed in Storage Area - `138` — Shipment delay due to incorrect recipient information - `141` — Storage period expired - `144` — Storage period expired - `149` — In storage - `155` — Shipment transferred for disposal - `197` — Processing customs documents - `198` — Cargo inspection by customs - `199` — Shipment requires customs clearance - `999` — Undetermined
      - `code_name` string — Tracking status name. If the `extended`=`1` parameter is passed in the request, this field in the response will contain the detailed tracking status name. 🔸**This field is provided for informational purposes only and its value may change over time. It is recommended to rely on the** `history_tracking.code` **field when processing tracking statuses.**
      - `country_code` string — Country code for the place where tracking status was created.
      - `settlement` string — City name for the place where tracking status was created.
      - `date` string — Datetime when tracking status was created.
    - `related_numbers` string[] — An array of objects containing a list of related shipments. 🔸**The shipment numbers listed here are subject to change.**

## Other responses

- `401` — Unauthorized
- `404` — The specified resource was not found
- `422` — Validation error
- `503` — Connection time-out

---

[API](https://skmtc.net/novapost/apis/api-nova-post.md) · [All operations](https://skmtc.net/novapost/apis/api-nova-post/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novapost/api-nova-post/revisions/60e380005037/schema)