Verified UK opening times — 2026/27 season

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.

REST APIReal-Time WebhooksJSONCORS-enabledFree 100 req/dayHMAC Signed

Base URL

https://www.findhours.co.uk/api/v1

REST Endpoints

GET/api/v1/hours

Returns the opening schedule, live open/closed status, and community verifications for a brand.

Parameters
ParameterTypeRequiredDescription
brandstringYesBrand slug from FindHours URL (e.g. beefeater-hours)
Example Request
curl "https://www.findhours.co.uk/api/v1/hours?brand=beefeater-hours"
Example Response
{
  "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.

POST/api/v1/webhooks

Register a new webhook subscription to receive hours-change alerts.

Request Body (JSON)
FieldTypeDefaultDescription
urlstringRequiredYour HTTPS endpoint URL to receive POST events
brandSlugstring"all"Specific brand slug (e.g. beefeater-hours) or "all"
eventsstring[]["hours.updated"]hours.updated, status.anomaly, holiday.announced
emailstringoptionalOptional developer email for failure alerts
Example Subscription Request
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"]
  }'
Sample Webhook Event Payload (Sent to your URL)
{
  "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"
  }
}
Verifying Webhook Signatures (HMAC SHA-256)

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

Free Tier

100 requests per IP address per day for REST endpoints. Webhooks deliver unlimited event notifications. Rate limit headers are returned on every REST response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99

Need enterprise rate limits or custom ingestion? Contact editorial@findhours.co.uk

Error Codes

StatusMeaning
200 OKRequest successful
201 CreatedWebhook subscription successfully registered
400 Bad RequestMissing parameter or invalid webhook URL
404 Not FoundBrand not found. Check the slug against FindHours URLs.
429 Too Many RequestsRate limit exceeded. Resets at midnight UTC.

What developers build with FindHours

Delivery & Booking Apps

Sync live restaurant operating hours and automatically disable ordering when venues close

Voice Skills & Chatbots

Alexa / Siri / WhatsApp bots that answer 'Is McDonald's open right now?' in real time

Local Discovery Directories

Integrate hours data into regional tourism guides and city blogs

Smart Home & Automation

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.