Revelator Logo API
v1

Physical Releases

The Physical Releases API allows you to manage metadata for physical music and video products—vinyl records, CDs, cassettes, DVDs, Blu-rays, and more. Each release is tied to a specific configuration (e.g., “Vinyl Album” or “DVD Video”) that dictates the available metadata fields and required assets.

Physical releases are metadata-only: they do not support inventory, stock management, SKUs, manufacturing workflows, or physical distribution. They can optionally be linked to an existing digital release to create a unified, multi-format catalog record.

Cover artwork and additional media files must be uploaded using the Files API before they can be referenced here. Files uploaded via V1.0 API upload endpoints are not compatible with these endpoints.

Category-Specific Fields

Physical releases support two categories: audio and video. The category is determined by the selected physicalReleaseConfigurationId (see the Get Release Configuration endpoint).

You should only use category-specific fields when they match the configuration’s category:

CategoryApplicable Fields
audioaudioLanguageId, audioPresentationType
videovideoType, videoCountryId, videoSubtitledLanguageId, videoDubbedLanguageId, videoDubbedCountryId, videoReleaseYear, videoProductionCompanies

If a field does not apply to the selected category, leave it empty (null) or omit it from your payload.

UI Usage vs. API Usage

You can use these API endpoints to create and manage physical releases immediately without any configuration.

However, by default, the Physical Releases feature is hidden in the Revelator Web Interface. If you want your users to be able to view and edit physical releases in the UI, an organization admin must navigate to Settings → Client Features and toggle Physical Releases to ON.

Get Release Configuration

GET /catalog/v1/physical-releases/configurations

Retrieves the list of available physical configurations.

Responses

object
physicalReleaseConfigurationId integer
Unique identifier for the configuration. Pass this value as physicalReleaseConfigurationId when creating or updating a physical release.
displayName string
Display name of the configuration (e.g., "Vinyl Album", "CD Album", "DVD Audio").
category PhysicalReleaseConfigurationCategory
Category of the configuration. Determines which category-specific fields apply to the release — see the Category-Specific Fields table above.
Examples: audio, video
formatGroupName string
Physical format family the configuration belongs to (e.g., "Vinyl", "CD", "DVD").
GET /catalog/v1/physical-releases/configurations 
curl -X GET "https://platform.revelator.com/catalog/v1/physical-releases/configurations" -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Example response 200 
[
{
  "physicalReleaseConfigurationId": 2,
  "displayName": "Vinyl Album",
  "category": "audio",
  "formatGroupName": "Vinyl"
},
{
  "physicalReleaseConfigurationId": 21,
  "displayName": "CD Album",
  "category": "audio",
  "formatGroupName": "CD"
},
{
  "physicalReleaseConfigurationId": 31,
  "displayName": "DVD Audio",
  "category": "video",
  "formatGroupName": "DVD"
}
]

Create Physical Release

POST /catalog/v1/physical-releases

Creates a new physical release.

Request Body *

object
name * string
Name of the physical release.
version string
Version or subtitle for the release (e.g., "Deluxe Edition").
displayLabel string
Brand name shown on storefronts and packaging.
description string
Textual description of the release.
linerNotes string
The printed booklet or insert text included with this physical product (credits, lyrics, artwork notes, etc.).
assetId * integer
Asset ID of a track to include in the release.
assetType * AssetTypes
Asset type for each listed asset.
Example: Track
discNumber * integer
The physical disc or volume number on which the track appears. For standard single-disc releases, set this value to '1'.
explicit boolean
Marks whether the release content is explicit.
releaseDate * string (date-time)
The date this physical edition went on sale. Must be a past date; future release dates are not supported.
historicalReleaseDate string (date-time)
Historical first-release date across any format.
upc * string
UPC code for the physical release.
catalog string
Catalog number.
isPromotional boolean
Indicates whether this is a promotional release. A non-commercial copy intended for press or broadcast use only.
isBoxSet boolean
Indicates whether this release is a box set. Set automatically for box set configurations, but can be applied manually to bundled editions.
isIndieExclusive boolean
Indicates whether this is an indie exclusive (e.g., Record Store Day releases or boutique distributor exclusives).
copyrightP * string
Phonogram copyright notice (P line). Sound recording rights. Enter the year and the name of the rights holder for the master recording.
copyrightC string
Composition/artwork copyright notice (C line). Enter the year and the name of the rights holder for the visual and written content.
copyrightV string
Video copyright notice. The Vanity Line is sent to select partners alongside the Ⓟ and © lines for marketing credits.
audioPresentationType AudioPresentationType
The mastering or surround format of this release (e.g., Stereo, Mono, CD Master, Vinyl Master).
Examples: dolbySurround51, dolbySurround71, dtsSurround51, dtsSurround71, specializedMaster, cdMaster, vinylMaster, mono, stereo
videoType PhysicalReleaseVideoType
The category that best describes the content of this release.
Examples: featureFilm, musicVideoAlbum, concertOrLivePerformance, documentary, tvSpecial, shortFilm, interviewOrBehindTheScenes, compilationOrAnthology, visualAlbum, animationOrAnimatedFeature, educationalOrInstructional, promotionalOrMarketing
videoProductionCompanies string[]
List of video production company names.
videoReleaseYear integer
The year this film or video was originally completed or first released.
videoDubbedCountryId integer
Country ID for dubbed audio. Retrieved from GET /common/lookup/countries on the V1.0 API.
videoDubbedLanguageId integer
The language used for the dubbed audio track, if applicable. Retrieved from GET /common/lookup/languages on the V1.0 API.
videoSubtitledLanguageId integer
The primary language of on-screen subtitles included on this release. Retrieved from GET /common/lookup/languages on the V1.0 API.
videoCountryId integer
Country ID associated with the video. Retrieved from GET /common/lookup/countries on the V1.0 API.
audioLanguageId integer
The language of the spoken or sung content on this release. Retrieved from GET /common/lookup/languages on the V1.0 API.
labelId integer
Label ID for the release.
primaryMusicStyleId * integer
Primary music style ID. Retrieved from GET /common/lookup/musicstyles on the V1.0 API.
secondaryMusicStyleId integer
Secondary music style ID. Retrieved from GET /common/lookup/musicstyles on the V1.0 API.
artistId * integer
Primary artist ID.
metadataCountryId integer
Use the Country field to specify a regional variant (e.g., English US vs. English UK). Retrieved from GET /common/lookup/countries on the V1.0 API.
metadataLanguageId * integer
The language in which all titles, descriptions, and credits for this release are written. Retrieved from GET /common/lookup/languages on the V1.0 API.
coverArtworkFileId * string
File ID (GUID) of the cover artwork, generated by the Files API.
additionalMedia string[]
List of additional media file IDs (GUIDs).
physicalReleaseConfigurationId * integer
Physical release configuration ID (e.g., Vinyl, CD, DVD).
originalReleaseId integer
Original digital release ID linked to this physical release.

