# Tracking shipment

## BasicTracking

> 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.\
> \
> 🔸This method works \*\*only with the transportation document number (shipment number)\*\* and does \*\*not support searching by client order numbers or any external identifiers\*\*.\
> \
> 🔸\*\*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.\
> \
> 🔹\*\*Description of control elements:\*\*\
> \
> \*\*SCHEMA\*\*\</br>\
> Displays the full technical structure of the request or response, including field names, data types, required fields, allowed values, and validation rules.\
> \- \*\*Single line description\*\*\</br>\
> &#x20; A description that fits into a single line; any text that does not fit remains hidden.\
> \- \*\*Multiline description\*\*\</br>\
> &#x20; An expanded description that displays more than one line of text.\
> \
> \*\*EXAMPLE\*\*\</br>\
> Shows a ready-made sample JSON with correctly formatted values to demonstrate how a valid request or response should look.<br>

```json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[{"name":"Shipments"}],"servers":[{"description":"sandbox","url":"https://api-stage.novapost.pl/v.1.0/"},{"description":"production","url":"https://api.novapost.com/v.1.0/"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"Authorization","description":"Authorization JWT-token with a lifetime of 1 hour in header"}},"responses":{"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Validation":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Time-out":{"description":"Connection time-out","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"errors":{"type":"object","properties":{"":{"type":"string"}}}}}}},"paths":{"/shipments/tracking/history":{"get":{"tags":["Shipments"],"description":"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.\n\n🔸This method works **only with the transportation document number (shipment number)** and does **not support searching by client order numbers or any external identifiers**.\n\n🔸**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.\n\n🔹**Description of control elements:**\n\n**SCHEMA**</br>\nDisplays the full technical structure of the request or response, including field names, data types, required fields, allowed values, and validation rules.\n- **Single line description**</br>\n  A description that fits into a single line; any text that does not fit remains hidden.\n- **Multiline description**</br>\n  An expanded description that displays more than one line of text.\n\n**EXAMPLE**</br>\nShows a ready-made sample JSON with correctly formatted values to demonstrate how a valid request or response should look.\n","parameters":[{"in":"query","name":"numbers[]","description":"Shipment`s numbers. Can accept either a single number or an array of numbers.","schema":{"type":"string"}},{"in":"query","name":"extended","description":"Parameter responsible for including in the response an array of objects listing all related shipments.\nTo receive this data in the response, set the value to `1`.\n","schema":{"type":"string","default":0},"required":false}],"responses":{"200":{"description":"Tracking response schema","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","description":"Array of items in the invoice.","items":{"type":"object","properties":{"id":{"type":"string","description":"Transportation document id."},"number":{"type":"string","description":"Transportation document number."},"history_tracking":{"type":"array","description":"Array of tracking history statuses for the specified shipment.","items":{"type":"object","properties":{"code":{"type":"string","description":"Tracking status code number.\n**A list of available statuses with their codes and descriptions of their meaning:**\n- `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 - `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":{"type":"string","description":"Tracking status name.\n\nIf the `extended`=`1` parameter is passed in the request, this field in the response will contain the detailed tracking status name.\n"},"country_code":{"type":"string","description":"Country code for the place where tracking status was created."},"settlement":{"type":"string","description":"City name for the place where tracking status was created."},"date":{"type":"string","description":"Datetime when tracking status was created."}}}},"related_numbers":{"type":"array","description":"An array of objects containing a list of related shipments.\n\n🔸**The shipment numbers listed here are subject to change.**\n","items":{"type":"string"}}}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Validation"},"503":{"$ref":"#/components/responses/Time-out"}},"summary":"BasicTracking"}}}}
```

## FullTracking

> 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.\
> \
> By default, the response contains the following data blocks:\
> \- Current status of the shipment;\
> \- Tracking history;\
> \- Actual tracking history;\
> \- Description of the shipment;\
> \- Extended information about related shipments.\
> \
> If necessary, additional blocks can be included in the response by passing the appropriate parameters:\
> \
> \- withUndeliveryReason = true - adds an array of objects with information about the reasons for non-delivery of shipments.\
> \- withCreatedOnTheBasis = true - adds an array of objects with information about returns or forwarding associated with the shipment.\
> \
> 🔸\*\*FullTracking\*\* provides a comprehensive tracking response containing detailed shipment status data, full movement history, parcel descriptions, undelivery reasons, and information about related or derivative shipments. Unlike \*\*BasicTracking\*\*, it offers extended operational details and is designed for cases requiring full visibility into the shipment’s logistics lifecycle.\
> \
> 🔹\*\*Description of control elements:\*\*\
> \
> \*\*SCHEMA\*\*\</br>\
> Displays the full technical structure of the request or response, including field names, data types, required fields, allowed values, and validation rules.\
> \- \*\*Single line description\*\*\</br>\
> &#x20; A description that fits into a single line; any text that does not fit remains hidden.\
> \- \*\*Multiline description\*\*\</br>\
> &#x20; An expanded description that displays more than one line of text.\
> \
> \*\*EXAMPLE\*\*\</br>\
> Shows a ready-made sample JSON with correctly formatted values to demonstrate how a valid request or response should look.<br>

```json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[{"name":"Shipments"}],"servers":[{"description":"sandbox","url":"https://api-stage.novapost.pl/v.1.0/"},{"description":"production","url":"https://api.novapost.com/v.1.0/"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"Authorization","description":"Authorization JWT-token with a lifetime of 1 hour in header"}},"responses":{"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"The specified resource was not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Validation":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Time-out":{"description":"Connection time-out","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"errors":{"type":"object","properties":{"":{"type":"string"}}}}}}},"paths":{"/shipments/tracking":{"get":{"tags":["Shipments"],"description":"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.\n\nBy default, the response contains the following data blocks:\n- Current status of the shipment;\n- Tracking history;\n- Actual tracking history;\n- Description of the shipment;\n- Extended information about related shipments.\n\nIf necessary, additional blocks can be included in the response by passing the appropriate parameters:\n\n- withUndeliveryReason = true - adds an array of objects with information about the reasons for non-delivery of shipments.\n- withCreatedOnTheBasis = true - adds an array of objects with information about returns or forwarding associated with the shipment.\n\n🔸**FullTracking** provides a comprehensive tracking response containing detailed shipment status data, full movement history, parcel descriptions, undelivery reasons, and information about related or derivative shipments. Unlike **BasicTracking**, it offers extended operational details and is designed for cases requiring full visibility into the shipment’s logistics lifecycle.\n\n🔹**Description of control elements:**\n\n**SCHEMA**</br>\nDisplays the full technical structure of the request or response, including field names, data types, required fields, allowed values, and validation rules.\n- **Single line description**</br>\n  A description that fits into a single line; any text that does not fit remains hidden.\n- **Multiline description**</br>\n  An expanded description that displays more than one line of text.\n\n**EXAMPLE**</br>\nShows a ready-made sample JSON with correctly formatted values to demonstrate how a valid request or response should look.\n","parameters":[{"in":"query","name":"numbers[]","description":"Shipment numbers. Can accept either a single number or an array of numbers.","schema":{"type":"string"}},{"in":"query","name":"ids[]","description":"Search shipments by transportation document ids. Accepts either a single search id or an array of ids to conduct the search.","schema":{"type":"integer","format":"int32"}},{"in":"query","name":"withUndeliveryReason","description":"A parameter that controls the inclusion of an array of objects containing information about non-delivery reasons in the response.\nTo receive this data in the response, set the value to `true`\n","schema":{"type":"boolean","default":false},"required":false},{"in":"query","name":"withCreatedOnTheBasis","description":"Parameter responsible for including in the response an array of objects containing information about related shipments (types: `Redirecting`, `Return`, `Utilization`, `Redelivery`). \nTo receive this data in the response, set the value to `true`.\n","schema":{"type":"boolean","default":false},"required":false},{"in":"query","name":"countryCode","description":"Two-letter sender country code according to the ISO 3166-1 Alpha-2 standard.\nIf this parameter is specified, Tracking history and Actual tracking history will be shown only for the specified country.\nPattern: ^[A-Z]{2}$\n","schema":{"type":"string"}},{"in":"query","name":"external","description":"Parameter responsible for including in the response an array of objects listing all related shipments, as well as an array containing extended information about those shipments — including the shipment owner’s name, shipment number, and shipment creation date.\nTo receive this data in the response, set the value to `1`.\n","schema":{"type":"string","default":0},"required":false},{"in":"query","name":"trackingByBarcode","description":"The system filters aggregated data and returns information only for the specified parcel. This allows tracking the delivery route of a specific parcel within a multi-parcel shipment.","schema":{"type":"string"},"required":false},{"in":"query","name":"withAllParcels","description":"The system aggregates events from all parcel into a single array, grouped by parcel number. This allows tracking the delivery route of each parcel within a multi-parcel shipment.`.\n","schema":{"type":"boolean","default":false},"required":false}],"responses":{"200":{"description":"Tracking response schema","content":{"application/json":{"schema":{"type":"object","properties":{"currentStatus":{"type":"array","description":"An array of objects containing detailed information about the current shipment status.","items":{"type":"object","properties":{"number":{"type":"string","description":"Shipment number."},"createdDate":{"type":"string","format":"date-time","description":"Shipment creation date. \n\nDate in ISO 8601 format with UTC time zone\n"},"scheduledDate":{"type":"string","format":"date-time","description":"Estimated delivery date. \n\nDate in ISO 8601 format with UTC time zone\n"},"scheduledDateOriginal":{"type":"string","format":"date-time","nullable":true,"description":"Initial estimated delivery date.\n\nDate in ISO 8601 format with UTC time zone\n"},"adjustedDate":{"type":"string","format":"date-time","nullable":true,"description":"Adjusted delivery date.\n\nDate in ISO 8601 format with UTC time zone\n"},"closingDate":{"type":"string","format":"date-time","nullable":true,"description":"Shipment closure date (completion of all operations).\n\nDate in ISO 8601 format with UTC time zone\n"},"statusCode":{"type":"string","description":"Tracking status code number.\n\n**A list of available statuses with their codes and descriptions of their meaning:**\n\n- `1` — Ready to send\n- `2` — Deleted\n- `4` — Accepted for sending\n- `5` — Sent from the Sender's Division\n- `6` — Arrived in the city of the Recipient\n- `7` — Arrived (at the Division)\n- `8` — Arrived (at the Postomat)\n- `9` — Closed\n- `10` — The shipment is closed and the money transfer is sent to the Sender\n- `11` — The shipment is closed and the sender has received the money transfer\n- `13` — Arrival at the transit sorting center\n- `16` — Departure from the transit sorting center\n- `17` — ArrivalTransitWarehouse (currently not used)\n- `19` — DepartureFromTransitWarehouse (currently not used)\n- `30` — Arrived at customs terminal\n- `31` — Departed from customs terminal\n- `99` — Delivery to Postomat is impossible (technical issues or oversized parcel)\n- `101` — Uploaded to the courier for delivery to the address\n- `102` — Returns (sender ordered a return)\n- `103` — Refusal of shipment\n- `104` — Redirecting\n- `105` — Utilization\n- `106` — Received and created return shipment of Documents/Document Subtypes\n- `110` — Shipment transferred to temporary storage\n- `111` — Failed delivery attempt (in case of targeted delivery)\n- `112` — Delivery date postponed (for targeted delivery)\n- `113` — Storage period expired (Postomat)\n- `114` — Awaiting customs clearance\n- `115` — Arrived at customs terminal\n- `116` — Broker refusal — under resolution\n- `117` — Cargo not found or lost (customs)\n- `118` — Forbidden content — delivery impossible (customs)\n- `119` — Customs clearance in progress\n- `120` — Customs clearance completed\n- `121` — Sent to destination city after customs\n- `122` — Preparing for transfer to customs\n- `123` — Awaiting information from the recipient\n- `125` — Preparing for transfer to customs\n- `126` — Preparing for transfer to customs\n- `127` — Customs declaration data verification in progress\n- `128` — Processing accompanying documents prior to customs\n- `130` — Import prohibited by customs\n- `131` — Return of uncleared cargo\n- `132` — Preparing for return\n- `141` — Storage period expired\n- `144` — Storage period expired\n- `149` — In storage\n- `155` — Shipment transferred for disposal\n- `197` — Processing customs documents\n- `198` — Cargo inspection by customs\n- `199` — Shipment requires customs clearance\n- `999` — Undetermined\n"},"status":{"type":"string","description":"Status code name."},"statusDate":{"type":"string","format":"date-time","description":"Date and time when this status was set.\n\nDate in ISO 8601 format with UTC time zone\n"},"deliveryType":{"type":"string","description":"Delivery type"},"deliveryCountry":{"type":"string","pattern":"^[A-Z]{2}$","description":"Two-letter destination country code according to the ISO 3166-1 Alpha-2 standard."}}}},"detailsTracking":{"type":"array","description":"An array of objects containing detailed information about the entire shipment movement, including the movement of related shipments, if available.\n\nNot populated when parcel-level tracking is used (i.e., when `trackingByBarcode` is provided or `withAllParcels` = `true`).\n","items":{"type":"object","properties":{"number":{"type":"string","description":"Shipment number."},"date":{"type":"string","format":"date-time","nullable":true,"description":"Date and time when this status was set.\n\nDate in ISO 8601 format with UTC time zone\n"},"event":{"type":"string","description":"Event name.\n\n**Available event names:**\n\n - `CreateID` — Shipment ID created\n - `CreateIDFullfilment` — Shipment ID created (fulfillment)\n - `Deleted` — Deleted\n - `CanceledSender` — Shipment cancelled by sender\n - `DeclarationDeleted` — Declaration cancelled\n - `ArrivalSenderWarehouse` — Arrival at sender’s warehouse\n - `ArrivalSenderPostomat` — Arrival at sender’s parcel locker\n - `ArrivalSenderDoors` — Courier picked up the shipment from sender\n - `DepartureSenderWarehouseFullfilment` — Shipped from sender's warehouse (fulfillment)\n - `DepartureSenderWarehouse` — Shipment dispatched from sender’s warehouse\n - `Departure` — Shipment\n - `Arrival` — Arrival\n - `DepartureSenderWarehouseFuture` — Shipment from sender’s warehouse (future event)\n - `DepartureFuture` — Shipment (future event)\n - `ArrivalFuture` — Arrival (future event)\n - `OnTheWayArrival` — En route to arrival point\n - `OnTheWayArrivalFuture` — En route to arrival point (future event)\n - `OnTheWayDeparture` — Shipment in transit\n - `OnTheWayDepartureFuture` — Shipment in transit (future event)\n - `ArrivalSenderDoorsFuture` — Courier picked up the shipment from sender (future event)\n - `ArrivalSenderCityDeliveryService` — Delivery service in recipient’s city (arrival)\n - `ArrivalTerminal` — Arrival at terminal\n - `ArrivalCustomsBrokerPartner` — Partner customs broker (arrival)\n - `DepartureDeliveryService` — Delivery service (dispatch)\n - `DepartureSenderCityDeliveryService` — Delivery service in sender’s city (dispatch)\n - `DepartureCustomsBrokerPartner` — Partner customs broker (dispatch)\n - `ArrivalDeliveryServiceFuture` — Delivery service (arrival, future event)\n - `ArrivalSenderCityDeliveryServiceFuture` — Delivery service in sender’s city (arrival, future event)\n - `ArrivalTerminalFuture` — Arrival at terminal (future event)\n - `ArrivalCustomsBrokerPartnerFuture` — Partner customs broker (arrival, future event)\n - `DepartureDeliveryServiceFuture` — Delivery service (dispatch, future event)\n - `DepartureSenderCityDeliveryServiceFuture` — Delivery service in sender’s city (dispatch, future event)\n - `DepartureTerminalFuture` — Dispatch from terminal (future event)\n - `DepartureTerminal` — Dispatch from terminal\n - `ArrivalDepot` — Arrival at depot\n - `DepartureDepot` — Dispatch from depot\n - `ArrivalDepotFuture` — Arrival at depot (future event)\n - `DepartureDepotFuture` — Dispatch from depot (future event)\n - `ArrivalSenderCityDepot` — Depot in sender’s city (arrival)\n - `DepartureSenderCityDepot` — Depot in sender’s city (dispatch)\n - `ArrivalSenderCityDepotFuture` — Depot in sender’s city (arrival, future event)\n - `DepartureSenderCityDepotFuture` — Depot in sender’s city (dispatch, future event)\n - `CustomsClearanceInitiated` — Customs clearance\n - `ArrivalSenderCityTerminal` — Terminal in sender’s city (arrival)\n - `ArrivalSenderCityTerminalFuture` — Terminal in sender’s city (arrival, future event)\n - `DepartureSenderCityTerminal` — Terminal in sender’s city (dispatch)\n - `DepartureSenderCityTerminalFuture` — Terminal in sender’s city (dispatch, future event)\n - `SentForCustomsClearance` — Sent for customs clearance\n - `CustomClearanceIsCompleted` — Customs processing completed\n - `SentToDestinationCountry` — Sent to destination city after customs\n - `ArrivalCustomTerminal` — Arrived at customs terminal\n - `ArrivalDeliveryService` — Delivery service (arrival)\n - `MovingPostomat` — Awaiting transportation / In transit to parcel locker\n - `InCityRecipientDeparture` — In recipient's city (dispatch)\n - `InCityRecipientArrival` — In recipient's city (arrival)\n - `InCityRecipientPlan` — In recipient's city (planned event)\n - `InCityRecipientFuture` — In recipient’s city (future event)\n - `InCityRecipient` — In recipient’s city\n - `InCityRecipientArrivalFuture` — In recipient’s city (future arrival event)\n - `InCityRecipientDepartureFuture` — In recipient’s city (future dispatch event)\n - `InCityRecipientPlanFuture` — In recipient’s city (future planned event)\n - `ArrivalDestinationDepot` — Destination city warehouse (arrival)\n - `DepartureDestinationDepot` — Destination city warehouse (dispatch)\n - `ArrivalDestinationDepotFuture` — Destination city warehouse (arrival, future event)\n - `DepartureDestinationDepotFuture` — Destination city warehouse (dispatch, future event)\n - `ArrivalDestinationDeliveryService` — Delivery service in recipient’s city (arrival)\n - `DepartureDestinationDeliveryService` — Delivery service in recipient’s city (dispatch)\n - `ArrivalDestinationDeliveryServiceFuture` — Delivery service in recipient’s city (arrival, future event)\n - `DepartureDestinationDeliveryServiceFuture` — Delivery service in recipient’s city (dispatch, future event)\n - `ArrivalDestinationTerminal` — Terminal in recipient’s city (arrival)\n - `ArrivalDestinationTerminalFuture` — Terminal in recipient’s city (arrival, future event)\n - `DepartureDestinationTerminal` — Terminal in recipient’s city (dispatch)\n - `DepartureDestinationTerminalFuture` — Terminal in recipient’s city (dispatch, future event)\n - `ArrivalSameSettlementImport` — Single locality (import, arrival)\n - `NoFreeSlotsInPostomat` — No free parcel locker cells available\n - `LoadingCourierForMoving` — Courier picked up the shipment\n - `ArrivalSameSettlementImportFuture` — Single locality (import, arrival, future event)\n - `ParcelWasTransferredToPartner` — Transferred to partner for further delivery\n - `ArrivalSameSettlementLocal` — Single locality (local, arrival)\n - `ArrivalSameSettlementLocalFuture` — Single locality (local, arrival, future event)\n - `ArrivalDuplicate` — Shipment pending processing at partner warehouse\n - `ArrivalDuplicatePassed` — Shipment was pending processing at partner warehouse\n - `DepartureDuplicate` — Shipment in the process of dispatching from partner warehouse\n - `DepartureDuplicatePassed` — Shipment was in dispatch process from partner warehouse\n - `InRouteDuplicate` — Shipment in transit — temporary partner-side delay\n - `InRouteDuplicatePassed` — Temporary partner-side delay resolved\n - `TransferPoint` — Transfer point\n - `MovingPoint` — At pickup point\n - `TransferPointPostomat` — Arrival at parcel locker\n - `ArrivalRecipientWarehouse` — Arrival at recipient’s warehouse\n - `ArrivalRecipientWarehouseFuture` — Arrival at recipient’s warehouse (future event)\n - `ArrivalRecipientPartnerWarehouse` — Arrived at partner warehouse\n - `ArrivalRecipientPostomat` — Arrived at recipient’s parcel locker\n - `ReceivedDoorsFuture` — Delivery to address (future event)\n - `ReceivedWarehouse` — Received at warehouse\n - `ReceivedDoors` — Delivered to address\n - `ReceivedPartner` — Shipment received by partner\n - `AlternativeDelivery` — Alternative delivery type applied (delivered to neighbor, left at the door, placed in mailbox, etc.)\n - `MoneyTransferAddress` — Money transfer (to address)\n - `MoneyTransfer` — Money transfer (to branch)\n - `MoneyTransferAddressFuture` — Money transfer (to address, future event)\n - `ArrivalSC` — Arrival at sorting center (SC)\n - `TransferToPartner` — Handed over to partner\n - `ArrivalTransitWarehouse` — Arrived at transit warehouse\n - `DepartureFromTransitWarehouse` — Departed from transit warehouse\n - `ProblemWithPostomat` — Delivery to Postomat impossible\n - `LoadingCourier` — Courier loading\n - `LoadingCourierFuture` — Courier loading (future event)\n - `ReturnTransferPoint` — Return to transfer point\n - `EWCargoAutoReturnRecipient` — Automatic return to sender\n - `OrderCargoReturn` — Return requested\n - `UndeliveryReasonsClient` — Not delivered (recipient refused the shipment)\n - `OrderRedirecting` — Redirection requested\n - `Utilization` — Sent for utilization\n - `DeclarationUtilization` — Shipment disposed\n - `EWRedeliveryAddress` — Redelivery (to address)\n - `EWRedeliveryDivision` — Redelivery (to branch)\n - `EWRedeliveryAddressFuture` — Redelivery (to address, future event)\n - `UndeliveryReasonsNoConnection` — Not delivered (no contact with recipient)\n - `ChangingTheDateWithTimeInterval` — Delivery rescheduled (time slot specified)\n - `ChangingTheDate` — Delivery rescheduled\n - `ShelfLifeHasExpired` — Storage period expired\n - `DeclarationArrivalCustomTerminalOutsideManifest` — Customs control started (outside manifest)\n - `DeclarationArrivalCustomTerminal` — Customs control started\n - `DeclarationInRoute` — Shipment en route to customs control\n - `DeclarationBrokerRejection` — Broker rejection — under review\n - `DeclarationCargoLost` — Shipment lost\n - `DeclarationCargoNotArrive` — Shipment did not arrive on schedule — under additional verification\n - `DeclarationCargoProhibitedForImport` — Prohibited content — delivery impossible\n - `DeclarationCustomsCargoSeizedBySmugglingDepartment` — Shipment seized by customs anti-smuggling department\n - `DeclarationCustomsCargoInspection` — Shipment undergoing customs inspection\n - `DeclarationCargoUnderInspectionCustoms` — Shipment under additional customs inspection\n - `DeclarationCustomsClearanceInitiated` — Customs clearance in progress\n - `DeclarationCustomsHold` — Shipment temporarily on hold by customs\n - `DeclarationCustomClearanceIsCompleted` — Customs clearance completed\n - `DeclarationSentToDestinationCountry` — Cleared customs — en route to destination country\n - `DeclarationAddedToManifest` — Added to the manifest\n - `DeclarationCustomerNoResponse` — Awaiting information from the recipient\n - `DeclarationPackagingDamaged` — Packaging damaged\n - `DeclarationShipmentDamaged` — Shipment damaged\n - `DeclarationInvalidCustomerData` — Verifying declaration data\n - `DeclarationNoSupportingDocuments` — Supporting documents missing\n - `CustomsRefusal` — Import prohibited by customs\n - `DeclarationAwaitingCustomsRelease` — Processing customs documents\n - `DeclarationCustomsDocumentsReceived` — Customs documents received, clearance in progress\n - `DeclarationShipmentAudit` — Cargo inspection by customs\n - `DeclarationRequireCustomsClearance` — Customs clearance required\n - `PickUpCreated` — Pickup order created\n - `PickUpAppointedCourier` — Courier assigned\n - `PickUpInProgress` — Courier en route for pickup\n - `PickUpReceivedByCourier` — Shipment received by courier\n - `PickUpDone` — Shipment picked up by courier\n - `PickUpNotPacked` — Pickup not completed — shipment was not packed\n - `PickUpNotCompleted` — Pickup not completed by courier\n\n - `DepartureCustomsBrokerPartnerFuture` — Partner customs broker (dispatch, future event)\n - `ShelfLifeHasExpiredReturn` — Not collected from Postomat — moved to the nearest division\n - `Lost` — Shipment lost\n"},"eventStatus":{"type":"string","description":"Event execution statuses.\n\n**Possible values:**    \n- `Passed` — the event has already occurred\n- `Now` — the event is currently taking place\n- `Future` — the event is planned for the future\n"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","nullable":true,"description":"A two-letter code representing the sender's country, following the ISO 3166-1 Alpha-2 standard, indicating the country of origin for the shipment."},"code":{"type":"string","description":"Tracking status code number.\n\n**Permissible values match those defined for the `currentStatus. statusCode` field.**\n"},"divisionName":{"type":"string","description":"Warehouse where the corresponding event occurs."},"postCode":{"type":"string","description":"Actual postal code."},"settlementName":{"type":"string","description":"Name of the locality where the event takes place."},"eventName":{"type":"string","description":"Client-specific event name."},"postCode1":{"type":"string","description":"Start of the postal code range for the settlement."},"postCode2":{"type":"string","description":"End of the postal code range for the settlement."}}}},"historyOnlineTracking":{"type":"array","description":"An array of objects containing information about the shipment’s online tracking status history, excluding duplicate events.\n\nNot populated when parcel-level tracking is used (i.e., when `trackingByBarcode` is provided or `withAllParcels` = `true`).\n","items":{"type":"object","properties":{"number":{"type":"string","description":"Shipment number."},"date":{"type":"string","format":"date-time","nullable":true,"description":"Date and time when this status was set.\n\nDate in ISO 8601 format with UTC time zone\n"},"event":{"type":"string","description":"Event name.\n\n**Permissible values match those defined for the `detailsTracking.event` field.**\n"},"eventStatus":{"type":"string","description":"Event execution statuses.\n\n**Possible values:**    \n- `Passed` — the event has already occurred\n- `Now` — the event is currently taking place\n"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","nullable":true,"description":"A two-letter code representing the sender's country, following the ISO 3166-1 Alpha-2 standard, indicating the country of origin for the shipment."},"code":{"type":"string","description":"Tracking status code number.\n\n**Permissible values match those defined for the `currentStatus. statusCode` field.**\n"},"divisionName":{"type":"string","description":"Warehouse where the corresponding event occurs."},"postCode":{"type":"string","description":"Actual postal code."},"settlementName":{"type":"string","description":"Name of the locality where the event takes place."},"eventName":{"type":"string","description":"Client-specific event name."},"postCode1":{"type":"string","description":"Start of the postal code range for the settlement."},"postCode2":{"type":"string","description":"End of the postal code range for the settlement."}}}},"parcelsDetailsTracking":{"type":"object","description":"An array of objects containing detailed information about the entire parcel movement.\n\n\nPopulated when parcel-level tracking is used (i.e., when `trackingByBarcode` is provided or `withAllParcels` = `true`).\n","additionalProperties":{"type":"array","description":"Dynamic object key whose value is the Parcel number. Used to group tracking events by specific Parcel.","items":{"type":"object","properties":{"number":{"type":"string","description":"Shipment number."},"date":{"type":"string","format":"date-time","nullable":true,"description":"Date and time when this status was set.\n\nDate in ISO 8601 format with UTC time zone\n"},"event":{"type":"string","description":"Event name.\n\n**Available event names:**\n\n - `CreateID` — Shipment ID created\n - `CreateIDFullfilment` — Shipment ID created (fulfillment)\n - `Deleted` — Deleted\n - `CanceledSender` — Shipment cancelled by sender\n - `DeclarationDeleted` — Declaration cancelled\n - `ArrivalSenderWarehouse` — Arrival at sender’s warehouse\n - `ArrivalSenderPostomat` — Arrival at sender’s parcel locker\n - `ArrivalSenderDoors` — Courier picked up the shipment from sender\n - `DepartureSenderWarehouseFullfilment` — Shipped from sender's warehouse (fulfillment)\n - `DepartureSenderWarehouse` — Shipment dispatched from sender’s warehouse\n - `Departure` — Shipment\n - `Arrival` — Arrival\n - `DepartureSenderWarehouseFuture` — Shipment from sender’s warehouse (future event)\n - `DepartureFuture` — Shipment (future event)\n - `ArrivalFuture` — Arrival (future event)\n - `OnTheWayArrival` — En route to arrival point\n - `OnTheWayArrivalFuture` — En route to arrival point (future event)\n - `OnTheWayDeparture` — Shipment in transit\n - `OnTheWayDepartureFuture` — Shipment in transit (future event)\n - `ArrivalSenderDoorsFuture` — Courier picked up the shipment from sender (future event)\n - `ArrivalSenderCityDeliveryService` — Delivery service in recipient’s city (arrival)\n - `ArrivalTerminal` — Arrival at terminal\n - `ArrivalCustomsBrokerPartner` — Partner customs broker (arrival)\n - `DepartureDeliveryService` — Delivery service (dispatch)\n - `DepartureSenderCityDeliveryService` — Delivery service in sender’s city (dispatch)\n - `DepartureCustomsBrokerPartner` — Partner customs broker (dispatch)\n - `ArrivalDeliveryServiceFuture` — Delivery service (arrival, future event)\n - `ArrivalSenderCityDeliveryServiceFuture` — Delivery service in sender’s city (arrival, future event)\n - `ArrivalTerminalFuture` — Arrival at terminal (future event)\n - `ArrivalCustomsBrokerPartnerFuture` — Partner customs broker (arrival, future event)\n - `DepartureDeliveryServiceFuture` — Delivery service (dispatch, future event)\n - `DepartureSenderCityDeliveryServiceFuture` — Delivery service in sender’s city (dispatch, future event)\n - `DepartureTerminalFuture` — Dispatch from terminal (future event)\n - `DepartureTerminal` — Dispatch from terminal\n - `ArrivalDepot` — Arrival at depot\n - `DepartureDepot` — Dispatch from depot\n - `ArrivalDepotFuture` — Arrival at depot (future event)\n - `DepartureDepotFuture` — Dispatch from depot (future event)\n - `ArrivalSenderCityDepot` — Depot in sender’s city (arrival)\n - `DepartureSenderCityDepot` — Depot in sender’s city (dispatch)\n - `ArrivalSenderCityDepotFuture` — Depot in sender’s city (arrival, future event)\n - `DepartureSenderCityDepotFuture` — Depot in sender’s city (dispatch, future event)\n - `CustomsClearanceInitiated` — Customs clearance\n - `ArrivalSenderCityTerminal` — Terminal in sender’s city (arrival)\n - `ArrivalSenderCityTerminalFuture` — Terminal in sender’s city (arrival, future event)\n - `DepartureSenderCityTerminal` — Terminal in sender’s city (dispatch)\n - `DepartureSenderCityTerminalFuture` — Terminal in sender’s city (dispatch, future event)\n - `SentForCustomsClearance` — Sent for customs clearance\n - `CustomClearanceIsCompleted` — Customs processing completed\n - `SentToDestinationCountry` — Sent to destination city after customs\n - `ArrivalCustomTerminal` — Arrived at customs terminal\n - `ArrivalDeliveryService` — Delivery service (arrival)\n - `MovingPostomat` — Awaiting transportation / In transit to parcel locker\n - `InCityRecipientDeparture` — In recipient's city (dispatch)\n - `InCityRecipientArrival` — In recipient's city (arrival)\n - `InCityRecipientPlan` — In recipient's city (planned event)\n - `InCityRecipientFuture` — In recipient’s city (future event)\n - `InCityRecipient` — In recipient’s city\n - `InCityRecipientArrivalFuture` — In recipient’s city (future arrival event)\n - `InCityRecipientDepartureFuture` — In recipient’s city (future dispatch event)\n - `InCityRecipientPlanFuture` — In recipient’s city (future planned event)\n - `ArrivalDestinationDepot` — Destination city warehouse (arrival)\n - `DepartureDestinationDepot` — Destination city warehouse (dispatch)\n - `ArrivalDestinationDepotFuture` — Destination city warehouse (arrival, future event)\n - `DepartureDestinationDepotFuture` — Destination city warehouse (dispatch, future event)\n - `ArrivalDestinationDeliveryService` — Delivery service in recipient’s city (arrival)\n - `DepartureDestinationDeliveryService` — Delivery service in recipient’s city (dispatch)\n - `ArrivalDestinationDeliveryServiceFuture` — Delivery service in recipient’s city (arrival, future event)\n - `DepartureDestinationDeliveryServiceFuture` — Delivery service in recipient’s city (dispatch, future event)\n - `ArrivalDestinationTerminal` — Terminal in recipient’s city (arrival)\n - `ArrivalDestinationTerminalFuture` — Terminal in recipient’s city (arrival, future event)\n - `DepartureDestinationTerminal` — Terminal in recipient’s city (dispatch)\n - `DepartureDestinationTerminalFuture` — Terminal in recipient’s city (dispatch, future event)\n - `ArrivalSameSettlementImport` — Single locality (import, arrival)\n - `NoFreeSlotsInPostomat` — No free parcel locker cells available\n - `LoadingCourierForMoving` — Courier picked up the shipment\n - `ArrivalSameSettlementImportFuture` — Single locality (import, arrival, future event)\n - `ParcelWasTransferredToPartner` — Transferred to partner for further delivery\n - `ArrivalSameSettlementLocal` — Single locality (local, arrival)\n - `ArrivalSameSettlementLocalFuture` — Single locality (local, arrival, future event)\n - `ArrivalDuplicate` — Shipment pending processing at partner warehouse\n - `ArrivalDuplicatePassed` — Shipment was pending processing at partner warehouse\n - `DepartureDuplicate` — Shipment in the process of dispatching from partner warehouse\n - `DepartureDuplicatePassed` — Shipment was in dispatch process from partner warehouse\n - `InRouteDuplicate` — Shipment in transit — temporary partner-side delay\n - `InRouteDuplicatePassed` — Temporary partner-side delay resolved\n - `TransferPoint` — Transfer point\n - `MovingPoint` — At pickup point\n - `TransferPointPostomat` — Arrival at parcel locker\n - `ArrivalRecipientWarehouse` — Arrival at recipient’s warehouse\n - `ArrivalRecipientWarehouseFuture` — Arrival at recipient’s warehouse (future event)\n - `ArrivalRecipientPartnerWarehouse` — Arrived at partner warehouse\n - `ArrivalRecipientPostomat` — Arrived at recipient’s parcel locker\n - `ReceivedDoorsFuture` — Delivery to address (future event)\n - `ReceivedWarehouse` — Received at warehouse\n - `ReceivedDoors` — Delivered to address\n - `ReceivedPartner` — Shipment received by partner\n - `AlternativeDelivery` — Alternative delivery type applied (delivered to neighbor, left at the door, placed in mailbox, etc.)\n - `MoneyTransferAddress` — Money transfer (to address)\n - `MoneyTransfer` — Money transfer (to branch)\n - `MoneyTransferAddressFuture` — Money transfer (to address, future event)\n - `ArrivalSC` — Arrival at sorting center (SC)\n - `TransferToPartner` — Handed over to partner\n - `ArrivalTransitWarehouse` — Arrived at transit warehouse\n - `DepartureFromTransitWarehouse` — Departed from transit warehouse\n - `ProblemWithPostomat` — Delivery to Postomat impossible\n - `LoadingCourier` — Courier loading\n - `LoadingCourierFuture` — Courier loading (future event)\n - `ReturnTransferPoint` — Return to transfer point\n - `EWCargoAutoReturnRecipient` — Automatic return to sender\n - `OrderCargoReturn` — Return requested\n - `UndeliveryReasonsClient` — Not delivered (recipient refused the shipment)\n - `OrderRedirecting` — Redirection requested\n - `Utilization` — Sent for utilization\n - `DeclarationUtilization` — Shipment disposed\n - `EWRedeliveryAddress` — Redelivery (to address)\n - `EWRedeliveryDivision` — Redelivery (to branch)\n - `EWRedeliveryAddressFuture` — Redelivery (to address, future event)\n - `UndeliveryReasonsNoConnection` — Not delivered (no contact with recipient)\n - `ChangingTheDateWithTimeInterval` — Delivery rescheduled (time slot specified)\n - `ChangingTheDate` — Delivery rescheduled\n - `ShelfLifeHasExpired` — Storage period expired\n - `DeclarationArrivalCustomTerminalOutsideManifest` — Customs control started (outside manifest)\n - `DeclarationArrivalCustomTerminal` — Customs control started\n - `DeclarationInRoute` — Shipment en route to customs control\n - `DeclarationBrokerRejection` — Broker rejection — under review\n - `DeclarationCargoLost` — Shipment lost\n - `DeclarationCargoNotArrive` — Shipment did not arrive on schedule — under additional verification\n - `DeclarationCargoProhibitedForImport` — Prohibited content — delivery impossible\n - `DeclarationCustomsCargoSeizedBySmugglingDepartment` — Shipment seized by customs anti-smuggling department\n - `DeclarationCustomsCargoInspection` — Shipment undergoing customs inspection\n - `DeclarationCargoUnderInspectionCustoms` — Shipment under additional customs inspection\n - `DeclarationCustomsClearanceInitiated` — Customs clearance in progress\n - `DeclarationCustomsHold` — Shipment temporarily on hold by customs\n - `DeclarationCustomClearanceIsCompleted` — Customs clearance completed\n - `DeclarationSentToDestinationCountry` — Cleared customs — en route to destination country\n - `DeclarationAddedToManifest` — Added to the manifest\n - `DeclarationCustomerNoResponse` — Awaiting information from the recipient\n - `DeclarationPackagingDamaged` — Packaging damaged\n - `DeclarationShipmentDamaged` — Shipment damaged\n - `DeclarationInvalidCustomerData` — Verifying declaration data\n - `DeclarationNoSupportingDocuments` — Supporting documents missing\n - `CustomsRefusal` — Import prohibited by customs\n - `DeclarationAwaitingCustomsRelease` — Processing customs documents\n - `DeclarationCustomsDocumentsReceived` — Customs documents received, clearance in progress\n - `DeclarationShipmentAudit` — Cargo inspection by customs\n - `DeclarationRequireCustomsClearance` — Customs clearance required\n - `PickUpCreated` — Pickup order created\n - `PickUpAppointedCourier` — Courier assigned\n - `PickUpInProgress` — Courier en route for pickup\n - `PickUpReceivedByCourier` — Shipment received by courier\n - `PickUpDone` — Shipment picked up by courier\n - `PickUpNotPacked` — Pickup not completed — shipment was not packed\n - `PickUpNotCompleted` — Pickup not completed by courier\n\n - `DepartureCustomsBrokerPartnerFuture` — Partner customs broker (dispatch, future event)\n - `ShelfLifeHasExpiredReturn` — Not collected from Postomat — moved to the nearest division\n - `Lost` — Shipment lost\n"},"eventStatus":{"type":"string","description":"Event execution statuses.\n\n**Possible values:**    \n- `Passed` — the event has already occurred\n- `Now` — the event is currently taking place\n- `Future` — the event is planned for the future\n"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","nullable":true,"description":"A two-letter code representing the sender's country, following the ISO 3166-1 Alpha-2 standard, indicating the country of origin for the shipment."},"code":{"type":"string","description":"Tracking status code number.\n\n**Permissible values match those defined for the `currentStatus. statusCode` field.**\n"},"divisionName":{"type":"string","description":"Warehouse where the corresponding event occurs."},"postCode":{"type":"string","description":"Actual postal code."},"settlementName":{"type":"string","description":"Name of the locality where the event takes place."},"eventName":{"type":"string","description":"Client-specific event name."},"postCode1":{"type":"string","description":"Start of the postal code range for the settlement."},"postCode2":{"type":"string","description":"End of the postal code range for the settlement."}}}}},"parcelsHistoryOnlineTracking":{"type":"object","description":"An array of objects containing information about the parcel’s online tracking status history, excluding duplicate events.\n\nPopulated when parcel-level tracking is used (i.e., when `trackingByBarcode` is provided or `withAllParcels` = `true`).\n","additionalProperties":{"type":"array","description":"Dynamic object key whose value is the Parcel number. Used to group tracking events by specific Parcel.","items":{"type":"object","properties":{"number":{"type":"string","description":"Shipment number."},"date":{"type":"string","format":"date-time","nullable":true,"description":"Date and time when this status was set.\n\nDate in ISO 8601 format with UTC time zone\n"},"event":{"type":"string","description":"Event name.\n\n**Permissible values match those defined for the `detailsTracking.event` field.**\n"},"eventStatus":{"type":"string","description":"Event execution statuses.\n\n**Possible values:**    \n- `Passed` — the event has already occurred\n- `Now` — the event is currently taking place\n"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","nullable":true,"description":"A two-letter code representing the sender's country, following the ISO 3166-1 Alpha-2 standard, indicating the country of origin for the shipment."},"code":{"type":"string","description":"Tracking status code number.\n\n**Permissible values match those defined for the `currentStatus. statusCode` field.**\n"},"divisionName":{"type":"string","description":"Warehouse where the corresponding event occurs."},"postCode":{"type":"string","description":"Actual postal code."},"settlementName":{"type":"string","description":"Name of the locality where the event takes place."},"eventName":{"type":"string","description":"Client-specific event name."},"postCode1":{"type":"string","description":"Start of the postal code range for the settlement."},"postCode2":{"type":"string","description":"End of the postal code range for the settlement."}}}}},"parcels":{"type":"array","description":"Parcels` description block. Array contains objects, each object responsible for information about parcel.","items":{"type":"object","properties":{"number":{"type":"string","pattern":"^[A-Z]{4}\\d{10}$","description":"Transportation document number."},"rowNumber":{"type":"integer","minimum":1,"nullable":true,"description":"Parcel number."},"untied":{"type":"boolean","description":"Internal data, not for use."},"cargoCategoryGroup":{"type":"string","description":"Shipment type (parcel, documents, pallet, etc.)"},"cargoCategoryId":{"type":"string","description":"Internal data, not for use."},"categoryCargoName":{"type":"string","description":"Shipment category name."},"parcelDescription":{"type":"string","maxLength":255,"description":"A brief description of the contents of the package."},"insuranceCost":{"type":"number","minimum":0,"description":"The amount of the declared value."},"insuranceCostCurrencyCode":{"type":"string","description":"Currency in which the shipment's declared value is specified, according to the ISO 4217 standard."},"length":{"type":"integer","minimum":1,"description":"The actual length of the parcel in mm."},"width":{"type":"integer","minimum":1,"description":"The actual width of the parcel in mm."},"height":{"type":"integer","minimum":1,"description":"The actual height of the parcel in mm."},"actualWeight":{"type":"number","minimum":0,"maximum":2147483647,"description":"The actual weight of the parcel in grams."},"volumetricWeight":{"type":"number","minimum":0,"maximum":2147483647,"description":"The volumetric weight of the parcel."},"lengthCheck":{"type":"number","nullable":true,"description":"Actual adjusted shipment length in millimeters after control measurement."},"widthCheck":{"type":"number","nullable":true,"description":"Actual adjusted shipment width in millimeters after control measurement."},"heightCheck":{"type":"number","nullable":true,"description":"Actual adjusted shipment height in millimeters after control measurement."},"actualWeightCheck":{"type":"number","nullable":true,"description":"Actual adjusted shipment weight in grams after control measurement."},"volumetricWeightCheck":{"type":"number","nullable":true,"description":"Actual adjusted shipment volumetric weight in grams after control measurement."}}}},"alternativeNumbers":{"type":"array","description":"An array of objects containing a list of related shipments.","items":{"type":"string"}},"alternativeNumbersGW":{"type":"array","description":"An array of objects containing extended information about related shipments.","items":{"type":"object","properties":{"name":{"type":"string","description":"Shipment owner name."},"number":{"type":"string","description":"Shipment number."},"date":{"type":"string","format":"date-time","description":"Shipment creation date\n\nDate in ISO 8601 format with UTC time zone\n"}}}},"undeliveryReasons":{"type":"array","description":"An array of objects containing information about shipment non-delivery reasons.","items":{"type":"object","properties":{"reasonName":{"type":"string","description":"Non-delivery reason name."},"reasonDate":{"type":"string","format":"date-time","description":"Non-delivery date.\n\nDate in ISO 8601 format with UTC time zone\n"},"reasonId":{"type":"string","description":"Unique identifier of the non-delivery reason."},"subtypeOfReasonId":{"type":"string","description":"Unique identifier of the non-delivery subreason."},"subtypeOfReasonName":{"type":"string","description":"Non-delivery subreason name."}}}},"createdOnTheBasis":{"type":"array","description":"An array of objects containing information about shipments based on other ones.","items":{"type":"object","properties":{"number":{"type":"string","description":"Document number"},"type":{"type":"string","description":"Document type.\n\n  **Possible values:**\n  - `Redirecting`\n  - `Return`\n  - `Utilization`\n  - `Redelivery`\n"},"createdDate":{"type":"string","format":"date-time","description":"Non-delivery date.\n\nDate in ISO 8601 format with UTC time zone\n"}}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Validation"},"503":{"$ref":"#/components/responses/Time-out"}},"summary":"FullTracking"}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-portal.novapost.com/metodi-1/methods/shipments/tracking-shipment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
