Example Request & Response

Get Places

GET https://places.imin.co/api/v1/places

Headers

Name	Type	Required	Description
X-Api-Key	string	no	Authentication token

Query parameters

Name	Type	Required	Description
page	number	no	Which page of results to return
limit	number	no	How many results to return on each page
geo[radial]	string	no	Filters for Places within the radial circle\ Format: {latitude},{longitude},{radius}\ Radius is in km
placeClassification	string	no	Whether the Place is a park or a leisure centre\ Allowed values are mcr:Park and mcr:LeisureCentre
activityId	string	no	Whether the activity specified occurs at the Place\ Must be an encoded OpenActive Activity ID, e.g. https%3A%2F%2Fopenactive.io%2Factivity-list%23f2ea7405-6098-4378-b0fe-4e398a659fc4

Response 200 — Places successfully retrieved.

{
  "@context": [
    "https://openactive.io/",
    "https://schema.imin.co/",
    "https://openactive.io/ns-beta",
    "https://data.mcractive.com/ns/mcr.jsonld"
  ],
  "id": "https://places.imin.co/api/v1/places?geo%5Bradial%5D=52.5,-2.2,100&limit=50&activity=https%3A%2F%2Fopenactive.io%2Factivity-list%23fbdc35a8-3dd0-40ee-a7ca-6ff40b3e5f90",
  "type": "imin:RestrictedCollection",
  "imin:totalItems": 1,
  "view": {
    "id": "https://places.imin.co/api/v1/places?geo%5Bradial%5D=52.5%2C-2.2%2C100&activity=https%3A%2F%2Fopenactive.io%2Factivity-list%23fbdc35a8-3dd0-40ee-a7ca-6ff40b3e5f90&limit=50&page=1",
    "type": "PartialCollectionView",
    "first": "https://places.imin.co/api/v1/places?geo%5Bradial%5D=52.5%2C-2.2%2C100&activity=https%3A%2F%2Fopenactive.io%2Factivity-list%23fbdc35a8-3dd0-40ee-a7ca-6ff40b3e5f90&limit=50&page=1",
    "last": "https://places.imin.co/api/v1/places?geo%5Bradial%5D=52.5%2C-2.2%2C100&activity=https%3A%2F%2Fopenactive.io%2Factivity-list%23fbdc35a8-3dd0-40ee-a7ca-6ff40b3e5f90&limit=50&page=1",
    "imin:currentPage": 1,
    "imin:itemsPerPage": 50,
    "imin:totalPages": 1,
    "urlTemplate": "https://places.imin.co/api/v1/places?geo%5Bradial%5D=52.5%2C-2.2%2C100&activity=https%3A%2F%2Fopenactive.io%2Factivity-list%23fbdc35a8-3dd0-40ee-a7ca-6ff40b3e5f90&limit=50&page={page}"
  },
  "imin:item": [
    {
      "geo": {
        "type": "GeoCoordinates",
        "latitude": 53.3744067,
        "longitude": -2.2717618
      },
      "name": "woodhouse park lifestyle centre",
      "type": "Place",
      "image": [
        {
          "url": "https://www.kineticinsightpro.com/media/venues/thumb/1603199463-WCHG-178.jpg",
          "type": "ImageObject",
          "thumbnail": [
            {
              "url": "https://www.kineticinsightpro.com/media/venues/thumb/1603199463-WCHG-178.jpg",
              "type": "ImageObject"
            }
          ]
        }
      ],
  "address": {
    "type": "PostalAddress",
    "postalCode": "m221qw",
    "addressRegion": "Manchester",
    "streetAddress": "Woodhouse Park Lifestyle Centre",
    "addressCountry": "GB",
    "addressLocality": "Portway, Manchester"
  },
  "@context": [
    "https://openactive.io/",
    "https://openactive.io/ns-beta",
    "https://data.mcractive.com/ns/mcr.jsonld"
  ],
  "provider": {
    "id": "http://kinetic-insight.com/organizer/746",
    "url": "https://www.woodhouseparklifestylecentre.co.uk/",
    "name": "gll manchester",
    "type": "Organization",
    "email": "mcractive@better.org",
    "sameAs": [
      "https://www.facebook.com/WPLifestyleCent/",
      "https://twitter.com/wplifestylecent?lang=en"
    ],
    "telephone": "0161 641 9911"
  },
  "identifier": "http://opendata.kinetic-insight.com/api/feeds/places/00000000000000003140",
  "description": "Welcome to the Woodhouse Park Lifestyle Centre – a community centre in the heart of Wythenshawe.\r\n\r\nThe centre is open to all – seven days a week, with events and activities for all ages.\r\n\r\nIf you’re looking for things to do in Wythenshawe, drop in to see the great range of activities the centre has on offer. From sports and fitness to arts and computer classes, youth clubs to over 50s get-togethers and football pitch hire- there’s always lots going on.                                                                                          \r\nYou can also hire their event spaces for weddings, business conferences & events, community group use and children’s parties and celebrations. The Centre has full catering and bar facilities, so if you’re looking for a great value venue for your next event, take a look at our excellent facilities with competitive rates.\r\n\r\nWoodhouse Park Lifesyle Centre is managed by Wythenshawe Community Housing Group and is proud to bring together local communities, businesses and partners at the centre to provide opportunities for people from all age groups to socialise, learn, and stay healthy – read more about how they’re making a difference.\r\n\r\n\r\nDue to COVID-19 this facility is closed until further notice.  See https://www.mcractive.com/activity/covid-19 for more information.  \r\n",
  "amenityFeature": [
    {
      "name": "Café",
      "type": "ChangingFacilities",
      "value": true
    },
    {
      "name": "Car Parking",
      "type": "Parking",
      "value": true
    },
    {
      "name": "Single Sex Changing",
      "type": "ChangingFacilities",
      "value": true
    },
    {
      "name": "Toilets",
      "type": "Toilets",
      "value": true
    },
    {
      "name": "Vending",
      "type": "ChangingFacilities",
      "value": true
    },
    {
      "name": "disabled access",
      "type": "LocationFeatureSpecification",
      "value": true
    },
    {
      "name": "disabled changing",
      "type": "LocationFeatureSpecification",
      "value": true
    },
    {
      "name": "disabled parking",
      "type": "LocationFeatureSpecification",
      "value": true
    },
    {
      "name": "disabled toilets",
      "type": "LocationFeatureSpecification",
      "value": true
    }
  ],
  "beta:isAuthoritative": true,
  "mcr:placeClassification": [
    "https://data.mcractive.com/ns#LeisureCentre"
  ],
  "imin:distanceFromGeoQueryCenter": {
    "type": "QuantitativeValue",
    "value": 97.428,
    "unitCode": "KMT"
  },
  "id": "https://places.imin.co/api/v1/places/http%3A%2F%2Fopendata.kinetic-insight.com%2Fapi%2Ffeeds%2Fplaces%2F00000000000000003140",
  "imin:aggregatedActivity": [
    {
      "type": "Concept",
      "prefLabel": "Badminton",
      "id": "https://openactive.io/activity-list#c0360db0-a817-4bae-9167-40f89b49fc9e"
    },
    {
      "type": "Concept",
      "prefLabel": "Basketball",
      "id": "https://openactive.io/activity-list#e09776e6-f1b4-421b-b667-5c5913cf97aa"
    },
    {
      "type": "Concept",
      "prefLabel": "Netball",
      "id": "https://openactive.io/activity-list#fbdc35a8-3dd0-40ee-a7ca-6ff40b3e5f90"
    },
    {
      "type": "Concept",
      "prefLabel": "Wrestling",
      "id": "https://openactive.io/activity-list#88ba0d3d-ce9e-4ee7-a6e5-2f16c944bfac"
    },
    {
      "type": "Concept",
      "prefLabel": "Martial Arts",
      "id": "https://openactive.io/activity-list#2330f2d4-d0dc-4231-8dd9-07d37a452228"
    },
    {
      "type": "Concept",
      "prefLabel": "Group Exercise",
      "id": "https://openactive.io/activity-list#984068a7-5b7b-4989-bb33-f96953d8960c"
    },
    {
      "type": "Concept",
      "prefLabel": "Gym Workout",
      "id": "https://openactive.io/activity-list#08d9368c-6c6c-44a3-84ef-a42ed00d529a"
    },
    {
      "type": "Concept",
      "prefLabel": "Dance",
      "id": "https://openactive.io/activity-list#6ca15167-51da-4d91-a1ae-8a45dc47b0ea"
    },
    {
    "type": "Concept",
    "prefLabel": "Football",
    "id": "https://openactive.io/activity-list#0a5f732d-e806-4e51-ad40-0a7de0239c8c"
    }
  ]
}

Caution

The optional activityId parameter:

• Must be an encoded URL;
• Should not be confused with the activityPreflabel parameter used with the Events and Facilities APIs; and
• Cannot be used more than once in a single API call.

Danger

This API documentation is in it’s first iteration and will be replaced by a more comprehensive OAS3 specification at a later date.

Note

The data in our Places API is mainly derived from facilities RPDE feeds, but sometimes comes from dedicated places feeds. Therefore, whilst the Facilities API can be used in conjunction with the Places API to check available Slots, we cannot guarantee that there are any sessions associated with a Place in the Places API.

Danger

The data in our Places API is not ever derived from the Events API.

Tip

The items returned by the Places API will be ordered by distance from the search radius in ascending order.

Important fields from the response:

• imin:aggregatedActivityId: this is an aggregated field that represents all the activities that occur at a Place.
• mcr:placeClassification: this field represents whether a Place is a park or a leisure centre. The allowed values are https://data.mcractive.com/ns#LeisureCentreand https://data.mcractive.com/ns#Park