GLS Group Europe Tracking API & MCP
Query live GLS Group Europe (gls) package status and scan history in a single synchronous GET request or MCP tool call. lastscanned reads the same call as gls-group.eu's parcel-tracking page. GLS US is a separate carrier: see GLS US.
Overview & Quick Facts
| Property | Value |
|---|---|
Carrier slug (?carrier=) | gls |
| Brand & service aliases | GLS, GLS Group, GLS Europe, GLS Germany (gls-pakete.de), General Logistics Systems |
| Category | European ground parcel network |
| Single-package REST endpoint | GET https://api.lastscanned.com/v1/track/{trackingNumber} (11-digit numbers are tried when no other carrier claims them; otherwise add ?carrier=gls) |
| Batch REST endpoint | GET https://api.lastscanned.com/v1/track?numbers=10272483975,... |
MCP server (https://mcp.lastscanned.com) | track_package, track_packages, list_carriers (claude mcp add --transport http lastscanned https://mcp.lastscanned.com) |
| Authentication & pricing | Authorization: Bearer lsk_live_... · 1 free keyless lookup/day per IP · Free tier (5 unique numbers/day, $0) · Pro ($4.99/mo for 1,000 unique numbers, unlimited re-polls, $0.015/extra) · HTTP 402 Stripe MPP ($0.50 for 25-number lsk_pack_ key or $0.02/number in USDC on Tempo) |
Tracking Number Formats & Auto-Detection (matches vs ?carrier=gls)
| Pass | Rule / Regex | Check Digit | Examples |
|---|---|---|---|
Pass 1 (matches) | None | n/a | n/a |
Pass 2 (mayMatch) | /^\d{11}$/ | None | 10272483975 |
Explicit (?carrier=gls) | Any GLS parcel number (11-14 digits, plus alphanumeric references) | None | 10272483975 |
When is ?carrier=gls optional vs required?
- Optional: 11-digit numbers that no other carrier claims.
- Required (
?carrier=gls): 12-digit numbers (FedEx's shape), other lengths and alphanumeric references.
Synchronous GET Request & Normalized JSON Response
curl
curl -s "https://api.lastscanned.com/v1/track/10272483975?carrier=gls" \
-H "Authorization: Bearer $LASTSCANNED_API_KEY"JavaScript / TypeScript (fetch)
const res = await fetch("https://api.lastscanned.com/v1/track/10272483975?carrier=gls", {
headers: { Authorization: `Bearer ${process.env.LASTSCANNED_API_KEY}` },
});
const pkg = await res.json();
console.log(pkg.status, pkg.events[0]);MCP track_package tool call
{
"tool": "track_package",
"arguments": {
"tracking_number": "10272483975",
"carrier": "gls"
}
}Normalized TrackingResult JSON response
{
"carrier": "gls",
"trackingNumber": "10272483975",
"status": "delivered",
"statusDescription": "The parcel has been delivered.",
"service": null,
"deliveredAt": "2026-10-22T07:15:00Z",
"deliveredAtLocal": "2026-10-22T09:15:00",
"signedBy": null,
"destination": null,
"events": [
{
"timestamp": "2026-10-22T07:15:00Z",
"localTime": "2026-10-22T09:15:00",
"status": "delivered",
"description": "The parcel has been delivered.",
"location": "Neuss, Germany",
"code": null
},
{
"timestamp": "2026-10-20T08:00:00Z",
"localTime": "2026-10-20T10:00:00",
"status": "in_transit",
"description": "The parcel has been handed over to GLS.",
"location": "Neuss, DE",
"code": null
}
]
}Notes
- Uses
gls-group.eu/app/service/open/rest/EU/en/rstt029withcaller=witt002, as the tracking page does. An unknown number answers 404 and becomesnot_found. - Scan times carry no zone;
timestampis set only when the scan's country is a single-time-zone country. - The package status follows GLS's own progress bar when it is present.
Related Resources
- Live browser lookup tool: Track a GLS Group Europe package live on lastscanned.com/lookup/gls
- Regex & check digits: Tracking number formats & auto-detection
- AI support workflows: WISMO AI agents & synchronous tracking