# Track Info API

|             | trackingNo | shippingStatus | trackingUrl | history |
| ----------- | :--------: | :------------: | :---------: | :-----: |
| GLS         |      ✅     |        ✅       |      ✅      |    ✅    |
| Foxpost     |      ✅     |        ✅       |      ✅      |    ✅    |
| MPL         |      ✅     |        ❌       |      ✅      |    ❌    |
| Sprinter    |      ✅     |        ✅       |      ✅      |    ✅    |
| Packeta     |      ✅     |        ✅       |      ✅      |    ✅    |
| DPD         |      ✅     |        ❌       |      ❌      |    ❌    |
| DHL         |      ✅     |        ❌       |      ✅      |    ❌    |
| Eushipments |      ✅     |        ✅       |  partially  |    ✅    |

| Parameter | Description                                                                            | Mandatory  |
| --------- | -------------------------------------------------------------------------------------- | ---------- |
| apiKey    | API key                                                                                | yes        |
| limit     | The number of elements in the list (maximum 1000).                                     | no         |
| page      | The page number to query.                                                              | no         |
| orderIds  | The webshippy identifiers of the orders are separated by commas.                       | optional\* |
| updatedAt | The time of the earliest update by the courier service, given in Y-m-d\TH:i:sP format. | optional\* |

{% hint style="info" %}

```
* At least one of the orderIds and updatedAt fields is mandatory.
```

{% endhint %}

Sample request (XML):

```
https://app.webshippy.com/wspyapi/getTrackInfo/xml?apiKey={{apiKey}}&page=0&orderIds=32042911
```

Sample request (JSON):

```
https://app.webshippy.com/wspyapi/getTrackInfo/json?apiKey={{apiKey}}&page=0&orderIds=32042911
```

Response (JSON):

```
{
    "status": "success",
    "message": [],
    "result": {
        "274": {
            "orderId": "274",
            "trackingNo": "3300597015",
            "shippingStatus": "completed",
            "trackingUrl": "https://gls-group.eu/HU/hu/csomagkovetes?match=3300597015",
            "history": [
                {
                    "status": "delivered",
                    "statusCode": "05",
                    "date": "2024-01-03 14:31:49"
                },
                {
                    "status": "Can be picked up from GLS parcel locker",
                    "statusCode": "54",
                    "date": "2024-01-02 10:44:03"
                },
                {
                    "status": "Data sent",
                    "statusCode": "51",
                    "date": "2023-12-29 13:15:05"
                }
            ]
        }
    }
}
```

Response on incorrect request:

```
{
    "status": "error",
    "message": [
        "Error: At least one field is required: orderIDs, updatedAt"
    ]
}
```