Skip to content
elasticStageDeveloper Portal

Get a release by ID

GET
/v1/releases/{id}
curl --request GET \
  --url 'https://api.staging.elasticstage.com/store/v1/releases/example?currency=GBP' \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Query Parameters

Section titled “Query Parameters”
currency
string
default: GBP
Allowed values: GBP USD EUR JPY
Example
GBP

Responses

Section titled “Responses”

200

Section titled “200”

Default Response

Media typeapplication/json
object
id
required
string
name
required
string
artist_name
required
string
additional_artists
required
Array<string>
release_date
required
Any of:
string format: date
description
Any of:
string
cover_image_url
Any of:
string format: uri
copyright
Any of:
string
status
required
string
Allowed values: available pending unavailable
created_at
required
string format: date-time
products
required
Array<object>
object
id
required
string
title
required
string
created_at
required
string format: date-time
status
required
string
Allowed values: available pending unavailable
track_listing
required
Array<object>
object
position
required
integer
>= 1 <= 9007199254740991
title
required
string
duration_seconds
Any of:
integer
<= 9007199254740991
side
Any of:
string
product_type
required
string
product_lead_time
required
integer
<= 9007199254740991
price
required
object
amount
required
integer
<= 9007199254740991
currency
required
string
Allowed values: GBP USD EUR JPY
weight_grams
Any of:
integer
<= 9007199254740991
barcode
Any of:
string
glb_model
Any of:
string format: uri
availability
required
object
limited_edition
required
boolean
quantity
Any of:
integer
<= 9007199254740991
Example
{
  "id": "prod_4b8e2d",
  "name": "Cleopatra (Deluxe Edition)",
  "artist_name": "The Lumineers",
  "additional_artists": [
    "Gregory Alan Isakov"
  ],
  "release_date": "2026-03-20",
  "description": "The deluxe reissue, collecting all formats of the record.",
  "cover_image_url": "https://cdn.elasticstage.com/covers/prod_4b8e2d.jpg",
  "copyright": "© 2026 Dualtone Records",
  "status": "available",
  "created_at": "2026-01-10T11:00:00.000Z",
  "products": [
    {
      "id": "LUM-ME-12-001",
      "title": "Midnight Echoes",
      "created_at": "2026-01-10T11:05:00.000Z",
      "status": "available",
      "track_listing": [
        {
          "position": 1,
          "title": "Midnight Echoes",
          "duration_seconds": 214,
          "side": "A"
        }
      ],
      "product_type": "12\" Vinyl",
      "product_lead_time": 10,
      "price": {
        "amount": 2499,
        "currency": "GBP"
      },
      "weight_grams": 230,
      "barcode": "0810074421393",
      "glb_model": "https://cdn.elasticstage.com/models/LUM-ME-12-001.glb",
      "availability": {
        "limited_edition": true,
        "quantity": 150
      }
    }
  ]
}

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."
}

404

Section titled “404”

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": 404,
  "code": "NOT_FOUND",
  "error": "Not Found",
  "message": "The requested resource was not found."
}

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."
}