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
displayName string
category PhysicalReleaseConfigurationCategory
Allowed values: audio, video
formatGroupName string
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
assetId integer
name string
version string | null
displayLabel string | null
description string | null
linerNotes string | null
assetId integer
assetType AssetTypes
The type of the asset.
discNumber integer
explicit boolean
releaseDate string (date-time)
historicalReleaseDate string (date-time) | null
upc string
catalog string | null
isPromotional boolean
isBoxSet boolean
isIndieExclusive boolean
copyrightP string
copyrightC string | null
copyrightV string | null
audioPresentationType AudioPresentationType
Allowed values: dolbySurround51, dolbySurround71, dtsSurround51, dtsSurround71, specializedMaster, cdMaster, vinylMaster, mono, stereo
videoType PhysicalReleaseVideoType
Allowed values: featureFilm, musicVideoAlbum, concertOrLivePerformance, documentary, tvSpecial, shortFilm, interviewOrBehindTheScenes, compilationOrAnthology, visualAlbum, animationOrAnimatedFeature, educationalOrInstructional, promotionalOrMarketing
videoProductionCompanies string[] | null
videoReleaseYear integer | null
videoDubbedCountryId integer | null
videoDubbedLanguageId integer | null
videoSubtitledLanguageId integer | null
videoCountryId integer | null
audioLanguageId integer | null
labelId integer | null
primaryMusicStyleId integer
secondaryMusicStyleId integer | null
artistId integer
metadataCountryId integer | null
metadataLanguageId integer
coverArtworkFileId string
additionalMedia string[] | null
physicalReleaseConfigurationId integer
originalReleaseId integer | null
tenantId integer
enterpriseId integer
creationDate string (date-time)
lastUpdateDate string (date-time)
archivedAt string (date-time) | null
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.
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": 127038,
          "enterpriseId": 237602,
          "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.
explicit boolean | null
Whether the track or video contains explicit content.
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
recordingVersionType TrackRecordingVersionTypes
Allowed values: stereo, dolbyAtmos
fileId string
format WellKnownFileFormat
Allowed values: wav, flac, mp3
filename string | null
duration integer | null
bitDepth integer | null
sampleRate integer | null
bitrate integer | null
channels integer | null
size integer | null
isrc string | null
recordingVersionType VideoRecordingVersionTypes
Allowed values: standard
fileId string
format VideoFileFormats
Allowed values: mp4, mov
filename string | null
duration integer | null
bitDepth integer | null
sampleRate integer | null
bitrate integer | null
resolution string | null
frameRate number
size integer | null
channels integer | null
fileId string
acrId string | null
status AcrCloudScanStatus
Allowed values: inProcessing, complete, error
creationDate string (date-time)
timestampUtc string (date-time) | null
musicDetected integer | null
duration integer | null
error string | null
isrc string | null
scans object[] | null
coverSongs object[] | null
derivativeWorks object[] | null
speechDetection object[] | null
aiDetection object[] | null
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,
  "explicit": false,
  "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
assetId integer
name string
version string | null
displayLabel string | null
description string | null
linerNotes string | null
assetId integer
assetType AssetTypes
The type of the asset.
discNumber integer
explicit boolean
releaseDate string (date-time)
historicalReleaseDate string (date-time) | null
upc string
catalog string | null
isPromotional boolean
isBoxSet boolean
isIndieExclusive boolean
copyrightP string
copyrightC string | null
copyrightV string | null
audioPresentationType AudioPresentationType
Allowed values: dolbySurround51, dolbySurround71, dtsSurround51, dtsSurround71, specializedMaster, cdMaster, vinylMaster, mono, stereo
videoType PhysicalReleaseVideoType
Allowed values: featureFilm, musicVideoAlbum, concertOrLivePerformance, documentary, tvSpecial, shortFilm, interviewOrBehindTheScenes, compilationOrAnthology, visualAlbum, animationOrAnimatedFeature, educationalOrInstructional, promotionalOrMarketing
videoProductionCompanies string[] | null
videoReleaseYear integer | null
videoDubbedCountryId integer | null
videoDubbedLanguageId integer | null
videoSubtitledLanguageId integer | null
videoCountryId integer | null
audioLanguageId integer | null
labelId integer | null
primaryMusicStyleId integer
secondaryMusicStyleId integer | null
artistId integer
metadataCountryId integer | null
metadataLanguageId integer
coverArtworkFileId string
additionalMedia string[] | null
physicalReleaseConfigurationId integer
originalReleaseId integer | null
tenantId integer
enterpriseId integer
creationDate string (date-time)
lastUpdateDate string (date-time)
archivedAt string (date-time) | null
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
succeeded boolean
code string
message string
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
succeeded boolean
code string
message string
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
  }
]
}