> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skymatch.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Weather intelligence for outdoor bookings — one API call, one clear answer.

## What is SkyMatch?

SkyMatch is a weather decision API built for outdoor booking platforms. Pass a location, time slot, and activity type — get back a playability score and a clear recommendation.

Instead of showing raw weather data to your users, SkyMatch gives you a single, actionable answer:

* ✅ **Safe to book** — conditions look good, proceed
* ⚠️ **Proceed with caution** — conditions are marginal
* ❌ **Not recommended** — high risk of cancellation

## Who is it for?

SkyMatch is designed for **developers building booking platforms** for outdoor activities — padel courts, tennis venues, football pitches, hiking trails, outdoor events, golf courses, and more.

If your platform takes bookings for anything that happens outside, SkyMatch helps you reduce weather-related cancellations before they happen.

## How it works

```
Your booking platform
        ↓
User selects a time slot
        ↓
You call SkyMatch API
        ↓
We return a playability score + recommendation
        ↓
You show the user a confidence indicator
```

Your platform keeps full control of the booking flow — SkyMatch just adds weather intelligence on top.

## Base URL

All endpoints are served from:

```
https://api.skymatch.uk/v1
```

## Quick example

```bash theme={null}
curl 'https://api.skymatch.uk/v1/booking-confidence
  ?lat=51.5074&lng=-0.1278
  &start_time=2026-04-24T18:30:00Z
  &duration_minutes=90&sport=padel' \
  -H 'X-API-Key: your_api_key_here'
```

```json theme={null}
{
  "playability_score": 86,
  "recommendation": "safe_to_book",
  "rain_risk": "low",
  "wind_risk": "low",
  "temp_c": 17.4,
  "summary": "Good conditions for outdoor padel."
}
```

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Get your API key and make your first request
  </Card>

  <Card title="Booking confidence" icon="cloud-sun" href="/api-reference/booking-confidence">
    The core endpoint — check if a slot is safe to book
  </Card>

  <Card title="Supported sports" icon="list" href="/supported-sports">
    See all supported activity types
  </Card>

  <Card title="Pricing" icon="credit-card" href="/pricing">
    Free tier available — no credit card needed to start
  </Card>
</CardGroup>