# Lookup history

URL: https://docs.lastscanned.com/reference/account/getLookups

`GET https://api.lastscanned.com/v1/lookups`

One entry per tracking number per request, newest first, from the last 30 days.

Parameters:
- `limit` (query)
- `cursor` (query): The previous page's nextCursor.
- `number` (query): Only this tracking number, or numbers starting with it.

Responses:
- 200: A page of lookups.
- 400: `bad_request`: the cursor isn't one this route returned.
- 401: `unauthorized`: missing, wrong or revoked key, or a disabled account.

```json
{
  "lookups": [
    {
      "number": "1Z999AA10123456784",
      "carrier": "ups",
      "status": "delivered",
      "error": null,
      "source": "api",
      "cached": false,
      "createdAt": "2026-10-26T18:06:20Z"
    }
  ],
  "nextCursor": null
}
```

Full spec: https://docs.lastscanned.com/openapi.yaml