Austrian Post International

Tracking API documentation

This is the official documentation for the Austrian Post Tracking API.

Introduction

The Austrian Post Tracking API works over HTTPS and uses JSON as the data format.
The API is a RESTful API and uses HTTP methods and HTTP status codes to specify requests and responses.

All requests to the Austrian Post Tracking API must be authenticated using an API token. Include your secret API token in every request you send to the API with the HTTP header. You will receive this from us

-H "Authorization: Bearer $TOKEN" \
-H "Authorization: Bearer o23m9jhb5t73y28zs2z32t753snz32dajlqwuhd23u489z3" \

The API URL is:


                                https://manager.myaustrianpost.info/api/

An example authentification via CURL - GET

curl \
-X GET \
-H "Accept: application/json" \
-H "Authorization: Bearer o23m9jhb5t73y28zs2z32t753snz32dajlqwuhd23u489z3" \
'https://manager.myaustrianpost.info/api/auth'

{
    "code": "200",
    "message": "Authorization success!"
}

An example track tracking number via CURL - GET

curl \
-X GET \
-H "Accept: application/json" \
-H "Authorization: Bearer o23m9jhb5t73y28zs2z32t753snz32dajlqwuhd23u489z3" \
'https://manager.myaustrianpost.info/api/tracking/{number}'

{
    "query_time": "2023-09-21T08:50:36.306039Z",
    "tracking_number": "LJ061657317AT",
    "code": "200",
    "tracking_info": [
        {
            "tracking_number": "LJ061657317AT",
            "checkpoint_date": "2023-09-20 14:29:00",
            "location": "DK",
            "checkpoint_delivery_status": "delivered",
            "checkpoint_delivery_substatus": "delivered001",
            "tracking_detail": "delivered",
        },
        {
            "tracking_number": "LJ061657317AT",
            "checkpoint_date": "2023-09-20 07:34:00",
            "location": "DK",
            "checkpoint_delivery_status": "pickup",
            "checkpoint_delivery_substatus": "pickup001",
            "tracking_detail": "Item in process of delivery",
        },
        {
            "tracking_number": "LJ061657317AT",
            "checkpoint_date": "2023-09-19 14:01:01",
            "location": "DK",
            "checkpoint_delivery_status": "transit",
            "checkpoint_delivery_substatus": "transit001",
            "tracking_detail": "Item being processed in country of destination",
        },
        {
            "tracking_number": "LJ061657317AT",
            "checkpoint_date": "2023-09-19 13:51:00",
            "location": "DK",
            "checkpoint_delivery_status": "transit",
            "checkpoint_delivery_substatus": "transit001",
            "tracking_detail": "Item received by postal operator in country of destination",
        },
        {
            "tracking_number": "LJ061657317AT",
            "checkpoint_date": "2023-09-18 22:14:18",
            "location": "AT",
            "checkpoint_delivery_status": "transit",
            "checkpoint_delivery_substatus": "transit001",
            "tracking_detail": "Item ready for international transport",
        },
        {
            "tracking_number": "LJ061657317AT",
            "checkpoint_date": "2023-09-18 04:00:00",
            "location": "5000",
            "checkpoint_delivery_status": "transit",
            "checkpoint_delivery_substatus": "transit001",
            "tracking_detail": "Item posted",
        },
        {
            "tracking_number": "LJ061657317AT",
            "checkpoint_date": "2023-09-14 08:18:24",
            "location": "",
            "checkpoint_delivery_status": "inforeceived",
            "checkpoint_delivery_substatus": "inforeceived001",
            "tracking_detail": "Item pre-advised",
        }
    ]
}

An example register tracking number via CURL - POST

curl \
-X POST \
-H "Authorization: Bearer o23m9jhb5t73y28zs2z32t753snz32dajlqwuhd23u489z3" \
-H "Content-Type: application/json" \
-d '{"shipmentNumber":"123456789"}' \
'https://manager.myaustrianpost.info/api/registerNumber/'

{
    "code": "200",
    "message": "The shipment number was successfully transmitted!"
}

Courier Delivery Status


Status	status_code	Description
Info Received	inforeceived	The courier has received the package info and is about to pick up the package.
In Transit	transit	The package is in transit and has a good transportation condition.
Out for Delivery	pickup	The package has arrived at the local point or is on the way to your home.
Failed Attempt	undelivered	The delivery of the package was attempted but failed due to some reasons. Usually, the courier will arrange another delivery soon.
Delivered	delivered	The package has been delivered. Congratulations!
Exception	exception	The package might have been sent to the sender, damaged, lost or other exceptions.
Expired	expired	The package has no tracking updates for 30 days since the last tracking checkpoint updates.
Not Found	notfound	The tracking info is not available currently. But you may track it after a while.
Pending	pending	The package is pending as the courier did not return the tracking infomation.

Delivery Sub-Status


Main Status	substatus_code	Description
Info Received	inforeceived001	The package is waiting for courier to pick up
In Transit	transit001	Package is on the way to destination
In Transit	transit002	Package arrived at a hub or sorting center
In Transit	transit003	Package arrived at delivery facility
In Transit	transit004	Package arrived at destination country
In Transit	transit005	Customs clearance completed
In Transit	transit006	Item Dispatched
In Transit	transit007	Depart from Airport
Out for Delivery	pickup001	The package is out for delivery
Out for Delivery	pickup002	The package is ready for collection
Out for Delivery	pickup003	The customer is contacted before the final delivery
Delivered	delivered001	Package delivered successfully
Delivered	delivered002	Package picked up by the addressee
Delivered	delivered003	Package received and signed by addressee
Delivered	delivered004	Package was left at the front door or left with your neighbour
Failed Attempt	undelivered001	Address-related issues
Failed Attempt	undelivered002	Receiver not home
Failed Attempt	undelivered003	Impossible to locate the addressee
Failed Attempt	undelivered004	Undelivered due to other reasons
Exception	exception004	The package is unclaimed
Exception	exception005	Other exceptions
Exception	exception006	Package was detained by customs
Exception	exception007	Package was lost or damaged during delivery
Exception	exception008	Logistics order was cancelled before courier pick up the package
Exception	exception009	Package was refused by addressee
Exception	exception010	Package has been returned to sender
Exception	exception011	Package is beening sent to sender
Not Found	notfound002	No tracking information found