Creator API

The Creator API exposes a creator’s earnings and catalogue. It backs creator dashboards and label tooling — surfacing sales and royalties, and managing releases and their audio.

• Base URL: https://api.staging.elasticstage.com/creator (staging)
• Auth: bearer JWT — see Authentication
• Version prefix: /api/v1

Note

Money is returned in integer minor units and resources are identified by UUIDs. See Errors & conventions.

What you can do

CreatorsList the creators visible to the caller (scoped to your organisation, or all if you're a global admin).

EarningsRead a creator's orders and their line items, plus sales (units + revenue) and royalty stats for a period.

ReleasesCreate and delete a creator's releases (editions).

TracksRegister an uploaded track to start audio processing, then poll its processing status and metadata.

Access model

The token’s claims decide what you see and can do:

• Global admin — any creator (label / platform tooling).
• Organisation-scoped — only creators belonging to your organisation.

The API applies this automatically; you never pass an org filter yourself.

The track-upload pipeline

Adding audio is a two-step, asynchronous flow:

1. Upload the master to storage, then register it with POST /api/v1/releases/{id}/track-upload — this starts audio processing (transcoding, preview generation).
2. Poll GET /api/v1/releases/{id}/tracks/{trackId} for the processing status and resulting metadata.

Earnings, precisely

Sales and royalty figures come back as integer minor units with a currency code. Sum and display them in your own layer — never divide by 100 blindly; format according to the returned currency.

Full Creator API reference →Every endpoint, parameter, schema and response — generated from the OpenAPI spec.