Skip to main content
GET
Get Product
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

/product/ Description: The /product/{id} endpoint retrieves detailed information about a specific product identified by its unique ID. Authorization:
  • Required role: user or higher
Method: GET Path Parameter:

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

id
string
required

Product ID

Response

Success - Returns the product object directly

id
string

Unique product identifier

Example:

"prod_123456"

title
string

Product title

Example:

"Summer Vibes"

displayArtist
string

Display artist name

Example:

"John Doe feat. Jane Smith"

upc
string

Universal Product Code

Example:

"123456789012"

catalogNumber
string

Catalog number

Example:

"CAT-2024-001"

type
enum<string>
Available options:
Audio,
Video,
Ringtone
Example:

"Audio"

format
enum<string>

Product format (auto-determined by asset count)

Available options:
Single,
EP,
Album,
LP
Example:

"Single"

explicit
enum<string>
Available options:
explicit,
clean
Example:

"clean"

releaseDate
string<date>
Example:

"2024-06-15"

takedownDate
string<date> | null
Example:

null

mainGenre
string
Example:

"Pop"

subGenre
string
Example:

"Dance Pop"

status
string
Example:

"active"

version
string
Example:

"Deluxe Edition"

label
string

Record label (from artist defaults)

Example:

"Indie Records"

Copyright information (from artist defaults)

Example:

"2024 John Doe"

publisher
string

Publisher information (from artist defaults)

Example:

"Music Publishing Co."

media
object[]

Associated media files (artwork, etc.)

Artists
object[]

Associated artists (Sequelize include - capitalized)

Assets
object[]

Associated media assets with stats (Sequelize include - capitalized)

distribution
object

Distribution settings

contributors
object[]

Contributors list

metadata
object

Additional metadata

chartHistory
object[]

Historical chart positions

totalTracks
integer

Total number of tracks on the product

Example:

12

totalDiscs
integer

Total number of discs in the product

Example:

1

packageType
string

Physical/digital package type

Example:

"Digital Album"

edition
string

Edition designation

Example:

"Deluxe Edition"

reissue
boolean

Whether this product is a reissue

originalReleaseDate
string<date>

Original release date (for reissues)

recordingLocation
string

Recording studio/location

masteringLocation
string

Mastering studio/location

producer
string[]

Producer name(s)

engineer
string[]

Engineer name(s)

sequenceNumber
integer

Sequence number in a series

parentReleaseId
string<uuid>

Parent release ID for variants

language
string

Primary language code (ISO 639-1)

Example:

"en"

c_line_year
integer

Copyright line year (©)

Example:

2024

p_line_year
integer

Phonogram line year (℗)

Example:

2024

createdAt
string<date-time>

Creation timestamp

Example:

"2024-08-25T10:30:00Z"

updatedAt
string<date-time>

Last update timestamp

Example:

"2024-08-25T10:30:00Z"