Responses

object
physicalReleaseId integer
Unique identifier for the physical release.
assetId integer
Universal asset ID for this physical release, used in archive, unarchive, and the asset-ID lookups.
name string
Name of the physical release.
version string | null
Version or subtitle for the release (e.g., "Deluxe Edition").
displayLabel string | null
Brand name shown on storefronts and packaging.
description string | null
Textual description of the release.
linerNotes string | null
The printed booklet or insert text included with this physical product (credits, lyrics, artwork notes, etc.).
assetId integer
Asset ID of a track to include in the release.
assetType AssetTypes
Asset type for each listed asset.
discNumber integer
The physical disc or volume number on which the track appears. For standard single-disc releases, set this value to '1'.
explicit boolean
Marks whether the release content is explicit.
releaseDate string (date-time)
The date this physical edition went on sale. Must be a past date; future release dates are not supported.
historicalReleaseDate string (date-time) | null
Historical first-release date across any format.
upc string
UPC code for the physical release.
catalog string | null
Catalog number.
isPromotional boolean
Indicates whether this is a promotional release. A non-commercial copy intended for press or broadcast use only.
isBoxSet boolean
Indicates whether this release is a box set. Set automatically for box set configurations, but can be applied manually to bundled editions.
isIndieExclusive boolean
Indicates whether this is an indie exclusive (e.g., Record Store Day releases or boutique distributor exclusives).
copyrightP string
Phonogram copyright notice (P line). Sound recording rights. Enter the year and the name of the rights holder for the master recording.
copyrightC string | null
Composition/artwork copyright notice (C line). Enter the year and the name of the rights holder for the visual and written content.
copyrightV string | null
Video copyright notice. The Vanity Line is sent to select partners alongside the Ⓟ and © lines for marketing credits.
audioPresentationType AudioPresentationType
The mastering or surround format of this release (e.g., Stereo, Mono, CD Master, Vinyl Master).
videoType PhysicalReleaseVideoType
The category that best describes the content of this release.
videoProductionCompanies string[] | null
List of video production company names.
videoReleaseYear integer | null
The year this film or video was originally completed or first released.
videoDubbedCountryId integer | null
Country ID for dubbed audio.
videoDubbedLanguageId integer | null
The language used for the dubbed audio track, if applicable.
videoSubtitledLanguageId integer | null
The primary language of on-screen subtitles included on this release.
videoCountryId integer | null
Country ID associated with the video.
audioLanguageId integer | null
The language of the spoken or sung content on this release.
labelId integer | null
Label ID for the release.
primaryMusicStyleId integer
Primary music style ID.
secondaryMusicStyleId integer | null
Secondary music style ID.
artistId integer
Primary artist ID.
metadataCountryId integer | null
Use the Country field to specify a regional variant (e.g., English US vs. English UK).
metadataLanguageId integer
The language in which all titles, descriptions, and credits for this release are written.
coverArtworkFileId string
File ID (GUID) of the cover artwork, generated by the Files API.
additionalMedia string[] | null
List of additional media file IDs (GUIDs).
physicalReleaseConfigurationId integer
Physical release configuration ID (e.g., Vinyl, CD, DVD).
originalReleaseId integer | null
Original digital release ID linked to this physical release.
tenantId integer
ID of the organization that owns this physical release.
enterpriseId integer
ID of the client that owns this physical release.
creationDate string (date-time)
UTC timestamp when the physical release was created.
lastUpdateDate string (date-time)
UTC timestamp of the most recent update. null if it has never been updated.
archivedAt string (date-time) | null
UTC timestamp when the physical release was archived. null if the release is active.
POST /catalog/v1/physical-releases 
curl -X POST "https://platform.revelator.com/catalog/v1/physical-releases" -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
  "name": "Midnight Tides",
  "version": "Deluxe",
  "displayLabel": "Midnight Tides (Deluxe)",
  "description": "Special gatefold vinyl edition.",
  "linerNotes": "Recorded in Berlin.",
  "assets": [
    {
      "assetId": 4419835,
      "assetType": "track",
      "discNumber": 1
    }
  ],
  "explicit": false,
  "releaseDate": "2026-02-14T00:00:00Z",
  "historicalReleaseDate": null,
  "upc": "843563172001",
  "catalog": "NR-2026-014",
  "isPromotional": false,
  "isBoxSet": false,
  "isIndieExclusive": true,
  "copyrightP": "2026 Northline Records",
  "copyrightC": "2026 Northline Records",
  "audioPresentationType": "vinylMaster",
  "videoType": null,
  "videoProductionCompanies": null,
  "videoReleaseYear": null,
  "videoDubbedCountryId": null,
  "videoDubbedLanguageId": null,
  "videoSubtitledLanguageId": null,
  "videoCountryId": null,
  "audioLanguageId": 1,
  "labelId": 120,
  "primaryMusicStyleId": 17,
  "secondaryMusicStyleId": null,
  "artistId": 4402,
  "metadataCountryId": 840,
  "metadataLanguageId": 1,
  "coverArtworkFileId": "f9af4e20-03b6-4f49-b7a8-a8d20ca8ddc2",
  "additionalMedia": [
    "0f55b5b4-ea85-46a0-b778-d4b1ded47e2f"
  ],
  "physicalReleaseConfigurationId": 2,
  "originalReleaseId": null
}'
Example response 200 
{
"physicalReleaseId": 9021,
"assetId": 5001201,
"name": "Midnight Tides",
"version": "Deluxe",
"displayLabel": "Midnight Tides (Deluxe)",
"description": "Special gatefold vinyl edition.",
"linerNotes": "Recorded in Berlin.",
"assets": [
  {
    "assetId": 4419835,
    "assetType": "track",
    "discNumber": 1
  }
],
"explicit": false,
"releaseDate": "2026-02-14T00:00:00Z",
"historicalReleaseDate": null,
"upc": "843563172001",
"catalog": "NR-2026-014",
"isPromotional": false,
"isBoxSet": false,
"isIndieExclusive": true,
"copyrightP": "2026 Northline Records",
"copyrightC": "2026 Northline Records",
"copyrightV": null,
"audioPresentationType": "vinylMaster",
"videoType": null,
"videoProductionCompanies": null,
"videoReleaseYear": null,
"videoDubbedCountryId": null,
"videoDubbedLanguageId": null,
"videoSubtitledLanguageId": null,
"videoCountryId": null,
"audioLanguageId": 1,
"labelId": 120,
"primaryMusicStyleId": 17,
"secondaryMusicStyleId": null,
"artistId": 4402,
"metadataCountryId": 840,
"metadataLanguageId": 1,
"coverArtworkFileId": "f9af4e20-03b6-4f49-b7a8-a8d20ca8ddc2",
"additionalMedia": [
  "0f55b5b4-ea85-46a0-b778-d4b1ded47e2f"
],
"physicalReleaseConfigurationId": 2,
"originalReleaseId": null,
"tenantId": 2001,
"enterpriseId": 3001,
"creationDate": "2026-01-10T12:03:43Z",
"lastUpdateDate": "2026-01-10T12:03:43Z",
"archivedAt": null
}

