Tracking αποστολής

Η κλήση GET /shipments/{voucher}/tracking επιστρέφει όλα τα tracking events μιας αποστολής, από το παλαιότερο προς το νεότερο.

WARNING

Θα πρέπει να συμπεριλάβετε το API Token σας σε κάθε αίτημα ως Bearer Token. Αντικαταστήστε το YOUR_TOKEN με το API Token του καταστήματος (chub_...). Δείτε το Overview.

Method	URI	Headers
GET	/api/v2/shipments/{voucher}/tracking	Authorization: Bearer YOUR_TOKEN

Μεταβλητές αποστολής

Variable Name	Type	Usage	Required
voucher	String	Ο αριθμός voucher, μέσα στο path του URL (π.χ. 7012345678).	*

Η λίστα δεν σελιδοποιείται: επιστρέφονται όλα τα events του voucher.

Απάντηση αιτήματος

Η εφαρμογή σας επιστρέφει δεδομένα σε μορφή JSON: ένα data με πίνακα events, παλαιότερο πρώτο. Αν δεν υπάρχουν events, το data είναι κενός πίνακας.

Variable Name	Type	Description
occurred_at	String	Πότε έγινε το event σύμφωνα με την courier (ISO 8601, UTC).
description	String	Το κείμενο της courier όπως ακριβώς το έστειλε, χωρίς μετάφραση ή κανονικοποίηση.
details	Object, Array, String ή null	Πρόσθετα στοιχεία του event. Αν η courier έστειλε JSON, είναι αντικείμενο ή πίνακας, αλλιώς το κείμενο ως string. null αν δεν υπάρχουν.
code	Integer ή null	Ο κωδικός κατάστασης της courier.

Μόνο η courier του voucher

Επιστρέφονται μόνο τα events της courier του συγκεκριμένου voucher. Αν η παραγγελία προωθήθηκε σε άλλη courier, τα events της άλλης δεν περιλαμβάνονται εδώ (αλλά μπορεί να εμφανίζονται στο last_event της αποστολής).

Η μορφή του details

Κάθε courier στέλνει διαφορετικά πρόσθετα στοιχεία. Μην υποθέτετε τύπο: ελέγξτε αν το details είναι αντικείμενο, πίνακας, string ή null. Τα κενά αντικείμενα διατηρούνται ως {} (δεν γίνονται []).

Παράδειγμα επιτυχημένης αναζήτησης.

Το παράδειγμα δείχνει και τις τρεις μορφές του details: null, αντικείμενο (με εμφωλευμένο κενό αντικείμενο και πίνακα) και string.

{
    "data": [
        {
            "occurred_at": "2026-10-14T07:30:00Z",
            "description": "Παραλαβή από τον αποστολέα",
            "details": null,
            "code": 1
        },
        {
            "occurred_at": "2026-10-14T10:15:00Z",
            "description": "Αναχώρηση από το κέντρο διαλογής Αθήνας",
            "details": {
                "station": "ΑΘΗ",
                "depot": {},
                "scans": [
                    "A1",
                    "B7"
                ]
            },
            "code": 12
        },
        {
            "occurred_at": "2026-10-14T11:00:00Z",
            "description": "Σε διαδικασία διανομής",
            "details": "Ο οδηγός είναι καθ' οδόν",
            "code": 13
        },
        {
            "occurred_at": "2026-10-15T05:40:00Z",
            "description": "Παραδόθηκε",
            "details": {
                "signed_by": "Μ. Παπαδοπούλου"
            },
            "code": 7
        }
    ]
}

Παράδειγμα σφάλματος (άγνωστος αριθμός voucher).

{
    "message": "Resource not found.",
    "code": "not_found"
}

Παράδειγμα κλήσης

curl https://courierhub.gr/api/v2/shipments/7012345678/tracking \
  -H "Authorization: Bearer chub_YOUR_API_TOKEN" \
  -H "Accept: application/json"