Rutter Atlas API
    • List destinations
      GET
    • List places
      GET
    • List events
      GET
    • Get place
      GET
    • Get event
      GET
    • Schemas
      • Meta
      • Pagination
      • Attribution
      • Address
      • PlaceLocation
      • Contact
      • PlaceEditorial
      • PlaceAccess
      • Sustainability
      • Provenance
      • Validity
      • Image
      • OpeningHoursRow
      • Place
      • EventClassification
      • EventLocation
      • EventOccurrence
      • EventEditorial
      • Event
      • Destination
      • ApiError

      List events

      GET
      /v1/destinations/{city}/events
      Returns all published events for a destination.
      Events include ODTA classification — kindOfEvent, theme, and
      attendanceMode — alongside occurrence scheduling and Rutter Atlas
      editorial metadata.
      Multi-date and recurring events appear as a single event record
      with multiple entries in the occurrences array.

      Request

      Authorization
      Bearer Token
      Provide your bearer token in the
      Authorization
      header when making requests to protected resources.
      Example:
      Authorization: Bearer ********************
      or
      Path Params

      Query Params

      Header Params

      Responses

      🟢200Success
      application/json
      List of published events for the destination.
      Bodyapplication/json

      🟠401Unauthorized
      🟠403Forbidden
      🔴500ServerError
      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location '/v1/destinations/strandvik/events?limit=undefined&after=undefined&kind=ChristmasMarket&theme=Maritime&is_free=undefined&attendance_mode=undefined&from=2026-06-01&to=2026-08-31&updated_after=undefined' \
      --header 'Authorization: Bearer <token>'
      Response Response Example
      200 - Success
      {
          "data": [
              {
                  "id": "evt_0a2c4b8baee34c6989b6855bc9607fcf",
                  "type": "event",
                  "name": "Strandvik Havsfestival",
                  "description": "The annual three-day maritime festival celebrating Strandvik fishing heritage.",
                  "status": "scheduled",
                  "portal_status": "published",
                  "classification": {
                      "event_type": "Event",
                      "event_subtype": "Festival",
                      "kind_of_event": "CityFestival",
                      "theme": [
                          "Maritime",
                          "Culture",
                          "Traditional",
                          "Food"
                      ],
                      "attendance_mode": "Offline"
                  },
                  "location": {
                      "place_id": null,
                      "address": null,
                      "postal_code": null,
                      "neighbourhood": null,
                      "region": null,
                      "city": "strandvik",
                      "country": "Sweden",
                      "country_code": "SE",
                      "latitude": null,
                      "longitude": null
                  },
                  "people": {
                      "organiser": "Strandvik Kultur och Fritid",
                      "host": null,
                      "performer": null,
                      "sponsor": null
                  },
                  "details": {
                      "is_free": false,
                      "price_range": "Free entry activities priced separately",
                      "ticket_url": null,
                      "donation_link": null,
                      "door_time": null,
                      "in_language": null,
                      "available_age": null,
                      "capacity": null,
                      "program_info": null,
                      "keywords": [
                          "maritime festival",
                          "historic boats",
                          "sea shanty",
                          "seafood",
                          "annual"
                      ]
                  },
                  "occurrences": [
                      {
                          "id": "ceb18aab-0557-48ba-851d-db3e429c15b8",
                          "start_at": "2026-07-03T10:00:00+00:00",
                          "end_at": "2026-07-05T22:00:00+00:00",
                          "status": "scheduled",
                          "recurrence_rule": null,
                          "notes": "Annual maritime festival"
                      }
                  ],
                  "hierarchy": {
                      "super_event_id": null,
                      "previous_start_date": null
                  },
                  "images": [],
                  "editorial": {
                      "description": null,
                      "endorsed": true,
                      "endorsed_at": null,
                      "source": "visit-strandvik"
                  },
                  "provenance": {
                      "same_as": null,
                      "sd_license": "https://creativecommons.org/licenses/by/4.0/",
                      "sd_publisher": {
                          "@type": "Organization",
                          "name": "Visit Strandvik",
                          "identifier": "visit-strandvik"
                      },
                      "sd_date_published": null,
                      "main_entity_of_page": null,
                      "source_verified_at": null,
                      "source_verification_method": null
                  },
                  "attribution": {
                      "text": "Curated by Visit Strandvik via Rutter Atlas",
                      "url": "https://rutteratlas.com",
                      "required": true
                  },
                  "updated_at": "2026-05-15T04:13:57.246646+00:00",
                  "metadata": {}
              }
          ],
          "meta": {
              "request_id": "f8327aef-b56f-4bbc-b14b-84a412d569f1",
              "api_version": "2026-04-01"
          },
          "pagination": {
              "has_more": false,
              "next_cursor": null
          }
      }
      Modified at 2026-05-21 09:11:47
      Previous
      List places
      Next
      Get place
      Built with