✈
    TravelmodeDevelopers
    🔎/
    🔑Manage API Keys
    Feature
    🌦️Weather🛂Visa🧩Platform🧭Trips🤖Agent Runs📅Events

    Weather Intelligence API · v1

    📖Overview🧪API Reference (Try It)
    Guides
    🚀Getting Started🔐Authentication⏱️Rate Limits📡Endpoints⚠️Errors🪝Watch Webhooks💳Billing🧊Cache & Freshness📝Attribution
    ⬇️Download openapi.yaml
    Developers / Weather / Attribution

    Provider Attribution (Placeholder)

    Last verified: 2026-05-03 (Task #334 — docs accuracy pass).

    Status: Placeholder. The Weather Intelligence API surfaces the active provider's required attribution string in data.attribution on every weather response. The exact contract the wider Travelmode product is held to (where to render attribution, link-back, opt-out behavior) is not yet finalized and will land in a follow-up.

    Where attribution shows up today

    Every successful response from a weather endpoint that resolves a snapshot includes:

    {
      "data": {
        "provider": "openweather",
        "provider_version": "onecall/3.0",
        "attribution": "Weather data provided by OpenWeather",
        "fetched_at": "2026-04-25T18:01:13.412Z"
      }
    }
    
    FieldMeaning
    providerStable identifier for the upstream provider that produced the snapshot.
    provider_versionProvider-specific version / endpoint identifier. Useful when comparing two snapshots from the same provider over time.
    attributionRequired attribution string. Render this verbatim wherever the upstream provider's terms require it.
    fetched_atUTC timestamp at which we fetched the data from the provider.

    What you should do today

    • Store the attribution string. Don't drop it on ingest.
    • Render it next to user-visible weather. A footer credit, an info popover, or a tooltip is fine.
    • Don't re-brand the data. Until the final attribution rules ship, treat the provider string as required.

    What's coming

    The follow-up will cover:

    • Placement requirements (always-on vs on-hover).
    • Link-back URL contract (some providers want a hyperlink to their own page).
    • Opt-out behavior for self-hosted Travelmode deployments using a different provider.

    Until then, treat this page as the source of truth.

    Previous
    ← Cache & Freshness