# Met Office — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access detailed UK weather forecasts, real-time lightning tracking, and weather warnings from the Met Office. Search locations to retrieve hourly, daily, regional, and long-range predictions, and monitor storm activity with spot forecasts across any geographic area.

**Category:** Weather | **Website:** [metoffice.gov.uk/](https://metoffice.gov.uk/) | **Docs:** [parse.bot/marketplace/ddb90eb5-8bc1-49b9-b065-8719014d058b/metoffice-gov-uk-api](https://parse.bot/marketplace/ddb90eb5-8bc1-49b9-b065-8719014d058b/metoffice-gov-uk-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/met-office/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get daily forecast

Retrieve the 7-day daily weather forecast and current conditions for a specific location using its geohash from search_location.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `geohash` | string | Yes | Location geohash from search_location results (e.g. 'gcpvj0v07'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/met-office/get-daily-forecast \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"geohash":"<string>"}'
```

### Get hourly forecast

Retrieve detailed hourly weather forecast data for a location. Returns weather conditions for each hour of the current day or a specified date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Specific date for forecast in ISO format YYYY-MM-DD. Omitting returns today's hourly forecast. |
| `geohash` | string | Yes | Location geohash from search_location results (e.g. 'gcpvj0v07'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/met-office/get-hourly-forecast \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","geohash":"<string>"}'
```

### Get lightning data

Retrieve real-time lightning strike data including coordinates and timestamps from the Met Office lightning detection network.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/met-office/get-lightning-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get spot forecast

Retrieve spot forecast data for map layers (temperature, wind, symbols, etc.) within a geographic bounding box. Returns forecast data points for named locations within the area.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bbox` | string | No | Bounding box as 'minLon,minLat,maxLon,maxLat' covering the geographic area of interest. |
| `layers` | string | No | Forecast layer to retrieve. Known values: 'symbol', 'temperature', 'wind'. |
| `zoom` | integer | No | Map zoom level (integer, higher values show more detail). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/met-office/get-spot-forecast \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"bbox":"<string>","layers":"<string>","zoom":"<integer>"}'
```

### Get uk long range forecast

Retrieve the UK-wide national long-range weather forecast narrative covering the outlook for the next several weeks.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/met-office/get-uk-long-range-forecast \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get uk regional forecast

Retrieve text-based weather forecasts for a specific UK region. Returns detailed narrative forecasts including current conditions, short-term outlook, and long-range predictions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | Yes | UK region code. Accepted values: 'se' (South East England), 'nw' (North West England), 'ne' (North East England), 'sw' (South West England), 'wm' (West Midlands), 'em' (East Midlands), 'ee' (East of England), 'yh' (Yorkshire and Humber), 'wl' (Wales), 'ni' (Northern Ireland), 'os' (Orkney and Shetland), 'he' (Highland and Eilean Siar), 'ta' (Central, Tayside and Fife), 'gr' (Grampian), 'st' (Strathclyde), 'dg' (Dumfries, Galloway, Lothian and Borders). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/met-office/get-uk-regional-forecast \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"region":"<string>"}'
```

### Get uk storm centre

Retrieve information about named storms, the current storm season, and storm naming conventions from the Met Office UK Storm Centre.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/met-office/get-uk-storm-centre \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get uk weather warnings

Retrieve all active UK weather warnings issued by the Met Office. Returns an empty list when no warnings are currently active.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/met-office/get-uk-weather-warnings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search location

Search for UK locations by name to retrieve their unique geohash codes, which are required for forecast endpoints. Returns up to 10 matching locations with their geohash, coordinates, area, and type.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Location name to search for (e.g. 'London', 'Manchester', 'Edinburgh'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/met-office/search-location \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.