# Track several numbers

URL: https://docs.lastscanned.com/reference/tracking/trackMany

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

Up to 100 numbers per call and 35 per carrier. Duplicates are removed; numbers from different carriers can be mixed. `results` has one entry per number, in the order requested, each with either `result` or `error`; one bad number never fails the others.

Counts each distinct number toward the account's usage.

Parameters:
- `numbers` (query, required): Comma-separated tracking numbers.
- `carrier` (query): Skip detection and ask this carrier. Needed for numbers too generic to detect.

Responses:
- 200: One entry per number.
- 400: `bad_request`: no numbers, more than 100, or more than 35 for one carrier. `unknown_carrier`: unsupported `carrier`.
- 401: `unauthorized`: missing, wrong or revoked key, or a disabled account.
- 429: `rate_limited`: the account's daily limit is reached (resets 00:00 UTC), or the carrier is throttling (Spee-Dee).
- 500: `internal_error`: unexpected failure.

```json
{
  "results": [
    {
      "trackingNumber": "1Z999AA10123456784",
      "result": {
        "carrier": "ups",
        "trackingNumber": "1Z999AA10123456784",
        "status": "in_transit",
        "statusDescription": "In Transit",
        "service": "UPS Ground",
        "deliveredAt": null,
        "signedBy": null,
        "destination": {
          "city": "AUSTIN",
          "state": "TX",
          "country": "US"
        },
        "estimatedDelivery": "2026-08-07",
        "events": [
          {
            "timestamp": "2026-08-06T08:44:09Z",
            "localTime": "2026-08-06T03:44:00",
            "status": "in_transit",
            "description": "Arrived at Facility",
            "location": "AUSTIN, TX, US",
            "code": "AR"
          }
        ]
      }
    },
    {
      "trackingNumber": "123456789012",
      "error": {
        "code": "not_found",
        "message": "FedEx returned no track details for that number"
      }
    }
  ]
}
```

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