Distribution paths
Licensed or approved sources, with each native representation and exposed clock preserved.
Private technical previewNon-safety-critical
01 / CONTRACT OVERVIEW
Weather data with evidence attached.
The planned API gives applications a clean station object without hiding the representations, fingerprints and clock definitions behind it.
Exact records
Original TAC, SHA-256 identity, path label and collection provenance remain attached.
Station events
Normalized current state, revisions and integrity conditions in one versioned model.
GET /api/preview?station=LEMD
This same-origin endpoint powers the product and API previews on terminalweather.com. Its camelCase response is an implementation support surface and is not offered for customer integration.
GET /v1/stations/LEMD/latest
The intended, versioned snake_case interface. The explorer maps current preview values into this planned shape so the contract can be inspected before access exists.
INTEGRATION KIT
Inspect the proposed contract locally.
Download the OpenAPI preview, schemas and realistic examples. These artefacts are non-production and may change before customer access.
02 / RESPONSE EXPLORER
Current values. Planned contract.
The browser reads the live website support endpoint and maps its values into the proposed customer model. No customer request is being made.
GET
/v1/stations/LEMD/latestPLANNEDLoading preview valuesWebsite support endpoint
{
"availability": "not-generally-available",
"station": { "icao": "LEMD" },
"observation": null,
"integrity": { "state": "loading" }
}03 / RESOURCES
A small station-first surface.
Every route shown here is planned. Names, filters and limits may change before customer access is offered.
/v1/stations/{icao}/latestLatest normalized observation with all available evidence.
/v1/stations/{icao}/observationsOrdered observations and revisions, within licensed retention terms.
/v1/eventsCursor-based integrity and report-condition stream.
/v1/webhook-endpointsFuture event destination configuration and selection.
Corrections, NIL and automatic states are intended to remain addressable rather than being silently replaced.
History and event collections are planned around opaque cursors. No limits have been published.
Historical availability will depend on upstream licences and the commercial terms defined before release.
04 / DATA & TIME
Normalized above. Exact below.
The convenient object and the source evidence are separate layers joined by explicit identity and provenance.
observation
observed_atreport_kindflagsDERIVED FROM
representations[]
raw_tacfingerprint / SHA-256source_paths[]
classificationtimestampsintegrity
statevariant_countObservation time
timestamps.observationNominal weather observation time, provided by the path when available or derived from the TAC day-time group.
Source metadata time
timestamps.sourceThe clock a path actually exposes, such as AWC receiptTime or a response-wide HTTP Last-Modified value. These clocks are not equivalent.
Collection time
timestamps.terminal_weatherWhen Terminal Weather completed that path fetch for the current snapshot. It does not claim origin-to-customer latency.
raw_tacThe exact TAC representation extracted from that endpoint response.
fingerprint.valueSHA-256 content identity for integrity checking and revision comparison.
integrity.statealigned content-difference source-lag incomplete
05 / EVENTS
A condition should become addressable.
The planned event surface turns current-snapshot findings into filterable records while keeping their evidence references intact.
terminal-weather.integrity.content-differenceAvailable paths align on the observation key but meaningful TAC content differs.
terminal-weather.integrity.source-lagAn available path remains on an older observation key in the current snapshot.
terminal-weather.integrity.incompleteAn expected path is missing or does not expose a usable observation time.
terminal-weather.report.correction-presentA COR-qualified representation is present in the current evidence set.
terminal-weather.report.nil-presentA NIL report state is present in the current evidence set.
{
"type": "terminal-weather.integrity.source-lag",
"basis": "current-snapshot",
"station": "LEMD",
"detected_at": "2026-07-15T14:10:00Z",
"data": {
"latest_observed_at": "2026-07-15T14:00:00Z",
"lagging_path_ids": ["example_path"]
},
"derived_from": ["example_path"]
}HTTPS webhooks and cursor-based API events are planned. Signing, retry behavior and limits are not yet specified.
detected_at describes Terminal Weather classification time; it is not the report observation time.
The preview currently emits conditions from a comparison snapshot, not a persisted production event history.
06 / ACCESS & ERRORS
Predictable integration. Honest boundaries.
Authentication and error forms are proposed here to make the intended integration concrete. No customer keys are being issued.
Customer credentials would be passed in the HTTP Authorization header. The value below is an environment-variable placeholder, not a working key.
Authorization: Bearer $TERMINAL_WEATHER_TOKEN- No sign-up or self-service access is live.
- No rate limits or service levels have been published.
- Workspace scope and permitted uses will follow written licence terms.
Errors are intended to use a machine-readable code plus a concise message. A request reference would only be returned when one exists.
{
"error": {
"code": "STATION_NOT_SUPPORTED",
"message": "The station is outside the workspace scope.",
"request_id": null
}
}