Get Physical Release

Also available by asset ID. GET /catalog/v1/assets/physical-releases/{assetId} returns this exact payload, keyed by the release’s assetId instead of its physicalReleaseId. See Understanding Assets & IDs.

GET /catalog/v1/physical-releases/{physicalReleaseId}

Retrieves a physical release by its ID.

Path Parameters

Parameter Description
physicalReleaseId * integer

The ID of the physical release.

Responses

object
physicalReleaseId integer
Unique identifier for the physical release.
assetId integer
Universal asset ID for this physical release, used in archive, unarchive, and the asset-ID lookups.
name string
Name of the physical release.
version string | null
Version or subtitle for the release (e.g., "Deluxe Edition").
displayLabel string | null
Brand name shown on storefronts and packaging.
description string | null
Textual description of the release.
linerNotes string | null
The printed booklet or insert text included with this physical product (credits, lyrics, artwork notes, etc.).
assetId integer
Asset ID of a track to include in the release.
assetType AssetTypes
Asset type for each listed asset.
discNumber integer
The physical disc or volume number on which the track appears. For standard single-disc releases, set this value to '1'.
explicit boolean
Marks whether the release content is explicit.
releaseDate string (date-time)
The date this physical edition went on sale. Must be a past date; future release dates are not supported.
historicalReleaseDate string (date-time) | null
Historical first-release date across any format.
upc string
UPC code for the physical release.
catalog string | null
Catalog number.
isPromotional boolean
Indicates whether this is a promotional release. A non-commercial copy intended for press or broadcast use only.
isBoxSet boolean
Indicates whether this release is a box set. Set automatically for box set configurations, but can be applied manually to bundled editions.
isIndieExclusive boolean
Indicates whether this is an indie exclusive (e.g., Record Store Day releases or boutique distributor exclusives).
copyrightP string
Phonogram copyright notice (P line). Sound recording rights. Enter the year and the name of the rights holder for the master recording.
copyrightC string | null
Composition/artwork copyright notice (C line). Enter the year and the name of the rights holder for the visual and written content.
copyrightV string | null
Video copyright notice. The Vanity Line is sent to select partners alongside the Ⓟ and © lines for marketing credits.
audioPresentationType AudioPresentationType
The mastering or surround format of this release (e.g., Stereo, Mono, CD Master, Vinyl Master).
videoType PhysicalReleaseVideoType
The category that best describes the content of this release.
videoProductionCompanies string[] | null
List of video production company names.
videoReleaseYear integer | null
The year this film or video was originally completed or first released.
videoDubbedCountryId integer | null
Country ID for dubbed audio.
videoDubbedLanguageId integer | null
The language used for the dubbed audio track, if applicable.
videoSubtitledLanguageId integer | null
The primary language of on-screen subtitles included on this release.
videoCountryId integer | null
Country ID associated with the video.
audioLanguageId integer | null
The language of the spoken or sung content on this release.
labelId integer | null
Label ID for the release.
primaryMusicStyleId integer
Primary music style ID.
secondaryMusicStyleId integer | null
Secondary music style ID.
artistId integer
Primary artist ID.
metadataCountryId integer | null
Use the Country field to specify a regional variant (e.g., English US vs. English UK).
metadataLanguageId integer
The language in which all titles, descriptions, and credits for this release are written.
coverArtworkFileId string
File ID (GUID) of the cover artwork, generated by the Files API.
additionalMedia string[] | null
List of additional media file IDs (GUIDs).
physicalReleaseConfigurationId integer
Physical release configuration ID (e.g., Vinyl, CD, DVD).
originalReleaseId integer | null
Original digital release ID linked to this physical release.
tenantId integer
ID of the organization that owns this physical release.
enterpriseId integer
ID of the client that owns this physical release.
creationDate string (date-time)
UTC timestamp when the physical release was created.
lastUpdateDate string (date-time)
UTC timestamp of the most recent update. null if it has never been updated.
archivedAt string (date-time) | null
UTC timestamp when the physical release was archived. null if the release is active.
GET /catalog/v1/physical-releases/{physicalReleaseId} 
curl -X GET "https://platform.revelator.com/catalog/v1/physical-releases/9021" -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Example response 200 
{
"physicalReleaseId": 9021,
"assetId": 5001201,
"name": "Midnight Tides",
"version": "Deluxe",
"displayLabel": "Midnight Tides (Deluxe)",
"description": "Special gatefold vinyl edition.",
"linerNotes": "Recorded in Berlin.",
"assets": [
  {
    "assetId": 4419835,
    "assetType": "track",
    "discNumber": 1
  }
],
"explicit": false,
"releaseDate": "2026-02-14T00:00:00Z",
"historicalReleaseDate": null,
"upc": "843563172001",
"catalog": "NR-2026-014",
"isPromotional": false,
"isBoxSet": false,
"isIndieExclusive": true,
"copyrightP": "2026 Northline Records",
"copyrightC": "2026 Northline Records",
"copyrightV": null,
"audioPresentationType": "vinylMaster",
"videoType": null,
"videoProductionCompanies": null,
"videoReleaseYear": null,
"videoDubbedCountryId": null,
"videoDubbedLanguageId": null,
"videoSubtitledLanguageId": null,
"videoCountryId": null,
"audioLanguageId": 1,
"labelId": 120,
"primaryMusicStyleId": 17,
"secondaryMusicStyleId": null,
"artistId": 4402,
"metadataCountryId": 840,
"metadataLanguageId": 1,
"coverArtworkFileId": "f9af4e20-03b6-4f49-b7a8-a8d20ca8ddc2",
"additionalMedia": [
  "0f55b5b4-ea85-46a0-b778-d4b1ded47e2f"
],
"physicalReleaseConfigurationId": 2,
"originalReleaseId": null,
"tenantId": 2001,
"enterpriseId": 3001,
"creationDate": "2026-01-10T12:03:43Z",
"lastUpdateDate": "2026-02-01T08:20:10Z",
"archivedAt": null
}

