Welcome to the Musical Medication API Guide!
If you're here, you must be considering using Musical Medications audio in your app or website, and that's great. We want to make it very easy and secure, for you to integrate our data and audio. This guide is intended to aid developers in connecting to our API services.
The Musical Medication API is a
RESTful service which provides methods for accessing specific resources at canonical URL. All representations are encoded as
Our APIs are accessed via a JWT Oauth 2 (details here)
To get started, your company will need an API username and password. Please contact firstname.lastname@example.org to get one to start testing our APIs.
If you want to play around with our APIs first,
click here to view our online API tester (Swagger page) )
The Musical Medication API’s base endpoint is
You can access three resource types using the API:
Categories: List of audio categories offered by Musical Medication. For example: Music, Nature Sounds, Tonal, or Spoken
Stations: List of audio stations available for a given Category. Think of these as Internet radio stations, that you display to your users. For example, Feel Good or Meditative
Songs: List of Songs, sounds or spoken content, for a given Station. The Song results provide the audio content name and a cloud MP3 URL, to play the audio.
Favorites: List of Favorited audio, for a given user. Set a song to be a Favorite.
All requests to the APIs must be authenticated using the methods outlined in the
request signing and authentication guidelines. Requests which fail authentication generally pass a 401 HTTP code and an error describing the reason for rejection.