Skip to main content
A delivery package is a ZIP file containing the DDEX ERN message and the audio files for one release. Upload it with distribution.files.post, then create the delivery with distribution.delivery.post.

Download the example package

A complete ERN 3.8.2 delivery with two tracks. All names and identifiers are fictional and the audio files are generated tones. Use it as a template, not as a real delivery.

Package structure

  • Format: ZIP archive (application/zip), up to 1 GB.
  • One release per ZIP, with exactly one ERN message.
  • The ERN XML goes inside the release folder, as in the tree above.

ERN version

Use ERN 3.8.2. Contact apisupport@musixmatch.com before delivering any other version.

Linking tracks to audio files

Each track is a SoundRecording in the ResourceList, and its audio file is linked through its FileName:
  • FileName must exactly match a file in the ZIP, including case and extension. File names must be unique within the ZIP.

Fields Musixmatch reads

Element paths are relative to the ERN message root (NewReleaseMessage). Musixmatch does not read any other element, but the message must still validate against the ERN 3.8.2 schema.

Audio files

Supported formats:
  • MP3
  • WAV
  • FLAC (native FLAC only, FLAC inside Ogg is not supported)
  • AIFF (AIFF-C is not supported)
Any other format, such as M4A/MP4, raw AAC, Ogg Vorbis, Opus or WMA, is not supported. Each audio file can be up to 100 MiB. There are no requirements on sample rate, bit depth or bitrate.