Example Request & Response
Get Places
GET
https://places.imin.co/api/v1/places
Query Parameters
page
number
Which page of results to return
limit
number
How many results to return on each page
geo[radial]
string
Filters for Places within the radial circle Format: {latitude},{longitude},{radius} Radius is in km
placeClassification
string
Whether the Place is a park or a leisure centre
Allowed values are mcr:Park
and mcr:LeisureCentre
activityId
string
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
Headers
X-Api-Key
string
Authentication token
{
"@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": "[email protected]",
"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"
}
]
}
The optional activityId
parameter:
Must be an encoded URL;
Should not be confused with the
activityPreflabel
parameter used with the Events and Facilities APIs; andCannot be used more than once in a single API call.
This API documentation is in it's first iteration and will be replaced by a more comprehensive OAS3 specification at a later date.
The data in our Places API is not ever derived from the Events API.
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 aPlace
.mcr:placeClassification
: this field represents whether aPlace
is a park or a leisure centre. The allowed values arehttps://data.mcractive.com/ns#LeisureCentre
andhttps://data.mcractive.com/ns#Park
Last updated