Inex API Documentation

Logistic History

With this service, you can retrieve the parcel logistic history by tracking number.

GET /integrators/logistics/history/{waybillNumber}

Field	Type	In	Required	Example	Description
waybillNumber	string	PATH	Yes	YT72358DF03423452	Parcel tracking number.
Accept-Language	string	HEADER	No	ka	Language code (ka, en, ru). Determines enum translations.

Response Structure 200 OK

Attribute	Type	Example	Description
data	array	[]	Logistic events array.
data.*.uid	string (uuid)	391b6da0-17b1-11f1-9b88-00155d4cfe58	Unique event identifier.
data.*.event	object	{}	Event object.
data.*.event.eventId	string	received	Event ID (camelCase).
data.*.event.name	string	Received	Event name.
data.*.event.description	string	Parcel received at the overseas warehouse	Event description.
data.*.reason	object \| null	{}	Event reason (if exists).
data.*.reason.reasonId	string	extraLarge	Reason ID (camelCase).
data.*.message	string \| null	Additional info	Additional message.
data.*.location	object	{}	Location information.
data.*.location.country.name	string	United States	Country name.
data.*.location.city.name	string	New York	City name.
data.*.happenedAt	string	2026-03-04T14:02:15+04:00	Time of action (ISO 8601).
data.*.happenedAtTimeStamp	integer	1772618535000	Time of action (Timestamp ms).

Status Descriptions

For detailed information about logistic statuses and their reasons, please visit the separate page: Statuses Page

Possible Responses

Code	Description
200 OK	Logistic events array.
403 Forbidden	You do not have permission to perform this operation

cURL Request BASH

curl -X GET https://api-staging.inex.ge/api/v1/integrators/logistics/history/YT72358DF03423452 \
                -H "Authorization: Bearer {TOKEN}" \
                -H "Content-Type: application/json"
                -H "Accept-Language: ka"

Response (200 OK)

JSON Response JSON

{
    "data": [
        {
            "uid": "391b6da0-17b1-11f1-9b88-00155d4cfe58",
            "event": {
                "eventId": "received",
                "name": "Received",
                "description": "Parcel received at the overseas warehouse"
            },
            "reason": null,
            "message": null,
            "location": {
                "country": {
                    "name": "United States",
                    "code": "US"
                },
                "city": {
                    "name": "New York"
                },
                "pickupLocation": null
            },
            "happenedAt": "2026-03-04T14:02:15+04:00",
            "happenedAtTimeStamp": 1772618535000
        },
        {
            "uid": "482c7eb1-28c2-22g2-0c99-11266e5dgf69",
            "event": {
                "eventId": "rejected",
                "name": "Rejected",
                "description": "The package was rejected by the recipient or warehouse"
            },
            "reason": {
                "reasonId": "extraLarge",
                "name": "Extra Large",
                "description": "Package is too large"
            },
            "message": "Rejected due to size limits",
            "location": {
                "country": {
                    "name": "United States",
                    "code": "US"
                },
                "city": {
                    "name": "New York"
                },
                "pickupLocation": null
            },
            "happenedAt": "2026-03-05T10:00:00+04:00",
            "happenedAtTimeStamp": 1772690400000
        }
    ]
}

Error Response (403)

JSON Response JSON

{
    "errors": {
        "general": [
            "You are not authorized to perform this action. Contact administrator."
        ]
    },
    "message": "error"
}

Error Response (404)

JSON Response JSON

{
    "errors": {
        "general": [
            "Requested parcel not found"
        ]
    },
    "message": "error"
}