Distributor API

Programmatically deliver releases and read catalog analytics. Base URL: /api/v1/distributor

Access Status

Loading…

API Reference

Authenticate distributor endpoints with X-API-Key: ndp_…. JWT endpoints use Authorization: Bearer <token>.

Create key (JWT) — include music:read / music:write for album delivery

curl -X POST {origin}/api/v1/distributor/keys \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Label delivery","permissions":["music:read","music:write","catalog:read","analytics:read"]}'

Music Distributor API — /api/v1/music-distributor (singles, EPs, albums + tracks)

curl -X POST {origin}/api/v1/music-distributor/releases \
  -H "X-API-Key: $NDP_KEY" -H "Content-Type: application/json" \
  -d '{"title":"Neon Nights","type":"ep","tracks":[{"title":"Midnight Drive","uploadId":"..."}]}'

curl {origin}/api/v1/music-distributor/releases -H "X-API-Key: $NDP_KEY"
curl {origin}/api/v1/music-distributor/analytics -H "X-API-Key: $NDP_KEY"

Single-asset API (legacy)

curl -X POST {origin}/api/v1/distributor/releases \
  -H "X-API-Key: $NDP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"MUSIC","title":"Midnight Drive","uploadId":"..."}'

Catalog & analytics

curl {origin}/api/v1/distributor/catalog -H "X-API-Key: $NDP_KEY"
curl {origin}/api/v1/distributor/analytics -H "X-API-Key: $NDP_KEY"