From zero to a verdict in five minutes

One REST call turns weather, ocean, atmospheric and astronomical data into a single 0–100 suitability score for an activity, a place and a time. Here is the shortest path to your first one.

1 · Get a key

Create a tenant and mint a key from the dashboard. Keys are Bearer tokens, prefixed and SHA-256 hashed server-side; see Authentication for handling and rotation. The Free plan gives 1,000 calls/month — enough to build.

2 · Install the SDK

The TypeScript SDK is the most ergonomic path; it is zero-dependency and fully typed. cURL works anywhere if you prefer raw HTTP.

# npm · pnpm · yarn
npm install @goable-io/sdk

3 · Your first score

Construct the client once with your key, then call score with an activity, a location and a time window:

import { GoableClient } from "@goable-io/sdk"

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

const result = await goable.score({
 activity: "kitesurfing",
 location: { lat: 36.01, lng: -5.61 }, // Tarifa
 window: { from: "2026-06-01T09:00:00Z", to: "2026-06-01T15:00:00Z" },
})

console.log(result.score, result.verdict)

The same call over HTTP:

curl https://api.goable.io/v1/score \
  -H "X-Goable-Key: $GOABLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"activity":"kitesurfing","location":{"lat":36.01,"lng":-5.61},"window":{"from":"2026-06-01T09:00:00Z","to":"2026-06-01T15:00:00Z"}}'

4 · Read the verdict

Every response carries a score (0–100), a verdict, a per-dimension breakdown, a confidence block and the raw physical readings:

{
 "score": 82,
 "verdict": "favorable",
 "confidence": 0.78,
 "breakdown": { wind: 0.91, … },
 "eco": { energy_class: "A", … }
}

Next steps

Explore the full request/response on the /v1/score reference, understand the bands and confidence in Concepts, or browse every endpoint in the interactive API Reference. When a session happens, report the outcome so the engine can calibrate to your spots.