The Goable API

One REST call turns weather, ocean, atmospheric and astronomical data into a single 0–100 suitability verdict for a specific activity, place and time.

Overview

Goable is a physics-first scoring engine exposed as a JSON REST API. You send a location, an activity and a time window; you get back a deterministic score, a verdict, a per-dimension breakdown, the raw physical readings and an audit-ready provider chain. Every request is authenticated with an API key in the X-Goable-Key header and rate-limited per plan.

Base URL

https://api.goable.io
# all endpoints are versioned under /v1

Quickstart · 60 seconds

Install the TypeScript SDK and make your first call:

// npm install @goable-io/sdk
// (Python: pip install goable-sdk)
import { GoableClient } from "@goable-io/sdk"

const goable = new GoableClient({ apiKey: process.env.GOABLE_API_KEY! })

const { score, verdict } = await goable.score({
 location: { lat: 36.013, lng: -5.604 },
 activity: "kitesurfing",
 window: { from: "2026-05-23T09:00Z", to: "2026-05-23T18:00Z" },
})

Or straight from the shell with cURL:

curl https://api.goable.io/v1/score \
 -H "X-Goable-Key: sk_live_…" \
 -d '{ "activity": "kitesurfing", "location": { "lat": 36.013, "lng": -5.604 } }'

What you can call

Start with POST /v1/score and POST /v1/score/series, the live core. The API also exposes richer surfaces across historical and climate horizons plus intelligence and parametric underwriting; some are plan-gated and some are still in research, and each endpoint's reference states its current status. The full method list is in the TypeScript SDK reference.

Next steps

Set up your key in Authentication, learn the failure modes in Errors & rate limits, then dive into the score endpoint reference.