Introduction

Welcome to the Soundvia Distributor Portal API. Our infrastructure is designed to handle high-volume music ingestion for global distributors and record labels.

You can submit content using two primary methods:

Web UI: Manually upload DDEX ZIP archives or validate XML files.
REST API: Automate your supply chain by pushing content directly from your internal servers.

Authentication

All API requests must be authenticated using your unique API Key. You can find or regenerate your key in the portal settings.

Include the key in the Authorization header for every request:

Authorization: Bearer YOUR_API_KEY

Ingest DDEX ZIP

The most common way to deliver content. Submit a ZIP archive containing a DDEX ERN 3.8.2 XML file and all associated media (audio and covers).

POST /api/v1/distro/ingest/zip

Parameters

Field	Type	Description
`zip_file`	file	The DDEX ZIP archive.
`webhook_url`	string	(Optional) URL for status callbacks.

Ingest JSON

If you manage your own media storage (e.g. on AWS S3 or R2), you can submit a JSON payload containing direct URLs to your assets.

POST /api/v1/distro/ingest/json

Request Body

{
  "release_title": "Summer Hits 2026",
  "items": [
    {
      "type": "track",
      "data": {
        "title": "Neon Nights",
        "artist_name": "Digital Ghost",
        "audio_url": "https://cdn.example.com/audio/neon_nights.wav",
        "cover_art_url": "https://cdn.example.com/covers/album.jpg",
        "isrc": "US-RC1-26-00001"
      }
    }
  ]
}
            

Webhooks

Instead of polling our API for status updates, you can provide a webhook_url. We will POST a JSON update to your server when a job reaches a terminal state.

{
  "event": "upload.status_update",
  "upload_id": "job_8f29d...",
  "status": "completed",
  "sva_track_ids": ["track_id_1", "track_id_2"]
}
            

Need human help?

Contact our distribution support team at partners@soundvia.eu