Global JSON Objects

Artist object

• id: Artist unique id
• name: Artist readable string
• public: is there a webpage associated and publicly available ?
• role: How did the artist contributed to the track. Can be Primary, Featured...
• url: add this to the artist endpoint to find their page

Release object

• artistsTitle: unknown, doesn't return anything yet ??
• catalogId: Monstercat's readable release ID (MCEPxxx; MCSxxx etc...)
• downloadable
• genrePrimary / genreSecondary
• id: Internal unique ID
• inEarlyAccess
• releaseDate: ISO 8601 date/time (UTC-5) of release. Includes timezone.
• streamable
• title: Human readable string containing the release title
• type: Single, EP, LP...
• version: Unnused

Track object

• artists: numeric array containing artists linked to the track entry. Also contains the remixers, vocalists...
  • see Artist object
• artistsTitle: Human-readable artist field (String)
• bpm: Beats per minute (Integer)
• creatorFriendly: Is track allowed for licensing ? (boolean)
• debutDate: ISO 8601 date/time (UTC-5) of release. Timezone is after time, formatted like +/-hh:mm (%yyyy-%mm-%ddT%hh:%mm:%ss%+/-timezonehh:timezonemm)
• downloadable: Is track currently downloadable or in gold preview ? (boolean)
• duration: track length in seconds (integer)
• explicit: if the track contains swear words (boolean)
• genrePrimary / genreSecondary: Genre strings, genrePrimary is mostly Dance, while genreSecondary represents genres like DnB, Electro... (String)
• id: unique track identifier
• inEarlyAccess: is the track reserved to gold ?
• isrc: international release ID, ISO 3901.
• release: Object, which is the release that contains this track.
  • see Release object
• streamable: Can track be played through the API ?
• tags: numeric array containing strings which defines the track.
• tracknumber: Track numbering in the corresponding release
• version: can include remixes, VIP, Acoustic...

Playlist object

• deleted: is the playlist in deletion state ?
• createdAt: ISO 8601 datetime of creation without timezone and finished with Z
• _id: internal unique id
• public: is the playlist viewable by someone else than you ?
• myLibrary: unknown
• tracks: numeric array with release and track ids. Doesn't contain much, you can either grab release per release or use catalog browsing and providing a playlist ID.
  • releaseId / trackId: unique IDs
  • oldReleaseId / oldTrackId: IDs corresponding to API v1.
• name: Playlist name
• updatedAt: ISO 8601 datetime recording the latest playlist update
• userId: unique ID identifying the user that created the playlist

Error object

• message: simplified error message
• name: User readable error