List Physical Releases

GET /catalog/v1/physical-releases

Returns a paginated list of physical releases based on filters and sorting options.

Query Parameters

Parameter Description
releaseDateFrom string (date-time)

Include releases with a release date on or after this UTC date-time.
releaseDateTo string (date-time)

Include releases with a release date on or before this UTC date-time.
creationDateFrom string (date-time)

Include releases created on or after this UTC date-time.
creationDateTo string (date-time)

Include releases created on or before this UTC date-time.
lastUpdateDateFrom string (date-time)

Include releases updated on or after this UTC date-time.
lastUpdateDateTo string (date-time)

Include releases updated on or before this UTC date-time.
archived boolean

Filter by archive state (true for archived, false for active).
archivedFrom string (date-time)

Include releases archived on or after this UTC date-time.
archivedTo string (date-time)

Include releases archived on or before this UTC date-time.
physicalReleaseConfigurationIds integer[]

Filter by one or more physical release configuration IDs.
primaryMusicStyleIds integer[]

Filter by one or more primary music style IDs. Retrieved from GET /common/lookup/musicstyles on the V1.0 API.
metadataLanguageIds integer[]

Filter by one or more metadata language IDs. Retrieved from GET /common/lookup/languages on the V1.0 API.
enterpriseIds integer[]

Filter by one or more client IDs.
originalReleaseIds integer[]

Filter by one or more original release IDs.
assetIds integer[]

Filter by the physical releases' own asset IDs—the assetId returned on each physical release. Use this when you hold a physical release asset ID and want that release back.
physicalReleaseIds integer[]

Filter by one or more physical release IDs.
artistIds integer[]

Filter by one or more primary artist IDs.
labelIds integer[]

Filter by one or more label IDs.
searchText string

Free-text search applied to supported physical release fields.
pageNumber integer

Page number for paginated results.
pageSize integer

