/v2/occasion

GET

Parameter Options
id The occasion ID
id_list A comma separated list of Occasion IDs you wish to examine.

Usage

Without specifying an id parameter, you will receive a tree of JSON objects representing the hierarchy of Occasions:

  {
    "occasions" : [
      { "name": "Holidays",
        "id": 115,
        "children" : [
          { "name": "Minor Holidays",
            "id": 118,
            "children": []
          },
          { "name": "Major Holidays",
            "id": 116,
            "children": [
              { "name": "Jeff's Birthday",
                "id": 117,
                "children":[] 
              }
            ]
          }
        ]
      }
    ]
  }
  

Please note: the Occasion objects will only be nested three levels deep.

Getting Playlists

To get a list of playlists for an occasion, specify the ID of an occasion:

GET /v2/occasion?id=123

This will return a JSON structure as follows:

  {
    "occasion": 
      { "name": "Jeff's Birthday",
        "id": 120, 
        "children":[],
        "playlists": [
          {"id": 60,
           "title": "Amazing Post-Rock Birthday Blitz",
           "editorial": ... ,
           "image_url": ... ,
           "media_count": 21, 
           "occasion": "Jeff's Birthday"
          },
          {"id": 65,
           "title": "Slow and Depressing Dirges",
           "editorial": ... ,
           "image_url": ... ,
           "media_count": 4, 
           "occasion": "Jeff's Birthday"
          }
        ]
      }
    }
  

Once you have a playlist ID, you're welcome to query the playlist resource for the individual media and additional playlist metadata.

Try It!