Authentication
The Audiory REST API uses OAuth 2.0 Bearer Tokens for authentication. All requests over HTTP must be served via SSL (https://). Pass your API key in the request headers:
HTTP Header Format
Required for all requests
Authorization: Bearer aud_live_89f1390ab2c47e8119020942ff
POST
/v2/releases
Initialize a new release draft and define track metadata, splits, and DSP target platforms.
curl -X POST https://api.audiory.site/v2/releases \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Neon Horizons",
"primary_artist": "Cyber Pulse",
"genre": "Synthwave",
"release_date": "2026-09-15",
"upc": "888123456789",
"dsps": ["spotify", "apple_music", "amazon", "tidal"]
}'Request Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | Yes | The official track or album title. |
| primary_artist | string | Yes | Main performing artist name. |
| release_date | string (ISO) | Yes | Target worldwide delivery date (YYYY-MM-DD). |
| upc | string | Optional | Custom barcode code. Auto-generated if omitted. |
GET
/v2/releases/{release_id}
Retrieve delivery status, store links, and assigned ISRC codes for a release.
200 OK Response Payload
application/json
{
"status": "success",
"data": {
"release_id": "rel_9941a20b",
"title": "Neon Horizons",
"delivery_status": "processing",
"isrc": "US-AUD-26-09142",
"upc": "888123456789",
"stores": {
"spotify": { "status": "delivered", "url": "https://open.spotify.com/album/..." },
"apple_music": { "status": "pending" }
}
}
}