@id
and prefLabel
of at least one activity from the OpenActive Activity List must be included with each opportunity, along with an inScheme
of "https://openactive.io/activity-list"
, as shown below:@id
and @type
are used here and throughout the rest of the OpenActive documentation and tooling, the OpenActive Activity List JSON-LD definition itself still uses id
and type
for backwards compatibility."https://openactive.io/activity-list/activity-list.jsonld"
which does not require a specific Accept
header, and is cached via CDN.www
in the URL."https://openactive.io/activity-list"
using an Accept
header of application/ld+json
, to conform with JSON-LD expectations, however this shorter URL MUST NOT be used in production.@id
of an OpenActive Activity List Concept
against each opportunity in your database, as the prefLabel
and other properties are likely to change over time.prefLabel
alongside the @id
at the point of the associating an OpenActive Activity List Concept
with an opportunity, to remove the need to reference the activity list while outputting open data. It is the responsibility of the data user to use the latest prefLabel
when rendering the open data it receives.@id
simply find the relevant activity in the OpenActive Activity List, then scroll down to the bottom the page to view a full example JSON-LD snippet for that specific activity, such as the screenshot below. This can be included in your open data feed.id
prefLabel
altLabel
altLabel
be appended to the prefLabel
, using the separator " / "
. This logic does not apply to the prefLabel
included in the open data feed.topConceptOf
"https://openactive.io/activity-list"
.broader
narrower
topConceptOf
set to "https://openactive.io/activity-list"
, to produce an initial list of top-level Concepts.narrower
(child) Concept IDs.@id
to set the dropdown to an existing value.@id
and prefLabel
, which can then be stored in your database and later used within your open data feed(s).definition
that may be displayed to the user for disambiguation.https://openactive.io/activity-list/
". This will take the user to a page where they can make suggestions about the activity list.@id
. This will take the user to a page specific to the activity where they can make suggestions about the activity, including updating the definition of an activity.