Number of items per page.
orderByProperty string

Property name used for sorting.
orderByDescending boolean

Set to true for descending order, false for ascending.

Responses

object
pageNumber integer
The current page number in the paginated result set (1-indexed)
pageSize integer
The number of items per page in the paginated result set
totalItemsCount integer
The total number of items available across all pages
totalPagesCount number
The total number of pages available based on the page size
physicalReleaseId integer
Unique identifier for the physical release.
assetId integer
Universal asset ID for this physical release, used in archive, unarchive, and the asset-ID lookups.
name string | null
Name of the physical release.
version string | null
Version or subtitle for the release (e.g., "Deluxe Edition").
displayLabel string | null
Brand name shown on storefronts and packaging.
upc string | null
UPC code for the physical release.
releaseDate string (date-time)
The date this physical edition went on sale. Must be a past date; future release dates are not supported.
explicit boolean
Marks whether the release content is explicit.
originalReleaseId integer | null
Original digital release ID linked to this physical release.
artistId integer
Primary artist ID.
artistName string | null
Display name of the primary artist.
labelId integer | null
Label ID for the release.
labelName string | null
Name of the label.
physicalReleaseConfigurationId integer
Physical release configuration ID (e.g., Vinyl, CD, DVD).
physicalReleaseConfigurationCategory PhysicalReleaseConfigurationCategory
Category of the physical release configuration (e.g., Vinyl, CD, DVD).
physicalReleaseConfigurationName string
Name of the physical release configuration.
primaryMusicStyleId integer
Primary music style ID.
primaryMusicStyleName string | null
Primary music style name.
metadataLanguageId integer
The language in which all titles, descriptions, and credits for this release are written.
metadataLanguageName string | null
Language name of the release metadata.
coverArtworkFileId string | null
File ID (GUID) of the cover artwork, generated by the Files API.
tenantId integer
ID of the organization that owns this physical release.
enterpriseId integer
ID of the client that owns this physical release.
enterpriseName string
Name of the client.
creationDate string (date-time) | null
UTC timestamp when the physical release was created.
lastUpdateDate string (date-time) | null
UTC timestamp of the most recent update. null if it has never been updated.
archivedAt string (date-time) | null
UTC timestamp when the physical release was archived. null if the release is active.
GET /catalog/v1/physical-releases 
curl -X GET "https://platform.revelator.com/catalog/v1/physical-releases?pageNumber=1&pageSize=20&physicalReleaseConfigurationIds=39&orderByProperty=releaseDate&orderByDescending=true" -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Example response 200 
{
"pageNumber": 1,
"pageSize": 20,
"totalItemsCount": 1,
"totalPagesCount": 1,
"items": [
  {
          "physicalReleaseId": 54,
          "assetId": 4555261,
          "name": "Release name",
          "version": "Deluxe",
          "displayLabel": "Label",
          "upc": "4444444444444",
          "releaseDate": "2026-03-11T00:00:00Z",
          "explicit": false,
          "originalReleaseId": null,
          "artistId": 533791,
          "artistName": "Name",
          "labelId": 331730,
          "labelName": "Label",
          "physicalReleaseConfigurationId": 39,
          "physicalReleaseConfigurationCategory": "video",
          "physicalReleaseConfigurationName": "VHS",
          "primaryMusicStyleId": 41,
          "primaryMusicStyleName": "Hip Hop/Rap",
          "metadataLanguageId": 30,
          "metadataLanguageName": "Polish",
          "coverArtworkFileId": "beebbd22-c1b4-4a8c-84b8-5b4b9a25addd",
          "tenantId": 2001,
          "enterpriseId": 3001,
          "enterpriseName": "Client Name",
          "creationDate": "2026-03-17T11:53:26.027Z",
          "lastUpdateDate": "2026-03-17T11:53:26.027Z",
          "archivedAt": null
  }
]
}

List Physical Release Assets

Also available by asset ID. GET /catalog/v1/assets/physical-releases/{assetId}/assets returns this exact payload, keyed by the release’s assetId instead of its physicalReleaseId. See Understanding Assets & IDs.

GET /catalog/v1/physical-releases/{physicalReleaseId}/assets

Retrieves assets linked to a physical release ID.

Path Parameters

Parameter Description
physicalReleaseId * integer

The ID of the physical release.

Responses

