InterSpace API Docs

API Key

A secret token issued to partners. Used for server-to-server administrative calls. Keep it on the server — never embed in client-side code.

Access Token (Bearer)

A short-lived token (issued via authentication) representing a user session. Sent in requests as Authorization: Bearer <token>.

partnerUserId

A partner-controlled identifier used for unprompted authentication. Map this to your internal user ID to support server-driven logins.

Prompted vs Unprompted Authentication

Prompted = user provides credentials. Unprompted = partner performs authentication server-side using partnerUserId (user is not asked for credentials).

Child Account / Tenant

An individual account created under a partner's parent tenant. Use one child account per partner user when following the recommended Child Account Model.

Enterprise

Synonym for an account/tenant. Often used in APIs to indicate the account context for releases, payments, and assets.

Release

A published collection of tracks (single, EP, album) with metadata such as title, release date, UPC, cover art, and associated label/artist.

Track

An individual audio asset belonging to a release. Tracks have metadata including title, ISRC, contributors, and format.

ISRC / UPC

ISRC — International Standard Recording Code (unique for recordings). UPC — Universal Product Code (barcode for releases). Validate formats before sending to the API.

DSP (Digital Service Provider)

A streaming or download platform (e.g., Spotify, Apple Music). Also referred to as a store or distributor target.

Payee & Contract

Payee — entity receiving payments. Contract — revenue split and payment rules applied to content. Default contract/payee are created on signup in many workflows.

Splits

The division of royalties between contributors. Represented as fractional shares summing to 1.0 for each track/release as required.

Delivery / Distribution

The process of sending release metadata and assets to DSPs. Delivery status and lead times may vary by DSP.

SmartLink

A short, shareable landing page that aggregates links to DSPs for a release (used for promotion and click tracking).

Webhook

A server-to-server callback (POST) that notifies your application about events (e.g., delivery.update, royalty.credited). Verify payloads using the HMAC secret.

HMAC Signature

A cryptographic signature included with webhooks to verify origin and integrity. Use your shared webhook secret and HMAC-SHA256 to validate payloads.

Sandbox

A dedicated test account/environment for safe API testing and ingestion. Request sandbox credentials from devs@interspacemusic.com.

Catalog

The collection of releases/tracks you manage. Catalog identifiers (catalogId) are used for internal reference and reporting.

Metadata

Descriptive data for releases/tracks (title, artist, contributors, genre, ISRC/UPC, language). Accurate metadata ensures correct DSP processing and royalty routing.

Royalties

Earnings generated by tracks/releases. Royalty flows are calculated according to delivery reports, contracts, and payee details.

Asset / CDN

Files (audio, cover art) are hosted on a CDN or storage service; the API references these assets by id or URL during ingestion/delivery.

Inspection Queue

A moderation/validation queue where releases may be reviewed before being accepted for delivery to DSPs (used in some partner workflows).

Rate Limits

APIs may enforce request rate limits. If you plan bulk ingestion, coordinate with InterSpace to avoid throttling or request higher limits.

Web Interface

The InterSpace Distribution web app — can be used in tandem with the API. Some API calls are issued by the web UI and can serve as working examples.

Upsert

A create-or-update operation. Useful for idempotent ingestion scripts that may re-send the same record safely.

Glossary

Glossary — core terms