Distributor API

Use these endpoints to submit releases to Soundvia from your own delivery system.

Use ZIP ingest for DDEX ERN 3.8.2 packages.
Use JSON ingest when your media already has HTTPS URLs.
Use status endpoints or webhooks to track processing.

Authentication

Send your portal API key as a bearer token.

Authorization: Bearer YOUR_API_KEY

DDEX ZIP ingest

Submit a ZIP containing the ERN XML and referenced media files.

POSThttps://partners.soundvia.eu/api/v1/distro/ingest/zip

Fields

Field	Type	Notes
`zip_file`	file	Required ZIP archive.
`webhook_url`	string	Optional HTTPS callback URL.

Example

curl -X POST https://partners.soundvia.eu/api/v1/distro/ingest/zip \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "zip_file=@release.zip"

JSON ingest

Submit tracks and releases using HTTPS URLs for audio and artwork.

POSThttps://partners.soundvia.eu/api/v1/distro/ingest/json

Body

{
  "release_title": "Release title",
  "items": [
    {
      "type": "track",
      "data": {
        "distributor_track_id": "USABC2400001",
        "title": "Track title",
        "artist_name": "Artist name",
        "artist_handle": "artist-handle",
        "genre": "Electronic",
        "audio_url": "https://cdn.example.com/track.wav",
        "cover_art_url": "https://cdn.example.com/cover.jpg"
      }
    }
  ]
}

Status

Poll a submitted upload when you do not use webhooks.

GEThttps://partners.soundvia.eu/api/v1/distro/uploads/{upload_id}/status

Webhooks

Provide a webhook URL to receive a terminal status update.

{
  "event": "upload.status_update",
  "upload_id": "UPLOAD_ID",
  "status": "completed",
  "sva_track_ids": ["TRACK_ID"],
  "sva_release_ids": ["RELEASE_ID"]
}

Support

Email partners@soundvia.eu with the upload ID when reporting an ingest issue.