object[]
assetId integer
Universal asset ID for this track or video.
assetType AssetTypes
Type of the asset.
discNumber integer | null
Disc number for multi-disc releases. null for single-disc releases.
trackId integer | null
Track entity ID. Use this when retrieving or updating track metadata. null for video assets.
videoId integer | null
Video entity ID. null for track assets.
name * string
Track or video title.
version string | null
Recording version subtitle (e.g., "Remix", "Acoustic").
artistId integer | null
Primary artist ID for this track or video.
artistName string | null
Primary artist display name.
creationDate string (date-time)
UTC timestamp when the track or video was created.
parentalAdvisory ParentalAdvisories
Advisory label for the track or video content.
Examples: notExplicit, clean, explicit
artistId integer
ID of the contributing artist.
roleId integer
Contributor role ID.
artistName string | null
Display name of the contributing artist.
type RecordingVersionType
Discriminates which of audio or video is populated for this recording version.
isrc string | null
ISRC code for this recording version.
recordingVersionType TrackRecordingVersionTypes
Type of audio recording.
Examples: stereo, dolbyAtmos
fileId string
File ID of the uploaded audio file.
format WellKnownFileFormat
Audio file format.
Examples: wav, flac, mp3
filename string | null
Name of the uploaded file, including the extension.
duration integer | null
Duration of the audio file, in seconds.
bitDepth integer | null
Bit depth of the audio file.
sampleRate integer | null
Sample rate of the audio file, in Hz.
bitrate integer | null
Bitrate of the audio file.
channels integer | null
Number of audio channels.
size integer | null
File size, in bytes.
isrc string | null
ISRC code for this recording version.
recordingVersionType VideoRecordingVersionTypes
Type of video recording.
Example: standard
fileId string
File ID of the uploaded video file.
format VideoFileFormats
Video file format.
Examples: mp4, mov
filename string | null
Name of the uploaded file, including the extension.
duration integer | null
Duration of the video file, in seconds.
bitDepth integer | null
Bit depth of the video file.
sampleRate integer | null
Sample rate of the video file, in Hz.
bitrate integer | null
Bitrate of the video file.
resolution string | null
Resolution of the video file (e.g., "1920x1080").
frameRate number
Frame rate of the video file, in frames per second.
size integer | null
File size, in bytes.
channels integer | null
Number of audio channels in the video file.
fileId string
File ID of the audio or video file that was scanned.
acrId string | null
ACRCloud's identifier for this scan. null until the scan completes.
status AcrCloudScanStatus
Scan status.
Examples: inProcessing, complete, error
creationDate string (date-time)
UTC timestamp when the scan record was created.
timestampUtc string (date-time) | null
UTC timestamp reported by ACRCloud for the scan result. null until the scan completes.
musicDetected integer | null
Amount of music detected by the scan.
duration integer | null
Duration analyzed by the scan, in seconds.
error string | null
Error message if the scan failed. null on success.
isrc string | null
ISRC reported by the scan for the matched recording. null if the scan produced no match.
scans object[] | null
Individual fingerprint scan passes run against the file.
coverSongs object[] | null
Cover-song matches detected by the scan.
derivativeWorks object[] | null
Derivative-work matches detected by the scan.
speechDetection object[] | null
Speech segments detected in the file.
aiDetection object[] | null
AI-generated-content detection results for the file.
imageId string | null
File ID of the asset's artwork image, for rendering the asset in a list or table.
GET /catalog/v1/physical-releases/{physicalReleaseId}/assets 
curl -X GET "https://platform.revelator.com/catalog/v1/physical-releases/9021/assets" -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Example response 200 
[
{
  "assetId": 4419835,
  "assetType": "track",
  "name": "Night Lights",
  "version": "Remastered",
  "artistId": 4402,
  "artistName": "Nova Days",
  "discNumber": 1,
  "trackId": 7701,
  "videoId": null,
  "parentalAdvisory": "notExplicit",
  "imageId": "f9af4e20-03b6-4f49-b7a8-a8d20ca8ddc2",
  "creationDate": "2026-01-10T12:03:43Z",
  "contributors": [],
  "recordingVersions": [
    {
      "type": "audio",
      "audio": {
        "isrc": "QZ8AB2600011",
        "recordingVersionType": "stereo",
        "files": [
          {
            "fileId": "d12fd57a-e739-44fd-9246-31f50d4ee5f6",
            "format": "wav",
            "filename": "night-lights.wav",
            "duration": 223,
            "bitDepth": 24,
            "sampleRate": 48000,
            "bitrate": null,
            "channels": 2,
            "size": 42102300
          }
        ]
      },
      "video": null
    }
  ]
}
]

Update Physical Release

PUT /catalog/v1/physical-releases/{physicalReleaseId}

Updates an existing physical release by its ID.

Path Parameters

Parameter Description
physicalReleaseId * integer

The ID of the physical release to update.

Request Body *

