# Watch numbers

URL: https://docs.lastscanned.com/reference/webhooks/createWatch

`POST https://api.lastscanned.com/v1/watches`

Looks the numbers up now and returns each watch with its current `result`, then re-checks them on a schedule and
POSTs to the account's webhook whenever the status, newest event or estimate changes. A new watch counts as a
tracked number; re-checks are free. A number already being watched keeps its watch (200 instead of 201).

Body:

```json
{
  "trackingNumber": "541270563758",
  "metadata": {
    "order": "A1"
  }
}
```

Responses:
- 200: Already watched; the existing watch.
- 201: The watch (or `{watches}` for `trackingNumbers`), with its first result.
- 400: `unknown_carrier`: no carrier's format matches the number (or its check digit is wrong), or `carrier` isn't supported.
- 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).

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