watchers

WATCHER: get a signed callback when a flight's status...

WATCHER: get a signed callback when a flight's status changes (e.g. Scheduled → Delayed → Departed → Landed). Arm once, pay once. Pass ident (airline flight designator like UAL1 / UA1, or a tail number). Fires on each status transition for the nearest instance; bounded by maxFires/expiry. The status at arm time is baselined (only changes fire). Data via FlightAware. Signed + retried; recoverable via watchers.status. Returns a watcherId.

post/api/watchers/flight-status

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/watchers/flight-status
  • Auth: API key in header PAYMENT-SIGNATURE

Request body

identstring required

Flight designator (UAL1 / UA1) or tail number.

callbackUrlstring uri required

Signed event POSTed here (verify X-2s-Signature). Any http(s) URL.

payloadobject

Arbitrary JSON echoed back in every callback.

expiresInSecondsinteger

Active window in seconds (default 7 days; flights are short-lived).

maxFiresinteger

Stop after this many status changes (default 10).

labelstring

Optional free-text tag.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.