object
name * string
Name of the physical release.
version string
Version or subtitle for the release.
displayLabel string
Brand name shown on storefronts and packaging.
description string
Textual description.
linerNotes string
The printed booklet or insert text included with this physical product.
assetId integer
Asset ID of a track to include in the release.
assetType AssetTypes
Asset type for each listed asset.
discNumber integer
Disc number position for each asset in multi-disc releases.
explicit boolean
Marks whether release content is explicit.
releaseDate * string (date-time)
The date this physical edition went on sale. Must be a past date; future release dates are not supported.
historicalReleaseDate string (date-time)
Historical first-release date across any format.
upc * string
UPC code for the physical release.
catalog string
Catalog number.
isPromotional boolean
Indicates whether this is a promotional release.
isBoxSet boolean
Indicates whether this release is a box set.
isIndieExclusive boolean
Indicates whether this is marked as indie exclusive.
copyrightP * string
Phonogram copyright notice (P line). Sound recording rights. Enter the year and the name of the rights holder for the master recording.
copyrightC string
Composition/artwork copyright notice (C line). Enter the year and the name of the rights holder for the visual and written content.
copyrightV string
Video copyright notice. The Vanity Line is sent to select partners alongside the Ⓟ and © lines.
audioPresentationType AudioPresentationType
The mastering or surround format of this release.
Examples: dolbySurround51, dolbySurround71, dtsSurround51, dtsSurround71, specializedMaster, cdMaster, vinylMaster, mono, stereo
videoType PhysicalReleaseVideoType
The category that best describes the content of this release, e.g. Feature Film, Concert, Documentary.
Examples: featureFilm, musicVideoAlbum, concertOrLivePerformance, documentary, tvSpecial, shortFilm, interviewOrBehindTheScenes, compilationOrAnthology, visualAlbum, animationOrAnimatedFeature, educationalOrInstructional, promotionalOrMarketing
videoProductionCompanies string[]
List of video production company names.
videoReleaseYear integer
The year this film or video was originally completed or first released.
videoDubbedCountryId integer
Country ID for dubbed audio. Retrieved from GET /common/lookup/countries on the V1.0 API.
videoDubbedLanguageId integer
The language used for the dubbed audio track. Retrieved from GET /common/lookup/languages on the V1.0 API.
videoSubtitledLanguageId integer
The primary language of on-screen subtitles included on this release. Retrieved from GET /common/lookup/languages on the V1.0 API.
videoCountryId integer
Country ID associated with the video. Retrieved from GET /common/lookup/countries on the V1.0 API.
audioLanguageId integer
The language of the spoken or sung content on this release. Retrieved from GET /common/lookup/languages on the V1.0 API.
labelId integer
Label ID for the release.
primaryMusicStyleId * integer
Primary music style ID. Retrieved from GET /common/lookup/musicstyles on the V1.0 API.
secondaryMusicStyleId integer
Secondary music style ID. Retrieved from GET /common/lookup/musicstyles on the V1.0 API.
artistId * integer
Primary artist ID.
metadataCountryId integer
Use the Country field to specify a regional variant. Retrieved from GET /common/lookup/countries on the V1.0 API.
metadataLanguageId * integer
The language in which all titles, descriptions, and credits for this release are written. Retrieved from GET /common/lookup/languages on the V1.0 API.
coverArtworkFileId * string
File ID (GUID) of the cover artwork.
additionalMedia string[]
List of additional media file IDs (GUIDs).
physicalReleaseConfigurationId * integer
Physical release configuration ID (for example, Vinyl, CD, DVD).
originalReleaseId integer
Original release ID linked to this physical release.

Responses

