Get a random activityGet one thing to do, chosen at random: the answer to 'I'm bored'. Comes back with what it is, what kind of activity it is, how many people it takes, roughly what it costs, how long it lasts, whether it suits children and a link to get started where there is one. Narrow it with a type, a number of participants, kid friendly or a price ceiling and the pick is made from the activities that match.
Find activitiesBrowse the activities that match a type and a number of participants, narrowed further by kid friendly or a price ceiling, ordered how you like and cut to a limit. Use it to put a shortlist in front of someone rather than a single suggestion. The answer says how many matched in total, so a limited list never reads as a complete one.
Get an activityLook up one activity by its key: the identifier every other action returns beside each activity it finds. Use it to read a suggestion back later: store the key when you offer someone an activity, and fetch the details again when they say yes.
Find activities for a groupFind everything a group of a given size can do: the activities for exactly that many people and, unless you turn it off, the ones a smaller group could do together. The API matches a participant count exactly, so this is the action that answers 'there are four of us, what's on?' in one step. The answer breaks the matches down by how many people each one takes.
Find similar activitiesFind more activities like one you already have: give it an activity's key and it fetches that activity, then returns the others of the same type (and, unless you turn it off, for the same number of people. The original is never in the answer, so this is the 'something else, then' step to run when a suggestion doesn't land.
Suggest a mix of activitiesGet several ideas at once, deliberately spread across different kinds of activity, so a menu of three is a lesson, a game and something to cook rather than three variations of the same afternoon. Each type is drawn from at random, so the same request twice gives a different menu. Costs one request per type considered, at most seven.
List activity typesSee what the catalogue holds, type by type: how many activities there are of each kind, how many are free, how many suit children, the range of group sizes they take and an example with its key. Run it once to see what is worth filtering for before spending requests on the details. Costs seven requests, one per type.
