X1 API

Changelog

1.4.0

Highlights

  • Third-party ID search parameters where added in order to fully deprecate GET party by third-party ID endpoint since a single third-party ID can be shared by several Quansic parties.
  • Searching for an ISNI will also search for merged ISNIs.

Additions

  • amazonId, appleId, deezerId, discogsId, ipi, ipn, isni, musicBrainzId, spotifyId, wikidataId search query parameters (/api/v1/party? endpoint)

Removals

Fields

  • work.contributors[x].writerShare (was optional)
  • party.contributions[x].writerShare (was optional)

Deprecations

Endpoints

  • /api/v1/party/{identifier type}/{identifier value} use new search query parameters or GET party by Quansic lookup ID (/api/v1/party/:quansic_lookup_id) instead

1.3.0

Additions

Endpoints

  • /api/v1/party/{quansic lookup identifier}
  • /api/v1/party/{quansic lookup identifier}/recordings
  • /api/v1/party/{quansic lookup identifier}/releases

Fields

  • work.language
  • work.contributors[x].writerShare
  • work.undefinedContributors
  • party.nationalitySource
  • party.contributions[x].writerShare
  • recording.country
  • recording.musicBrainzId
  • recording.releaseDate
  • recording.genres
  • recording.subGenres
  • recording.crtcMaplStatus.isCanadianContent
  • recording.crtcMaplStatus.source
  • recording.crtcMaplStatus.classifications
  • release.discogsMasterId
  • release.subtitle

Enumeration values

  • Gender.NonBinary

Deprecations

Endpoints

  • /api/v1/party/{identifier type}/{identifier value}/releases
  • /api/v2/parties/{identifier type}/{identifier value}/recordings

Fields

  • recording.year

1.2.0

  • added a new nameType property to parties
  • added a new relationship type Aka
  • added appleId and spotifyId properties to recordings
  • added deezerIds property to parties
  • added deezer-id path parameter to retrieve parties

1.1.0

  • added a new relationship type IsMemberOf