object
physicalReleaseId integer
Unique identifier for the physical release.
assetId integer
Universal asset ID for this physical release, used in archive, unarchive, and the asset-ID lookups.
name string
Name of the physical release.
version string | null
Version or subtitle for the release (e.g., "Deluxe Edition").
displayLabel string | null
Brand name shown on storefronts and packaging.
description string | null
Textual description of the release.
linerNotes string | null
The printed booklet or insert text included with this physical product (credits, lyrics, artwork notes, etc.).
assetId integer
Asset ID of a track to include in the release.
assetType AssetTypes
Asset type for each listed asset.
discNumber integer
The physical disc or volume number on which the track appears. For standard single-disc releases, set this value to '1'.
explicit boolean
Marks whether the release content is explicit.
releaseDate string (date-time)
The date this physical edition went on sale. Must be a past date; future release dates are not supported.
historicalReleaseDate string (date-time) | null
Historical first-release date across any format.
upc string
UPC code for the physical release.
catalog string | null
Catalog number.
isPromotional boolean
Indicates whether this is a promotional release. A non-commercial copy intended for press or broadcast use only.
isBoxSet boolean
Indicates whether this release is a box set. Set automatically for box set configurations, but can be applied manually to bundled editions.
isIndieExclusive boolean
Indicates whether this is an indie exclusive (e.g., Record Store Day releases or boutique distributor exclusives).
copyrightP string
Phonogram copyright notice (P line). Sound recording rights. Enter the year and the name of the rights holder for the master recording.
copyrightC string | null
Composition/artwork copyright notice (C line). Enter the year and the name of the rights holder for the visual and written content.
copyrightV string | null
Video copyright notice. The Vanity Line is sent to select partners alongside the Ⓟ and © lines for marketing credits.
audioPresentationType AudioPresentationType
The mastering or surround format of this release (e.g., Stereo, Mono, CD Master, Vinyl Master).
videoType PhysicalReleaseVideoType
The category that best describes the content of this release.
videoProductionCompanies string[] | null
List of video production company names.
videoReleaseYear integer | null
The year this film or video was originally completed or first released.
videoDubbedCountryId integer | null
Country ID for dubbed audio.
videoDubbedLanguageId integer | null
The language used for the dubbed audio track, if applicable.
videoSubtitledLanguageId integer | null
The primary language of on-screen subtitles included on this release.
videoCountryId integer | null
Country ID associated with the video.
audioLanguageId integer | null
The language of the spoken or sung content on this release.
labelId integer | null
Label ID for the release.
primaryMusicStyleId integer
Primary music style ID.
secondaryMusicStyleId integer | null
Secondary music style ID.
artistId integer
Primary artist ID.
metadataCountryId integer | null
Use the Country field to specify a regional variant (e.g., English US vs. English UK).
metadataLanguageId integer
The language in which all titles, descriptions, and credits for this release are written.
coverArtworkFileId string
File ID (GUID) of the cover artwork, generated by the Files API.
additionalMedia string[] | null
List of additional media file IDs (GUIDs).
physicalReleaseConfigurationId integer
Physical release configuration ID (e.g., Vinyl, CD, DVD).
originalReleaseId integer | null
Original digital release ID linked to this physical release.
tenantId integer
ID of the organization that owns this physical release.
enterpriseId integer
ID of the client that owns this physical release.
creationDate string (date-time)
UTC timestamp when the physical release was created.
lastUpdateDate string (date-time)
UTC timestamp of the most recent update. null if it has never been updated.
archivedAt string (date-time) | null
UTC timestamp when the physical release was archived. null if the release is active.
PUT /catalog/v1/physical-releases/{physicalReleaseId} 
curl -X PUT "https://platform.revelator.com/catalog/v1/physical-releases/9021" -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
  "name": "Midnight Tides",
  "version": "Expanded Edition",
  "displayLabel": "Midnight Tides (Expanded)",
  "description": "Updated notes for second press.",
  "linerNotes": "Second pressing, remastered lacquers.",
  "assets": [
    {
      "assetId": 4419835,
      "assetType": "track",
      "discNumber": 1
    },
    {
      "assetId": 4419836,
      "assetType": "track",
      "discNumber": 1
    }
  ],
  "explicit": false,
  "releaseDate": "2026-02-14T00:00:00Z",
  "historicalReleaseDate": "2025-11-10T00:00:00Z",
  "upc": "843563172001",
  "catalog": "NR-2026-014B",
  "isPromotional": false,
  "isBoxSet": false,
  "isIndieExclusive": true,
  "copyrightP": "2026 Northline Records",
  "copyrightC": "2026 Northline Records",
  "audioPresentationType": "vinylMaster",
  "videoType": null,
  "videoProductionCompanies": null,
  "videoReleaseYear": null,
  "videoDubbedCountryId": null,
  "videoDubbedLanguageId": null,
  "videoSubtitledLanguageId": null,
  "videoCountryId": null,
  "audioLanguageId": 1,
  "labelId": 120,
  "primaryMusicStyleId": 17,
  "secondaryMusicStyleId": 22,
  "artistId": 4402,
  "metadataCountryId": 840,
  "metadataLanguageId": 1,
  "coverArtworkFileId": "f9af4e20-03b6-4f49-b7a8-a8d20ca8ddc2",
  "additionalMedia": [
    "0f55b5b4-ea85-46a0-b778-d4b1ded47e2f"
  ],
  "physicalReleaseConfigurationId": 2,
  "originalReleaseId": null
}'
Example response 200 
{
"physicalReleaseId": 9021,
"assetId": 5001201,
"name": "Midnight Tides",
"version": "Expanded Edition",
"displayLabel": "Midnight Tides (Expanded)",
"description": "Updated notes for second press.",
"linerNotes": "Second pressing, remastered lacquers.",
"assets": [
  {
    "assetId": 4419835,
    "assetType": "track",
    "discNumber": 1
  },
  {
    "assetId": 4419836,
    "assetType": "track",
    "discNumber": 1
  }
],
"explicit": false,
"releaseDate": "2026-02-14T00:00:00Z",
"historicalReleaseDate": "2025-11-10T00:00:00Z",
"upc": "843563172001",
"catalog": "NR-2026-014B",
"isPromotional": false,
"isBoxSet": false,
"isIndieExclusive": true,
"copyrightP": "2026 Northline Records",
"copyrightC": "2026 Northline Records",
"copyrightV": null,
"audioPresentationType": "vinylMaster",
"videoType": null,
"videoProductionCompanies": null,
"videoReleaseYear": null,
"videoDubbedCountryId": null,
"videoDubbedLanguageId": null,
"videoSubtitledLanguageId": null,
"videoCountryId": null,
"audioLanguageId": 1,
"labelId": 120,
"primaryMusicStyleId": 17,
"secondaryMusicStyleId": 22,
"artistId": 4402,
"metadataCountryId": 840,
"metadataLanguageId": 1,
"coverArtworkFileId": "f9af4e20-03b6-4f49-b7a8-a8d20ca8ddc2",
"additionalMedia": [
  "0f55b5b4-ea85-46a0-b778-d4b1ded47e2f"
],
"physicalReleaseConfigurationId": 2,
"originalReleaseId": null,
"tenantId": 2001,
"enterpriseId": 3001,
"creationDate": "2026-01-10T12:03:43Z",
"lastUpdateDate": "2026-02-05T10:11:00Z",
"archivedAt": null
}

Archive Physical Releases

POST /catalog/v1/physical-releases/archive

Archives physical releases in batch by asset IDs.

Request Body *

object
Batch archive request payload.
assetIds * integer[]
List of physical release asset IDs to archive.

Responses

object
id integer
The physical release asset ID from the request.
succeeded boolean
Whether the archive operation succeeded for this physical release.
code string
Machine-readable error code.
message string
Human-readable error message.
POST /catalog/v1/physical-releases/archive 
curl -X POST "https://platform.revelator.com/catalog/v1/physical-releases/archive" -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
  "assetIds": [5001201, 5001202]
}'
Example response 200 
{
"results": [
  {
    "id": 5001201,
    "succeeded": true,
    "errors": null
  },
  {
    "id": 5001202,
    "succeeded": true,
    "errors": null
  }
]
}

Unarchive Physical Releases

POST /catalog/v1/physical-releases/unarchive

Unarchives physical releases in batch by asset IDs.

Request Body *

object
Batch unarchive request payload.
assetIds * integer[]
List of physical release asset IDs to unarchive.

Responses

object
id integer
The physical release asset ID from the request.
succeeded boolean
Whether the unarchive operation succeeded for this physical release.
code string
Machine-readable error code.
message string
Human-readable error message.
POST /catalog/v1/physical-releases/unarchive 
curl -X POST "https://platform.revelator.com/catalog/v1/physical-releases/unarchive" -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{
  "assetIds": [5001201, 5001202]
}'
Example response 200 
{
"results": [
  {
    "id": 5001201,
    "succeeded": true,
    "errors": null
  },
  {
    "id": 5001202,
    "succeeded": true,
    "errors": null
  }
]
}