UK Opening Hours API & Webhooks
Power your applications with real-time UK restaurant hours. Fetch live trading status, pull weekly timetables, or subscribe to webhooks to get notified the second a venue adjusts their schedule.
Base URL
https://www.findhours.co.uk/api/v1REST Endpoints
/api/v1/hoursReturns the opening schedule, live open/closed status, and community verifications for a brand.
| Parameter | Type | Required | Description |
|---|---|---|---|
| brand | string | Yes | Brand slug from FindHours URL (e.g. beefeater-hours) |
curl "https://www.findhours.co.uk/api/v1/hours?brand=beefeater-hours"{
"meta": {
"source": "FindHours.co.uk",
"docs": "https://findhours.co.uk/developers",
"rateLimit": { "limit": 100, "remaining": 99, "resetAt": "midnight UTC" }
},
"brand": {
"name": "Beefeater",
"slug": "beefeater",
"category": "Restaurants",
"pageUrl": "https://findhours.co.uk/restaurants/beefeater-hours/"
},
"status": {
"openNow": true,
"checkedAt": "2026-08-26T19:30:00.000Z",
"communityVerifications": 14,
"communityNote": "14 users confirmed this location open in the last hour"
},
"schedule": [
{ "day": "Monday", "opens": "12:00", "closes": "23:00" },
{ "day": "Tuesday", "opens": "12:00", "closes": "23:00" },
{ "day": "Wednesday", "opens": "12:00", "closes": "23:00" },
{ "day": "Thursday", "opens": "12:00", "closes": "23:00" },
{ "day": "Friday", "opens": "12:00", "closes": "23:00" },
{ "day": "Saturday", "opens": "12:00", "closes": "23:00" },
{ "day": "Sunday", "opens": "12:00", "closes": "22:30" }
]
}Hours-Change Webhooks
Instead of polling our API, register an HTTP webhook URL. We send a signed POST payload whenever a brand changes their opening hours, reports unexpected closures, or announces bank holiday trading.
/api/v1/webhooksRegister a new webhook subscription to receive hours-change alerts.
| Field | Type | Default | Description |
|---|---|---|---|
| url | string | Required | Your HTTPS endpoint URL to receive POST events |
| brandSlug | string | "all" | Specific brand slug (e.g. beefeater-hours) or "all" |
| events | string[] | ["hours.updated"] | hours.updated, status.anomaly, holiday.announced |
| string | optional | Optional developer email for failure alerts |
curl -X POST "https://www.findhours.co.uk/api/v1/webhooks" \
-H "Content-Type: application/json" \
-d '{
"url": "https://yourapp.com/api/webhooks/findhours",
"brandSlug": "beefeater-hours",
"events": ["hours.updated", "status.anomaly"]
}'{
"event": "hours.updated",
"id": "evt_984a8bc1290f",
"timestamp": "2026-08-26T20:00:00.000Z",
"brand": {
"name": "Beefeater",
"slug": "beefeater-hours",
"category": "Restaurants",
"url": "https://www.findhours.co.uk/restaurants/beefeater-hours/"
},
"change": {
"day": "Sunday",
"previousHours": { "opens": "12:00", "closes": "23:00" },
"newHours": { "opens": "12:00", "closes": "22:30" },
"effectiveDate": "2026-09-01",
"reason": "Autumn seasonal dining adjustment"
}
}Each webhook request includes an X-FindHours-Signature header. Verify it using your webhook secret:
// Node.js Express Example
const crypto = require('crypto');
app.post('/api/webhooks/findhours', (req, res) => {
const signature = req.headers['x-findhours-signature'];
const expected = crypto
.createHmac('sha256', process.env.FINDHOURS_WEBHOOK_SECRET)
.update(JSON.stringify(req.body))
.digest('hex');
if (signature !== expected) return res.status(401).send('Invalid signature');
const { event, brand, change } = req.body;
console.log(`Received ${event} for ${brand.name}`);
res.status(200).json({ received: true });
});Rate Limits
100 requests per IP address per day for REST endpoints. Webhooks deliver unlimited event notifications. Rate limit headers are returned on every REST response:
Need enterprise rate limits or custom ingestion? Contact editorial@findhours.co.uk
Error Codes
| Status | Meaning |
|---|---|
| 200 OK | Request successful |
| 201 Created | Webhook subscription successfully registered |
| 400 Bad Request | Missing parameter or invalid webhook URL |
| 404 Not Found | Brand not found. Check the slug against FindHours URLs. |
| 429 Too Many Requests | Rate limit exceeded. Resets at midnight UTC. |
What developers build with FindHours
Sync live restaurant operating hours and automatically disable ordering when venues close
Alexa / Siri / WhatsApp bots that answer 'Is McDonald's open right now?' in real time
Integrate hours data into regional tourism guides and city blogs
Trigger notifications or dashboard widgets for your favorite restaurants
Attribution
When using FindHours APIs or webhooks in a public-facing product, please credit FindHours.co.uk as the data source. A backlink is appreciated on the free tier.