Authorize once with your auth token, then call every /v1 endpoint live below.
Every response comes back in the same { data, meta, errors } envelope, in metric or
imperial, with ISO-8601 UTC timestamps and full source attribution.
Interested in the API, or just want to say hello? We'd love to hear from you.
admin@apirepublic.co.ukAPIRepublic is a trading name of API REPUBLIC LTD, a company registered in England and Wales (company number 17514221), registered office 124 City Road, London, United Kingdom, EC1V 2NX.
We are the data controller for the personal data described in this policy. Enquiries relating to this policy, including the rights set out in section 10, should be directed to admin@apirepublic.co.uk.
This policy covers the APIRepublic website, the authenticated
/v1 HTTP API, and the optional MCP add-on that exposes the same data
to AI assistants. It does not cover the public bodies and other data publishers
whose data we relay - each publishes its own terms.
Customer record. When you sign up for a licence we keep a customer record of the details you give us: your name, email address, company (if provided) and your stated purpose, together with your licence details such as its start and expiry dates. These are the only personal details we hold.
Your auth token. Access is granted as a signed token carrying your name, email address, an expiry date and an opaque licence identifier. The identifier is a one-way hash of your email address, used to apply rate limits without retaining further data. The token is self-contained, so we store no passwords or other sign-in credentials, and keep no session store.
Operational logs. Our application records the time of a request, the route requested, the HTTP status code and a random request identifier. It does not record your IP address or browser user-agent. Our hosting provider maintains separate web access logs, which do conventionally include IP addresses and user-agent strings; these are used only to investigate faults and abuse.
Query parameters. Locations you search - a postcode, a map position, a radius - are processed to answer the query. A postcode does not identify a person, but may indicate a location of interest; section 6 sets out the third-party postcode lookup.
Rate-limit counters. A short-lived request counter is held against your licence identifier to prevent flooding of the API. It is held in memory only, decays within a minute, is keyed to the licence rather than to your IP address, and is discarded when the service restarts.
Correspondence. Where you email us, we retain that correspondence and our reply.
This site sets one cookie. It is strictly necessary: it authenticates your active session while you are signed in, and it expires when your auth token does. It is not used for any other purpose.
One preference is stored locally in your browser: whether you have dismissed the cookie notice. It is held in local storage rather than in a cookie, so that retaining the preference does not itself require a tracking cookie.
Because we set no analytics, advertising or other non-essential cookies, there is nothing here for you to consent to or opt out of. The cookie notice is informational, not a consent gate.
Fonts, scripts and the interactive API reference are served from our own servers. On the map page only, your browser contacts the following third-party services directly. Those providers therefore receive your IP address and the identity of the page making the request:
tiles.openfreemap.org), using
OpenStreetMap data - serves the map background (style, tiles, map labels and
symbols). The tiles requested indicate the approximate area of the map being
viewed.api.postcodes.io) - converts a
UK postcode you enter into coordinates. The postcode is transmitted to this
service; no account or identity details accompany it.None of these providers sets a cookie on this site, and none receives precise device geolocation.
Hosting. This website and the API are hosted on
Render (render.com), which runs our servers and
processes data on our behalf as our hosting provider. Render's handling of
that data is described in its own privacy policy, at
render.com/privacy.
Upstream data providers. Queries for river levels, rainfall, storm overflows, air quality, tides and forecasts are made by our server on your behalf. The Environment Agency, DEFRA, the National River Flow Archive, the Channel Coastal Observatory, the Met Office and Flood Forecasting Centre, Open-Meteo and the nine water companies' storm-overflow feeds therefore receive a request from us containing nothing that identifies you.
We do not sell your personal data, and we do not disclose it to any party beyond those described in this section, except where required by law.
Personal data is held in the UK or the European Economic Area. The map-tile and postcode lookup providers named in section 6 may serve requests from, and process your IP address in, a country outside the UK. Where this occurs we rely on the UK adequacy regulations or on the International Data Transfer Addendum to the European Commission's standard contractual clauses, as applicable to the provider concerned.
Under UK data protection law you have the right to: be informed about how your data is used; request a copy of it (a subject access request); have inaccurate data corrected; have your data erased; restrict how we use it; object to processing based on legitimate interests; and receive your data in a portable form.
To exercise any of these rights, email admin@apirepublic.co.uk. We will respond within one month. No charge applies. Given the limited data we hold, erasure of your customer record is the principal action available, and it terminates your access.
Limitation on erasure: your auth token is a self-contained signed credential held by you, not a record on our server. We can cease to honour a licence and delete our copy of your details, but we cannot recall a token already issued to you. Tokens expire of their own accord, and we may decline to renew one.
Concerns about our handling of your personal data should be raised with us in the first instance. You also have the right to complain to the Information Commissioner's Office, the UK data protection regulator, at ico.org.uk/make-a-complaint or on 0303 123 1113. Our entry on the ICO's data protection register is C2081587.
APIRepublic is a professional data service and is not directed at children. We do not knowingly issue licences to, or collect personal data from, anyone under 18. Where we are notified that a child's data has been provided to us, it will be deleted.
We do not carry out any automated decision-making or profiling that produces legal effects for you or otherwise significantly affects you. Rate limiting is an automated technical control on request volume, not a decision about you.
We maintain appropriate technical and organisational measures to protect personal data. Auth tokens are cryptographically signed, and the key used to issue them is held offline rather than on the server, so a compromise of the running service cannot be used to issue access. All traffic is served over HTTPS, and the session cookie is hardened against interception and misuse. We store no passwords or other sign-in credentials, so there are none to be breached, and our customer records hold only the sign-up details listed in section 3. Automated abuse is constrained by rate limiting.
Where this policy is amended, the version and date shown at the top will be updated. Where an amendment materially affects the handling of your personal data, current licence holders will be notified by email. A copy of the policy as it currently stands may be downloaded using the control at the top of this card.
API REPUBLIC LTD, 124 City Road, London, United Kingdom, EC1V 2NX
admin@apirepublic.co.uk