7digital · Schema

Release

A 7digital release (album, single, EP, compilation).

MusicStreamingLicensingCatalogueB2BRoyalty ReportingPublic APIs

Properties

Name Type Description
id string 7digital release id.
title string Release title.
version string Release version (e.g. `Remastered`).
type string
artist object A 7digital artist.
url string
image string
releaseDate string
label string
explicit boolean
upc string Universal Product Code (UPC/EAN).
price object A price quoted in the requested territory's currency.
View JSON Schema on GitHub

JSON Schema

api-release-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/7digital/refs/heads/main/json-schema/api-release-schema.json",
  "title": "Release",
  "description": "A 7digital release (album, single, EP, compilation).",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "7digital release id.",
      "example": "11700062"
    },
    "title": {
      "type": "string",
      "description": "Release title.",
      "example": "Abbey Road"
    },
    "version": {
      "type": "string",
      "description": "Release version (e.g. `Remastered`).",
      "example": "Remastered"
    },
    "type": {
      "type": "string",
      "enum": [
        "album",
        "single",
        "ep",
        "compilation"
      ],
      "example": "album"
    },
    "artist": {
      "type": "object",
      "description": "A 7digital artist.",
      "properties": {
        "id": {
          "type": "string",
          "description": "7digital artist id.",
          "example": "12345"
        },
        "name": {
          "type": "string",
          "description": "Artist name.",
          "example": "The Beatles"
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "Artist page URL on 7digital.",
          "example": "https://uk.7digital.com/artist/the-beatles"
        },
        "image": {
          "type": "string",
          "format": "uri",
          "description": "Artist image URL.",
          "example": "https://artwork-cdn.7static.com/static/img/artistimages/00/000/012/0000001234_350.jpg"
        },
        "sortName": {
          "type": "string",
          "description": "Sort form of the artist name.",
          "example": "Beatles, The"
        },
        "appearsAs": {
          "type": "string",
          "description": "Alternative spellings under which the artist appears.",
          "example": "Beatles, The"
        }
      }
    },
    "url": {
      "type": "string",
      "format": "uri",
      "example": "https://uk.7digital.com/artist/the-beatles/release/abbey-road-11700062"
    },
    "image": {
      "type": "string",
      "format": "uri",
      "example": "https://artwork-cdn.7static.com/static/img/sleeveart/00/117/000/0011700062_350.jpg"
    },
    "releaseDate": {
      "type": "string",
      "format": "date",
      "example": "1969-09-26"
    },
    "label": {
      "type": "string",
      "example": "Apple Records"
    },
    "explicit": {
      "type": "boolean",
      "example": false
    },
    "upc": {
      "type": "string",
      "description": "Universal Product Code (UPC/EAN).",
      "example": "00602445912025"
    },
    "price": {
      "type": "object",
      "description": "A price quoted in the requested territory's currency.",
      "properties": {
        "formattedPrice": {
          "type": "string",
          "example": "\u00a39.99"
        },
        "amount": {
          "type": "number",
          "description": "Numeric price value.",
          "example": 9.99
        },
        "currency": {
          "type": "string",
          "description": "ISO 4217 currency code.",
          "example": "GBP"
        }
      }
    }
  }
}