Docs·Getting started·Introduction

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. Everything is authenticated with a Bearer key and rate-limited per plan.

The engine is deterministic — the same inputs and provider chain always yield the same score, and the audit log can replay any call.

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
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

The scoring surface spans real-time, historical and climate horizons — plus intelligence and underwriting. Start with POST /v1/score; 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 /v1/score reference.