Skip to content
imin imin Developer Docs

Activities and Collections

Activities

Activities can be found at the /events-api/v2/facets endpoint with JSONPath: $['imin:index'].activity['imin:item'] (see API Reference for more detail). They are instances of Concept, and form a hierarchy of activities. For example Bikram Yoga is a more specific activity of Yoga (which in itself is a more specific activity of Group Exercise - also an activity). This hierarchy is represented by the broaderTransitive property in the activity object (as seen below) and references the id of its parent activities. This allows for the activity list to be polyhierarchical.

Bikram Yoga

{
  "id": "https://openactive.io/activity-list#a7f3179d-1640-4621-96d7-92e620a5e3a8",
  "type": "Concept",
  "prefLabel": "Bikram Yoga",
  "inScheme": "https://openactive.io/activity-list",
  "broaderTransitive": [ "https://openactive.io/activity-list/#bf1a5e00-cdcf-465d-8c5a-6f57040b7f7e" ]
}

Yoga

{
  "id": "https://openactive.io/activity-list#bf1a5e00-cdcf-465d-8c5a-6f57040b7f7e",
  "type": "Concept",
  "prefLabel": "Yoga",
  "inScheme": "https://openactive.io/activity-list",
  "definition": "Yoga is an ancient form of exercise that focuses on strength, flexibility and breathing to boost physical and mental wellbeing.",
  "broaderTransitive": [ "https://openactive.io/activity-list#984068a7-5b7b-4989-bb33-f96953d8960c" ]
}

To return sessions part of specific activities, the query parameters activityId={id} or activityPrefLabel={prefLabel} can be used.

Activity Concept Collections

Activity Concept Collections are an unstructured collection of Activities. They can be found at /events-api/v2/facets endpoint with JSONPath: $['imin:index'].activityConceptCollection['imin:item'].

An example of an Activity Concept Collection would be Strength and Conditioning or Holistic. In order to see which Activities form part of a Collection, navigate to a collection’s ID (as can be found in the facets endpoint), which is a URL.

Strength and Conditioning

{
  "type": "imin:ConceptCollection",
  "id": "https://data.emduk.org/collections/cardio.jsonld",
  "prefLabel": "Cardio",
  "definition": "Group Exercise and Dance classes considered good for Cardio.",
  "beta:publisher": "EMD UK",
  "inScheme": "https://openactive.io/activity-list",
},

To return sessions part of specific collections, the query parameter activityConceptCollectionId={collectionId} can be used.