fetch.li documentation
fetch.li is a UK data API: small, focused routes for everyday UK work. Every GET response leads with ok, answer, and say. Add ?format=text for the one-liner.
You do not need to install anything. Each endpoint is a normal web address.
Who this is for
- Non-technical users who want quick answers in a browser, a spreadsheet, or a no-code tool like Zapier.
- Developers who want reliable HTTP endpoints with clear examples in curl, JavaScript, and Python.
- Teams building UK-facing products who need sensible defaults (GBP, UK bank holidays, postcodes) without wiring up five different services.
How to read these docs
Each page follows the same shape:
- A plain-English explanation of what the endpoint does.
- Who it is useful for.
- Try it defaults you can paste into a browser or spreadsheet.
- Full HTTP examples (raw request, curl, JavaScript, Python).
- A realistic example response.
- A parameter table and common errors.
Sections
| Section | What you will find |
|---|---|
| Getting started | Try buttons, API keys, auth, and the free demo tier |
| Account and keys | TOTP, type DELETE to revoke |
| Abuse protection | Rate limits, demo geo, honeypots |
| Studio and mail | Connor O’Driscoll, Tidalux Ltd, Proton and SMTP |
| Answer contract | answer, say, format=text, format=csv |
| Spreadsheets and no-code | First call, Sheets, Zapier, and the jobs each route is good at |
| Guides | Spreadsheets, no-code, plus errors |
| Life | Pulse, should I, ask |
| Sky | Moon, sun, planets in sight |
| Weather | Now, wind, rain, air |
| UK | Holidays, postcodes, tax, carbon, floods |
| Money | VAT and ECB FX |
| Tools | Units, QR, ids |
| Content | Vibe classify (paid) |
Base URL
All examples use:
https://fetch.li
Replace fetch.li with the hostname shown on your dashboard or in your deployment notes.
Quick map of endpoints
Sky and weather (free demo, GET)
| Method | Path | Summary |
|---|---|---|
| GET | /v1/moon |
Moon phase and rise/set for a location |
| GET | /v1/sun |
Sunrise, sunset, and daylight hours |
| GET | /v1/pulse |
Morning OS: weather, kit, air, carbon, sky |
| GET | /v1/weather |
Current weather |
| GET | /v1/visible |
Planets, sun, moon above the horizon |
| GET | /v1/weather/forecast |
Forecast for up to several days |
UK data (free demo, GET)
| Method | Path | Summary |
|---|---|---|
| GET | /v1/uk/bank-holidays |
All bank holidays for a year |
| GET | /v1/uk/bank-holiday |
Check whether a date is a bank holiday |
| GET | /v1/uk/postcode |
Look up a UK postcode |
| GET | /v1/uk/working-days |
Count forward by working days |
Money (free demo, GET)
| Method | Path | Summary |
|---|---|---|
| GET | /v1/vat |
Add or remove VAT from an amount |
| GET | /v1/fx |
Convert between currencies |
Tools (free demo, GET)
| Method | Path | Summary |
|---|---|---|
| GET | /v1/convert |
Convert units (length, weight, temperature, and more) |
| GET | /v1/qr |
Generate a QR code image URL or data |
| GET | /v1/hash |
Hash a string |
| GET | /v1/uuid |
Generate a UUID |
| GET | /v1/slug |
Turn text into a URL-friendly slug |
| GET | /v1/countdown |
Time remaining until a date |
| GET | /v1/readtime |
Estimated reading time for text |
| GET | /v1/now |
Current server time in several formats |
Content (paid, POST, key required)
| Method | Path | Summary |
|---|---|---|
| POST | /v1/vibe/classify |
Classify copy into vibe, mood tags, and colours |
Free demo vs paid
- GET endpoints work on the public demo tier: 60 calls per hour per IP, no key needed. See Demo tier.
- POST
/v1/vibe/classifyrequires an API key. See Authentication and Vibe classify.
Machine-readable catalog
Discover live routes programmatically:
GET /v1 HTTP/1.1
Host: fetch.li
Accept: application/json
Health check
GET /health HTTP/1.1
Host: fetch.li
Accept: application/json
Returns 200 when the API process is running. Useful for uptime monitors and load balancers.
Next steps
- Start here if you have never called an API before.
- Spreadsheets and no-code if you are comfortable with a terminal, a sheet, or Zapier.
- Pick an endpoint from the tables above and open its reference page.