Skip to content
elasticStageDeveloper Portal

List releases for the connected creator

GET
/v1/releases
curl --request GET \
  --url 'https://api.staging.elasticstage.com/store/v1/releases?limit=25&currency=GBP&format=summary' \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
limit
integer
default: 25 >= 1 <= 100
cursor
string
currency
string
default: GBP
Allowed values: GBP USD EUR JPY
Example
GBP
search
string
format
string
default: summary
Allowed values: summary detailed

Responses

Section titled “Responses”

200

Section titled “200”

Default Response

Media typeapplication/json
object
data
required
Array
Any of:
object
id
required
string
name
required
string
artist_name
required
string
additional_artists
required
Array<string>
release_date
required
Any of:
string format: date
cover_image_url
Any of:
string format: uri
product_types
required
Array<string>
price_range
required
Any of:
object
currency
required
string
Allowed values: GBP USD EUR JPY
min
required
integer
<= 9007199254740991
max
required
integer
<= 9007199254740991
pagination
required
object
next_cursor
required
Any of:
string
has_more
required
boolean
Example
{
  "data": [
    {
      "id": "prod_4b8e2d",
      "name": "Cleopatra (Deluxe Edition)",
      "artist_name": "The Lumineers",
      "additional_artists": [
        "Gregory Alan Isakov"
      ],
      "release_date": "2026-03-20",
      "cover_image_url": "https://cdn.elasticstage.com/covers/prod_4b8e2d.jpg",
      "product_types": [
        "12\" Vinyl",
        "CD"
      ],
      "price_range": {
        "currency": "GBP",
        "min": 1299,
        "max": 2499
      }
    }
  ],
  "pagination": {
    "next_cursor": "eyJjIjoxNzE2ODA0ODAwMDAwLCJpZCI6InByb2RfNGI4ZTJkIn0",
    "has_more": true
  }
}

400

Section titled “400”

Default Response

Media typeapplication/json
object
statusCode
required
number
code
required
string
Allowed values: VALIDATION_ERROR UNAUTHORIZED FORBIDDEN NOT_FOUND CONFLICT UNPROCESSABLE_ENTITY RATE_LIMITED SERVICE_UNAVAILABLE INTERNAL_ERROR
error
required
string
message
required
string
details
Array
Example
{
  "statusCode": 400,
  "code": "VALIDATION_ERROR",
  "error": "Bad Request",
  "message": "Request validation failed.",
  "details": [
    {
      "field": "items",
      "reason": "must contain at least 1 item"
    }
  ]
}

401

Section titled “401”

Default Response

Media typeapplication/json
object
statusCode
required
number
code
required
string
Allowed values: VALIDATION_ERROR UNAUTHORIZED FORBIDDEN NOT_FOUND CONFLICT UNPROCESSABLE_ENTITY RATE_LIMITED SERVICE_UNAVAILABLE INTERNAL_ERROR
error
required
string
message
required
string
details
Array
Example
{
  "statusCode": 401,
  "code": "UNAUTHORIZED",
  "error": "Unauthorized",
  "message": "Authentication required."
}

403

Section titled “403”

Default Response

Media typeapplication/json
object
statusCode
required
number
code
required
string
Allowed values: VALIDATION_ERROR UNAUTHORIZED FORBIDDEN NOT_FOUND CONFLICT UNPROCESSABLE_ENTITY RATE_LIMITED SERVICE_UNAVAILABLE INTERNAL_ERROR
error
required
string
message
required
string
details
Array
Example
{
  "statusCode": 403,
  "code": "FORBIDDEN",
  "error": "Forbidden",
  "message": "Insufficient permissions."
}

429

Section titled “429”

Default Response

Media typeapplication/json
object
statusCode
required
number
code
required
string
Allowed values: VALIDATION_ERROR UNAUTHORIZED FORBIDDEN NOT_FOUND CONFLICT UNPROCESSABLE_ENTITY RATE_LIMITED SERVICE_UNAVAILABLE INTERNAL_ERROR
error
required
string
message
required
string
details
Array
Example
{
  "statusCode": 429,
  "code": "RATE_LIMITED",
  "error": "Too Many Requests",
  "message": "Rate limit exceeded."
}

500

Section titled “500”

Default Response

Media typeapplication/json
object
statusCode
required
number
code
required
string
Allowed values: VALIDATION_ERROR UNAUTHORIZED FORBIDDEN NOT_FOUND CONFLICT UNPROCESSABLE_ENTITY RATE_LIMITED SERVICE_UNAVAILABLE INTERNAL_ERROR
error
required
string
message
required
string
details
Array
Example
{
  "statusCode": 500,
  "code": "INTERNAL_ERROR",
  "error": "Internal Server Error",
  "message": "An unexpected error occurred."
}

503

Section titled “503”

Default Response

Media typeapplication/json
object
statusCode
required
number
code
required
string
Allowed values: VALIDATION_ERROR UNAUTHORIZED FORBIDDEN NOT_FOUND CONFLICT UNPROCESSABLE_ENTITY RATE_LIMITED SERVICE_UNAVAILABLE INTERNAL_ERROR
error
required
string
message
required
string
details
Array
Example
{
  "statusCode": 503,
  "code": "SERVICE_UNAVAILABLE",
  "error": "Service Unavailable",
  "message": "The service is temporarily unavailable."
}