Public feed

Upcoming events JSON feed

Use this curated feed when you want event listings on another site without exposing the underlying backend API. It is read-only, public, and designed for lightweight scraping or consumption by a CMS.

Request

GET /api/events/feed
Accept: application/json

Caching

  • Responses are cacheable for 5 minutes.
  • Stale content may be served for up to 24 hours while revalidating.
  • Consumers should refresh on a short schedule, not every page view.

Example response

{
  "feed": {
    "name": "Visit Moree Plains public events feed",
    "format": "json",
    "generatedAt": "2026-06-23T00:00:00.000Z",
    "count": 2,
    "refreshHintMinutes": 5,
    "source": "Visit Moree Plains"
  },
  "events": [
    {
      "id": "123",
      "title": "Sample Event",
      "teaser": "Short event summary.",
      "startDate": "2026-07-01",
      "endDate": "2026-07-01",
      "timeText": "10:00 am",
      "venueText": "Moree Town Hall",
      "categories": ["markets", "family"],
      "imageUrl": "https://media.example.com/sample.jpg?w=1200&h=630&fit=crop&fm=webp",
      "canonicalUrl": "https://visitmoreeplains.com.au/events/123",
      "lastUpdated": "2026-06-22T12:00:00.000Z"
    }
  ]
}

Field guidance

  • title and teaser are the display fields.
  • canonicalUrl must be used for full details and link-back.
  • categories are safe to use for filtering or badges.
  • imageUrl is optional and may be omitted when no public image exists.
  • lastUpdated is the most recent timestamp available for the event row.

Integration rule

This feed is intended to surface events on the council website while sending users back to Visit Moree Plains for the full event page, images, and booking details.

We can add an RSS wrapper later if MPSC needs XML, but JSON is the primary contract.

View feed endpoint