Mateusz Oleksy API

Every request to /api/* requires an X-API-Key header carrying your key. Without it the API responds with 401 Not authenticated. Keep your key server-side — never ship it in browser code.

X-API-Key: YOUR_API_KEY

Today, a single key grants full access to every endpoint included in its plan — there's no self-service management, scoping, or rotation yet. That's next.

{
  "id": 42,
  "name": "Production key",
  "plan": "Pro",
  "scopes": ["tracking:read"],
  "createdAt": "2026-05-12T09:00:00Z",
  "lastUsedAt": "2026-07-29T07:40:40Z"
}

{
  "newKey": "mo_live_9f2c...",
  "oldKeyValidUntil": "2026-08-05T00:00:00Z"
}

A single GET request returns the shipment's full event history (traces) as reported by the carrier — the latest entry reflects the current status. The carrier is detected automatically from the number, no need to specify it.

curl -G https://api.mateuszoleksy.pl/api/track \
  --data-urlencode "labelNumber=00159123456789012345" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "traces": [
    {
      "code": "DPD_030103",
      "status": "Zarejestrowano dane przesyłki, przesyłka jeszcze nie nadana",
      "date": "2026-07-20T23:49:39+02:00"
    },
    {
      "code": "DPD_500500",
      "status": "Nadanie paczki za granicą",
      "date": "2026-07-24T16:16:44+02:00"
    },
    // ...7 more events omitted
    {
      "code": "DPD_170310",
      "status": "Powiadomienie mail",
      "date": "2026-07-29T07:40:40+02:00"
    }
  ],
  "courier": {
    "id": 1,
    "name": "DPD",
    "logo": "https://www.epaka.pl/img/kurierIkony/dpd-logo.svg"
  }
}

Enter a shipment number and check its status in real time. The request goes through this page's server-side proxy, so the API key never reaches the browser.

The carrier is detected automatically from the shipment number. Supported carriers include:

Search StockX-sourced product data by name, SKU, or colorway and get back pricing, release dates, and images. The same catalog also powers the public SnkrsDB browser — no key needed there, just use this endpoint if you want the data in your own app.

curl -G https://api.mateuszoleksy.pl/api/snkrsdb/sneakers \
  --data-urlencode "query=yeezy boost 350 v2 onyx" \
  -H "X-API-Key: YOUR_API_KEY"

[
  {
    "sku": "HQ4540",
    "name": "adidas Yeezy Boost 350 V2 Onyx",
    "brand": "adidas",
    "colorway": "Onyx/Onyx/Onyx",
    "retailPrice": 230,
    "releaseDate": "2022-03-05",
    "image": "https://images.stockx.com/images/adidas-Yeezy-Boost-350-V2-Onyx-Product.jpg",
    "weeklyOrders": null,
    "popularityRank": null
  },
  {
    "sku": "FZ6049",
    "name": "adidas Yeezy Boost 350 V2 Onyx (Infants)",
    "brand": "adidas",
    "colorway": "Onyx/Onyx/Onyx",
    "retailPrice": 140,
    "releaseDate": "2024-08-05",
    "image": "https://images.stockx.com/images/adidas-Yeezy-Boost-350-V2-Onyx-Infants.jpg",
    "weeklyOrders": null,
    "popularityRank": null
  }
]

The API uses standard HTTP status codes. Error response bodies include a detail field describing what went wrong.

Current status of the Mateusz Oleksy API platform components.

Change history and planned API releases.

1. v1.32026-07
   • — Breaking: all endpoints moved under /api/* — /v1/track is now /api/track, /snkrsdb/sneakers is now /api/snkrsdb/sneakers.
   • — Dropped path versioning in favor of one consistent prefix for every service.
2. v1.22026-07
   • — StockX sneakers module is live — search by name, SKU, or colorway across 69,000+ items.
   • — Added the public Stock catalog browser — search, filter, and sort with no API key required.
3. v1.12026-07
   • — New live tracking tester added to the docs.
   • — Expanded list of supported carriers.
4. v1.02026-05
   • — Public release of the /v1/track endpoint.
   • — Authorization via the X-API-Key header.