MusicBrainz API/Examples

From MusicBrainz Wiki
Jump to navigationJump to search

Below you'll find examples of API requests, to get an idea of the data you'll get back and its formatting (both on XML and JSON). Some of the responses below have some fields omitted to keep the examples shorter (additional aliases, part of the release data); in the actual response the data will obviously be included.

Lookup requests

Area

Request: https://musicbrainz.org/ws/2/area/45f07934-675a-46d6-a577-6f8637a411b1?inc=aliases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <area id="45f07934-675a-46d6-a577-6f8637a411b1" type="City" type-id="6fd8f29a-3d0a-32fc-980d-ea697b69da78">
    <name>Pärnu</name>
    <sort-name>Pärnu</sort-name>
    <alias-list count="2">
      <alias locale="en" sort-name="Pärnu" type="Area name" type-id="0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29" primary="primary">Pärnu</alias>
      <alias locale="et" sort-name="Pärnu" type="Area name" type-id="0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29" primary="primary">Pärnu</alias>
    </alias-list>
  </area>
</metadata>
JSON Response
  {
    id: "45f07934-675a-46d6-a577-6f8637a411b1",
    name: "Pärnu",
    type-id: "6fd8f29a-3d0a-32fc-980d-ea697b69da78",
    type: "City",
    disambiguation: "",
    life-span: {
      begin: null,
      end: null,
      ended: false
    },
    aliases: [
      {
        name: "Pärnu",
        sort-name: "Pärnu",
        type-id: "0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29",
        type: "Area name",
        locale: "en",
        primary: true,
        begin: null,
        end: null,
        ended: false
      },
      {
        name: "Pärnu",
        sort-name: "Pärnu",
        type-id: "0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29",
        type: "Area name",
        locale: "et",
        primary: true,
        begin: null,
        end: null,
        ended: false
      }
    ]
  }

Artist

Request: http://musicbrainz.org/ws/2/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da?inc=aliases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <artist id="5b11f4ce-a62d-471e-81fc-a69a8278c7da" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
    <name>Nirvana</name>
    <sort-name>Nirvana</sort-name>
    <disambiguation>90s US grunge band</disambiguation>
    <isni-list>
      <isni>0000000123486830</isni>
      <isni>0000000123487390</isni>
    </isni-list>
    <country>US</country>
    <area id="489ce91b-6658-3307-9877-795b68554c98">
      <name>United States</name>
      <sort-name>United States</sort-name>
      <iso-3166-1-code-list>
        <iso-3166-1-code>US</iso-3166-1-code>
      </iso-3166-1-code-list>
    </area>
    <begin-area id="a640b45c-c173-49b1-8030-973603e895b5">
      <name>Aberdeen</name>
      <sort-name>Aberdeen</sort-name>
    </begin-area>
    <life-span>
      <begin>1988-01</begin>
      <end>1994-04-05</end>
      <ended>true</ended>
    </life-span>
    <alias-list count="2">
      <alias sort-name="Nirvana US">Nirvana US</alias>
      <alias locale="ja" sort-name="ニルヴァーナ" type="Artist name" type-id="894afba6-2816-3c24-8072-eadb66bd04bc" primary="primary">ニルヴァーナ</alias>
    </alias-list>
  </artist>
</metadata>
JSON Response
  {
    id: "5b11f4ce-a62d-471e-81fc-a69a8278c7da",
    name: "Nirvana",
    sort-name: "Nirvana",
    type-id: "e431f5f6-b5d2-343d-8b36-72607fffb74b",
    type: "Group",
    disambiguation: "90s US grunge band",
    gender: null,
    gender-id: null,
    country: "US",
    area: {
      disambiguation: "",
      id: "489ce91b-6658-3307-9877-795b68554c98",
      sort-name: "United States",
      name: "United States",
      iso-3166-1-codes: ["US"]
    },
    begin-area: {
      id: "a640b45c-c173-49b1-8030-973603e895b5",
      disambiguation: "",
      name: "Aberdeen",
      sort-name: "Aberdeen"
    },
    end-area: null,
    life-span: {
      ended: true,
      begin: "1988-01",
      end: "1994-04-05"
    },
    isnis: ["0000000123486830", "0000000123487390"],
    ipis: [ ],
    aliases: [
      {
        end: null,
        begin: null,
        sort-name: "Nirvana US",
        name: "Nirvana US",
        type-id: null,
        primary: null,
        locale: null,
        type: null,
        ended: false
      },
      {
        primary: true,
        type-id: "894afba6-2816-3c24-8072-eadb66bd04bc",
        name: "ニルヴァーナ",
        sort-name: "ニルヴァーナ",
        begin: null,
        end: null,
        ended: false,
        type: "Artist name",
        locale: "ja"
      }
    ]
  }

Event

For events, you'll generally want to include at least artist-rels (for performers) and place-rels (for location), as in the example below.

Request: https://musicbrainz.org/ws/2/event/fe39727a-3d21-4066-9345-3970cbd6cca4?inc=aliases+artist-rels+place-rels

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <event id="fe39727a-3d21-4066-9345-3970cbd6cca4" type="Concert" type-id="ef55e8d7-3d00-394a-8012-f5506a29ff0b">
    <name>Nine Inch Nails at Arena Riga</name>
    <life-span>
      <begin>2014-05-06</begin>
      <end>2014-05-06</end>
    </life-span>
    <time>19:00</time>
    <setlist>* Copy of A * 1,000,000 * Terrible Lie * March of the Pigs * Piggy * The Frail * The Wretched * The Becoming * Gave Up * Closer * Find My Way * Me, I'm Not * Came Back Haunted * The Great Destroyer * Eraser * Wish * Burn * The Hand That Feeds * Head Like a Hole # Encore * Hurt</setlist>
    <relation-list target-type="artist">
      <relation type="main performer" type-id="936c7c95-3156-3889-a062-8a0cd57f8946">
        <target>b7ffd2af-418f-4be2-bdd1-22f8b48613da</target>
        <direction>backward</direction>
        <artist id="b7ffd2af-418f-4be2-bdd1-22f8b48613da" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
          <name>Nine Inch Nails</name>
          <sort-name>Nine Inch Nails</sort-name>
        </artist>
      </relation>
      <relation type="support act" type-id="492a850e-97eb-306a-a85e-4b6d98527796">
        <target>f7f32d93-0801-45cb-9f5a-e68f640649f4</target>
        <direction>backward</direction>
        <artist id="f7f32d93-0801-45cb-9f5a-e68f640649f4" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
          <name>Cold Cave</name>
          <sort-name>Cold Cave</sort-name>
        </artist>
      </relation>
    </relation-list>
    <relation-list target-type="place">
      <relation type="held at" type-id="e2c6f697-07dc-38b1-be0b-83d740165532">
        <target>478558f9-a951-4067-ad91-e83f6ba63e74</target>
        <direction>forward</direction>
        <place id="478558f9-a951-4067-ad91-e83f6ba63e74" type="Indoor arena" type-id="a77c11f6-82fa-3cc0-9041-ac60e5f6e024">
          <name>Arēna Rīga</name>
          <address>Skanstes iela 21, Rīga, Latvia</address>
          <coordinates>
            <latitude>56.967989</latitude>
            <longitude>24.121403</longitude>
          </coordinates>
        </place>
      </relation>
    </relation-list>
  </event>
</metadata>

JSON Response
  {
    id: "fe39727a-3d21-4066-9345-3970cbd6cca4",
    name: "Nine Inch Nails at Arena Riga",
    disambiguation: "",
    type-id: "ef55e8d7-3d00-394a-8012-f5506a29ff0b",
    type: "Concert",
    life-span: {
      end: "2014-05-06",
      ended: true,
      begin: "2014-05-06"
    },
    time: "19: 00",
    cancelled: false,
    setlist: "* Copy of A * 1,000,000 * Terrible Lie * March of the Pigs * Piggy * The Frail * The Wretched * The Becoming * Gave Up * Closer * Find My Way * Me, I'm Not * Came Back Haunted * The Great Destroyer * Eraser * Wish * Burn * The Hand That Feeds * Head Like a Hole # Encore * Hurt",
    relations: [
      {
        type-id: "936c7c95-3156-3889-a062-8a0cd57f8946",
        type: "main performer",
        direction: "backward",
        target-type: "artist",
        artist: {
          id: "b7ffd2af-418f-4be2-bdd1-22f8b48613da",
          name: "Nine Inch Nails",
          sort-name: "Nine Inch Nails",
          disambiguation: ""
        },
        begin: null,
        end: null,
        ended: false,
        target-credit: "",
        source-credit: "",
        attributes: [ ],
        attribute-ids: { },
        attribute-values: { }
      },
      {
        type-id: "492a850e-97eb-306a-a85e-4b6d98527796",
        type: "support act",
        direction: "backward",
        target-type: "artist",
        artist: {
          id: "f7f32d93-0801-45cb-9f5a-e68f640649f4",
          name: "Cold Cave",
          sort-name: "Cold Cave",
          disambiguation: ""
        },
        begin: null,
        end: null,
        ended: false,
        target-credit: "",
        source-credit: "",
        attributes: [ ],
        attribute-ids: { },
        attribute-values: { }
      },
      {
        type-id: "e2c6f697-07dc-38b1-be0b-83d740165532",
        type: "held at",
        direction: "forward",
        target-type: "place",
        place: {
          id: "478558f9-a951-4067-ad91-e83f6ba63e74",
          name: "Arēna Rīga",
          address: "Skanstes iela 21, Rīga, Latvia",
          coordinates: {
            longitude: 24.121403,
            latitude: 56.967989
          },
          disambiguation: "",
          type-id: "a77c11f6-82fa-3cc0-9041-ac60e5f6e024",
          type: "Indoor arena",
          area: {
            id: "9c612199-d66f-4109-aedc-67ab26e0a43b",
            name: "Rīga",
            sort-name: "Rīga",
            disambiguation: "",
            iso-3166-2-codes: ["LV-RIX"]
          }
        },
        begin: null,
        end: null,
        ended: false,
        target-credit: "",
        source-credit: "",
        attributes: [ ],
        attribute-ids: { },
        attribute-values: { }
      }
    ],
    aliases: [ ]
  }

Genre

Request: http://musicbrainz.org/ws/2/genre/f66d7266-eb3d-4ef3-b4d8-b7cd992f918b

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <genre id="f66d7266-eb3d-4ef3-b4d8-b7cd992f918b">
    <name>crust punk</name>
  </genre>
</metadata>
JSON Response
  {
     id: "f66d7266-eb3d-4ef3-b4d8-b7cd992f918b"
     name: "crust punk",
     disambiguation: "",
  }

Instrument

Request: https://musicbrainz.org/ws/2/instrument/dd430e7f-36ba-49a5-825b-80a525e69190?inc=aliases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <instrument id="dd430e7f-36ba-49a5-825b-80a525e69190" type="Percussion instrument" type-id="68fa2525-4c23-3386-bb81-e84994342e9a">
    <name>kemanak</name>
    <disambiguation>Banana shaped bronze slit-drum used in javanese gamelan</disambiguation>
    <description>Bent into a ladle or banana like shape, it is a pair of bronze slit-drums hit with tabuh beaters.</description>
    <alias-list count="12">
      <alias locale="de" sort-name="Kemanak" type="Instrument name" type-id="2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd" primary="primary">Kemanak</alias>
      <alias sort-name="gumanak" type="Instrument name" type-id="2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd">gumanak</alias>
      <alias sort-name="kenawak" type="Instrument name" type-id="2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd">kenawak</alias>
    </alias-list>
  </instrument>
</metadata>
JSON Response
  {
    id: "dd430e7f-36ba-49a5-825b-80a525e69190",
    name: "kemanak",
    disambiguation: "Banana shaped bronze slit-drum used in javanese gamelan",
    description: "Bent into a ladle or banana like shape, it is a pair of bronze slit-drums hit with tabuh beaters.",
    type-id: "68fa2525-4c23-3386-bb81-e84994342e9a",
    type: "Percussion instrument",
    aliases: [
      {
        name: "gumanak",
        sort-name: "gumanak",
        type-id: "2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd",
        type: "Instrument name",
        locale: null,
        primary: null,
        begin: null,
        end: null,
        ended: false
      },
      {
        name: "kenawak",
        sort-name: "kenawak",
        type-id: "2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd",
        type: "Instrument name",
        locale: null,
        primary: null,
        begin: null,
        end: null,
        ended: false
      }
    ]
  }

Label

Request: http://musicbrainz.org/ws/2/label/46f0f4cd-8aab-4b33-b698-f459faf64190?inc=aliases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <label id="46f0f4cd-8aab-4b33-b698-f459faf64190" type="Original Production" type-id="7aaa37fe-2def-3476-b359-80245850062d">
    <name>Warp</name>
    <sort-name>Warp</sort-name>
    <disambiguation>UK independent label</disambiguation>
    <label-code>2070</label-code>
    <isni-list>
      <isni>0000000107280584</isni>
    </isni-list>
    <country>GB</country>
    <area id="8a754a16-0027-3a29-b6d7-2b40ea0481ed">
      <name>United Kingdom</name>
      <sort-name>United Kingdom</sort-name>
      <iso-3166-1-code-list>
        <iso-3166-1-code>GB</iso-3166-1-code>
      </iso-3166-1-code-list>
    </area>
    <life-span>
      <begin>1989</begin>
    </life-span>
    <alias-list count="1">
      <alias locale="en_GB" sort-name="Warp Records" type="Label name" type-id="3a1a0c48-d885-3b89-87b2-9e8a483c5675">Warp Records</alias>
    </alias-list>
  </label>
</metadata>
JSON Response
  {
    id: "46f0f4cd-8aab-4b33-b698-f459faf64190",
    name: "Warp",
    disambiguation: "UK independent label",
    type-id: "7aaa37fe-2def-3476-b359-80245850062d",
    type: "Original Production",
    label-code: 2070,
    life-span: {
      begin: "1989",
      end: null,
      ended: false
    },
    aliases: [
      {
        name: "Warp Records",
        sort-name: "Warp Records",
        type-id: "3a1a0c48-d885-3b89-87b2-9e8a483c5675",
        type: "Label name",
        locale: "en_GB",
        primary: false,
        begin: null,
        end: null,
        ended: false
      }
    ],
    country: "GB",
    area: {
      id: "8a754a16-0027-3a29-b6d7-2b40ea0481ed",
      name: "United Kingdom",
      sort-name: "United Kingdom",
      disambiguation: ""
      iso-3166-1-codes: ["GB"],
    },
    ipis: [ ],
    isnis: ["0000000107280584"]
  }

Place

Request: https://musicbrainz.org/ws/2/place/478558f9-a951-4067-ad91-e83f6ba63e74?inc=aliases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <place id="478558f9-a951-4067-ad91-e83f6ba63e74" type="Indoor arena" type-id="a77c11f6-82fa-3cc0-9041-ac60e5f6e024">
    <name>Arēna Rīga</name>
    <address>Skanstes iela 21, Rīga, Latvia</address>
    <coordinates>
      <latitude>56.967989</latitude>
      <longitude>24.121403</longitude>
    </coordinates>
    <area id="9c612199-d66f-4109-aedc-67ab26e0a43b">
      <name>Rīga</name>
      <sort-name>Rīga</sort-name>
      <iso-3166-2-code-list>
        <iso-3166-2-code>LV-RIX</iso-3166-2-code>
      </iso-3166-2-code-list>
    </area>
    <life-span>
      <begin>2006-02-15</begin>
    </life-span>
    <alias-list count="2">
      <alias locale="en" sort-name="Arena Riga" type="Place name" type-id="fb68f9a2-622c-319b-83b0-bbff4127cdc5" primary="primary">Arena Riga</alias>
      <alias locale="lv" sort-name="Arēna Rīga" type="Place name" type-id="fb68f9a2-622c-319b-83b0-bbff4127cdc5" primary="primary">Arēna Rīga</alias>
    </alias-list>
  </place>
</metadata>

JSON Response
  {
    id: "478558f9-a951-4067-ad91-e83f6ba63e74",
    name: "Arēna Rīga",
    disambiguation: "",
    type-id: "a77c11f6-82fa-3cc0-9041-ac60e5f6e024",
    type: "Indoor arena",
    address: "Skanstes iela 21, Rīga, Latvia",
    life-span: {
      begin: "2006-02-15",
      end: null,
      ended: false
    },
    coordinates: {
      longitude: 24.121403,
      latitude: 56.967989
    },
    aliases: [
      {
        name: "Arena Riga",
        sort-name: "Arena Riga",
        type-id: "fb68f9a2-622c-319b-83b0-bbff4127cdc5",
        type: "Place name",
        locale: "en",
        primary: true,
        begin: null,
        end: null,
        ended: false
      }
    ],
    area: {
      id: "9c612199-d66f-4109-aedc-67ab26e0a43b",
      name: "Rīga",
      sort-name: "Rīga",
      disambiguation: "",
      iso-3166-2-codes: ["LV-RIX"]
    },
  }

Recording

Request: https://musicbrainz.org/ws/2/recording/b9ad642e-b012-41c7-b72a-42cf4911f9ff?inc=artist-credits+isrcs+releases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <recording id="b9ad642e-b012-41c7-b72a-42cf4911f9ff">
    <title>LAST ANGEL</title>
    <length>230000</length>
    <artist-credit>
      <name-credit joinphrase=" feat. ">
        <artist id="455641ea-fff4-49f6-8fb4-49f961d8f1ac" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
          <name>倖田來未</name>
          <sort-name>Koda, Kumi</sort-name>
        </artist>
      </name-credit>
      <name-credit>
        <artist id="05cbaf37-6dc2-4f71-a0ce-d633447d90c3" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
          <name>東方神起</name>
          <sort-name>Tohoshinki</sort-name>
        </artist>
      </name-credit>
    </artist-credit>
    <release-list count="13">
      <release id="c33dee6a-e053-4272-84ad-dfeef3f48c8a">
        <title>LAST ANGEL</title>
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      </release>
      <release id="601a4558-e416-410b-a64c-857fc133b75c">
        <title>Kingdom</title>
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      </release>
    </release-list>
    <isrc-list count="1">
      <isrc id="JPB600760301"/>
    </isrc-list>
  </recording>
</metadata>
JSON Response
  {
    id: "b9ad642e-b012-41c7-b72a-42cf4911f9ff",
    title: "LAST ANGEL",
    artist-credit: [
      {
        name: "倖田來未",
        joinphrase: " feat. ",
        artist: {
          id: "455641ea-fff4-49f6-8fb4-49f961d8f1ac",
          name: "倖田來未",
          disambiguation: "",
          sort-name: "Koda, Kumi"
        }
      },
      {
        name: "東方神起",
        joinphrase: "",
        artist: {
          id: "05cbaf37-6dc2-4f71-a0ce-d633447d90c3",
          name: "東方神起",
          disambiguation: "",
          sort-name: "Tohoshinki"
        }
      }
    ],
    disambiguation: "",
    length: 230000,
    video: false,
    isrcs: ["JPB600760301"],
    releases: [
      {
        id: "c33dee6a-e053-4272-84ad-dfeef3f48c8a",
        title: "LAST ANGEL",
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      },
      {
        id: "601a4558-e416-410b-a64c-857fc133b75c",
        title: "Kingdom",
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      }
    ]
  }

Release

Request: http://musicbrainz.org/ws/2/release/59211ea4-ffd2-4ad9-9a4e-941d3148024a?inc=artist-credits+labels+discids+recordings

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
    <release id="59211ea4-ffd2-4ad9-9a4e-941d3148024a">
        <title>æ³o & h³æ</title>
        <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
        <quality>normal</quality>
        <text-representation>
            <language>eng</language>
            <script>Latn</script>
        </text-representation>
        <artist-credit>
            <name-credit joinphrase=" & ">
                <artist id="410c9baf-5469-44f6-9852-826524b80c61" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                    <name>Autechre</name>
                    <sort-name>Autechre</sort-name>
                    <disambiguation>English electronic music duo Rob Brown & Sean Booth</disambiguation>
                </artist>
            </name-credit>
            <name-credit>
                <artist id="146c01d0-d3a2-44c3-acb5-9208bce75e14" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                    <name>The Hafler Trio</name>
                    <sort-name>Hafler Trio, The</sort-name>
                </artist>
            </name-credit>
        </artist-credit>
        <date>2003-12-04</date>
        <country>GB</country>
        <release-event-list count="1">
            <release-event>
                <date>2003-12-04</date>
                <area id="8a754a16-0027-3a29-b6d7-2b40ea0481ed">
                    <name>United Kingdom</name>
                    <sort-name>United Kingdom</sort-name>
                    <iso-3166-1-code-list>
                        <iso-3166-1-code>GB</iso-3166-1-code>
                    </iso-3166-1-code-list>
                </area>
            </release-event>
        </release-event-list>
        <cover-art-archive>
            <artwork>true</artwork>
            <count>1</count>
            <front>true</front>
            <back>false</back>
        </cover-art-archive>
        <label-info-list count="1">
            <label-info>
                <catalog-number>pgram002</catalog-number>
                <label id="a0759efa-f583-49ea-9a8d-d5bbce55541c" type="Original Production" type-id="7aaa37fe-2def-3476-b359-80245850062d">
                    <name>Phonometrography</name>
                    <sort-name>Phonometrography</sort-name>
                </label>
            </label-info>
        </label-info-list>
        <medium-list count="2">
            <medium>
                <title>æ³o</title>
                <position>1</position>
                <format id="9712d52a-4509-3d4b-a1a2-67c88c643e31">CD</format>
                <disc-list count="1">
                    <disc id="nN2g3a0ZSjovyIgK3bJl6_.j8C4-">
                        <sectors>73241</sectors>
                        <offset-list count="1">
                            <offset position="1">150</offset>
                        </offset-list>
                    </disc>
                </disc-list>
                <track-list count="1" offset="0">
                    <track id="61af3e5a-14e0-350d-9826-a884c6e586b1">
                        <position>1</position>
                        <number>1</number>
                        <length>974546</length>
                        <recording id="af87f070-238b-46c1-aa3e-f831ab91fa20">
                            <title>æ³o</title>
                            <length>974546</length>
                            <artist-credit>
                                <name-credit joinphrase=" & ">
                                    <artist id="410c9baf-5469-44f6-9852-826524b80c61" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                                        <name>Autechre</name>
                                        <sort-name>Autechre</sort-name>
                                        <disambiguation>English electronic music duo Rob Brown & Sean Booth</disambiguation>
                                    </artist>
                                </name-credit>
                                <name-credit>
                                    <artist id="146c01d0-d3a2-44c3-acb5-9208bce75e14" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                                        <name>The Hafler Trio</name>
                                        <sort-name>Hafler Trio, The</sort-name>
                                    </artist>
                                </name-credit>
                            </artist-credit>
                        </recording>
                    </track>
                </track-list>
            </medium>
            <medium>
                <title>h³æ</title>
                <position>2</position>
                <format id="9712d52a-4509-3d4b-a1a2-67c88c643e31">CD</format>
                <disc-list count="1">
                    <disc id="aSHvkMnq2jZVFEK.DmSPbvN_f54-">
                        <sectors>69341</sectors>
                        <offset-list count="1">
                            <offset position="1">150</offset>
                        </offset-list>
                    </disc>
                </disc-list>
                <track-list count="1" offset="0">
                    <track id="5f2031a2-c67d-3bec-8ae5-8d22847ab0a5">
                        <position>1</position>
                        <number>1</number>
                        <length>922546</length>
                        <recording id="5aff6309-2e02-4a47-9233-32d7dcc9a960">
                            <title>h³æ</title>
                            <length>922546</length>
                            <artist-credit>
                                <name-credit joinphrase=" & ">
                                    <artist id="410c9baf-5469-44f6-9852-826524b80c61" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                                        <name>Autechre</name>
                                        <sort-name>Autechre</sort-name>
                                        <disambiguation>English electronic music duo Rob Brown & Sean Booth</disambiguation>
                                    </artist>
                                </name-credit>
                                <name-credit>
                                    <artist id="146c01d0-d3a2-44c3-acb5-9208bce75e14" type="Group" type-id="e431f5f6-b5d2-343d-8b36-72607fffb74b">
                                        <name>The Hafler Trio</name>
                                        <sort-name>Hafler Trio, The</sort-name>
                                    </artist>
                                </name-credit>
                            </artist-credit>
                        </recording>
                    </track>
                </track-list>
            </medium>
        </medium-list>
    </release>
</metadata>
JSON Response
  {
    id: "59211ea4-ffd2-4ad9-9a4e-941d3148024a",
    title: "æ³o & h³æ",
    disambiguation: "",
    artist-credit: [
      {
        name: "Autechre",
        joinphrase: " & ",
        artist: {
          id: "410c9baf-5469-44f6-9852-826524b80c61",
          name: "Autechre",
          sort-name: "Autechre",
          disambiguation: "English electronic music duo Rob Brown & Sean Booth"
        }
      },
      {
        name: "The Hafler Trio",
        joinphrase: "",
        artist: {
          id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
          name: "The Hafler Trio",
          sort-name: "Hafler Trio, The",
          disambiguation: ""
        }
      }
    ],
    date: "2003-12-04",
    country: "GB",
    release-events: [
      {
        date: "2003-12-04",
        area: {
          id: "8a754a16-0027-3a29-b6d7-2b40ea0481ed",
          name: "United Kingdom",
          sort-name: "United Kingdom",
          iso-3166-1-codes: ["GB"],
          disambiguation: ""
        }
      }
    ],
    label-info: [
      {
        catalog-number: "pgram002",
        label: {
          id: "a0759efa-f583-49ea-9a8d-d5bbce55541c",
          name: "Phonometrography",
          disambiguation: "",
          label-code: null
        }
      }
    ],
    barcode: null,
    packaging-id: null,
    packaging: null,
    status-id: "4e304316-386d-3409-af2e-78857eec5cfe",
    status: "Official",
    quality: "normal",
    text-representation: {
      language: "eng",
      script: "Latn"
    },
    asin: null,
    media: [
      {
        discs: [
          {
            id: "nN2g3a0ZSjovyIgK3bJl6_.j8C4-",
            sectors: 73241,
            offsets: [150],
            offset-count: 1
          }
        ],
        position: 1,
        title: "æ³o",
        format-id: "9712d52a-4509-3d4b-a1a2-67c88c643e31",
        format: "CD",
        track-count: 1,
        track-offset: 0,
        tracks: [
          {
            id: "61af3e5a-14e0-350d-9826-a884c6e586b1",
            title: "æ³o",
            length: 974546,
            number: "1",
            position: 1,
            artist-credit: [
              {
                name: "Autechre",
                joinphrase: " & ",
                artist: {
                  id: "410c9baf-5469-44f6-9852-826524b80c61",
                  name: "Autechre",
                  sort-name: "Autechre",
                  disambiguation: "English electronic music duo Rob Brown & Sean Booth"
                }
              },
              {
                name: "The Hafler Trio",
                joinphrase: "",
                artist: {
                  id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
                  name: "The Hafler Trio",
                  sort-name: "Hafler Trio, The",
                  disambiguation: ""
                }
              }
            ],
            recording: {
              id: "af87f070-238b-46c1-aa3e-f831ab91fa20",
              title: "æ³o",
              disambiguation: "",
              length: 974546,
              video: false,
              artist-credit: [
                {
                  name: "Autechre",
                  joinphrase: " & ",
                  artist: {
                    id: "410c9baf-5469-44f6-9852-826524b80c61",
                    name: "Autechre",
                    sort-name: "Autechre",
                    disambiguation: "English electronic music duo Rob Brown & Sean Booth"
                  }
                },
                {
                  name: "The Hafler Trio",
                  joinphrase: "",
                  artist: {
                    id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
                    name: "The Hafler Trio",
                    sort-name: "Hafler Trio, The",
                    disambiguation: ""
                  }
                }
              ]
            }
          }
        ]
      },
      {
        position: 2,
        title: "h³æ",
        format-id: "9712d52a-4509-3d4b-a1a2-67c88c643e31",
        format: "CD",
        track-count: 1,
        track-offset: 0,
        discs: [
          {
            id: "aSHvkMnq2jZVFEK.DmSPbvN_f54-",
            sectors: 69341,
            offsets: [150],
            offset-count: 1
          }
        ],
        tracks: [
          {
            id: "5f2031a2-c67d-3bec-8ae5-8d22847ab0a5",
            title: "h³æ",
            length: 922546,
            number: "1",
            position: 1,
            artist-credit: [
              {
                name: "Autechre",
                joinphrase: " & ",
                artist: {
                  id: "410c9baf-5469-44f6-9852-826524b80c61",
                  name: "Autechre",
                  sort-name: "Autechre",
                  disambiguation: "English electronic music duo Rob Brown & Sean Booth"
                }
              },
              {
                name: "The Hafler Trio",
                joinphrase: "",
                artist: {
                  id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
                  name: "The Hafler Trio",
                  sort-name: "Hafler Trio, The",
                  disambiguation: ""
                }
              }
            ],
            recording: {
              id: "5aff6309-2e02-4a47-9233-32d7dcc9a960",
              title: "h³æ",
              disambiguation: "",
              length: 922546,
              video: false,
              artist-credit: [
                {
                  name: "Autechre",
                  joinphrase: " & ",
                  artist: {
                    id: "410c9baf-5469-44f6-9852-826524b80c61",
                    name: "Autechre",
                    sort-name: "Autechre",
                    disambiguation: "English electronic music duo Rob Brown & Sean Booth"
                  }
                },
                {
                  name: "The Hafler Trio",
                  joinphrase: "",
                  artist: {
                    id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
                    name: "The Hafler Trio",
                    sort-name: "Hafler Trio, The",
                    disambiguation: ""
                  }
                }
              ]
            }
          }
        ]
      }
    ],
    cover-art-archive: {
      count: 1,
      artwork: true,
      front: true,
      back: false,
      darkened: false
    }
  }

Release Group

Request: http://musicbrainz.org/ws/2/release-group/c9fdb94c-4975-4ed6-a96f-ef6d80bb7738?inc=artist-credits+releases

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <release-group id="c9fdb94c-4975-4ed6-a96f-ef6d80bb7738" type="Album" type-id="f529b476-6e62-324f-b0aa-1f3e33d313fc">
    <title>The Lost Tape</title>
    <first-release-date>2012-05-22</first-release-date>
    <primary-type id="f529b476-6e62-324f-b0aa-1f3e33d313fc">Album</primary-type>
    <secondary-type-list>
      <secondary-type id="15c1b1f5-d893-3375-a1db-e180c5ae15ed">Mixtape/Street</secondary-type>
    </secondary-type-list>
    <artist-credit>
      <name-credit>
        <artist id="8e68819d-71be-4e7d-b41d-f1df81b01d3f" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
          <name>50 Cent</name>
          <sort-name>50 Cent</sort-name>
        </artist>
      </name-credit>
    </artist-credit>
    <release-list count="1">
      <release id="2ec84eb6-ab92-4ac3-9720-32ad84c34f11">
        <title>The Lost Tape</title>
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      </release>
    </release-list>
  </release-group>
</metadata>
JSON Response
 {
     id: "c9fdb94c-4975-4ed6-a96f-ef6d80bb7738",
     title: "The Lost Tape",
     first-release-date: "2012-05-22",
     artist-credit: [
         "name": "50 Cent",
         "joinphrase": "",
         "artist": {
             "id": "8e68819d-71be-4e7d-b41d-f1df81b01d3f",
             "name": "50 Cent",
             "sort-name": "50 Cent",
             "disambiguation": ""
         }
     ],
     disambiguation: null,
     primary-type-id: "f529b476-6e62-324f-b0aa-1f3e33d313fc",
     primary-type: "Album",
     secondary-type-ids: ["15c1b1f5-d893-3375-a1db-e180c5ae15ed"]
     secondary-types: [ "Mixtape/Street" ],
     releases: [
         {
             "id": "2ec84eb6-ab92-4ac3-9720-32ad84c34f11",
             "title": "The Lost Tape",
             /* some properties omitted to keep this example shorter, see the release results for the full format */
         }
     ]
  }

URL

Request: https://musicbrainz.org/ws/2/url/46d8f693-52e4-4d03-936f-7ca8459019a7

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <url id="46d8f693-52e4-4d03-936f-7ca8459019a7">
    <resource>https://www.arvopart.ee/</resource>
  </url>
</metadata>
JSON Response
  {
    id: "46d8f693-52e4-4d03-936f-7ca8459019a7",
    resource: "https://www.arvopart.ee/"
  }

Work

For works, you'll generally want to include at least artist-rels (for writers), as in the example below.

Request: http://musicbrainz.org/ws/2/work/b1df2cf3-69a9-3bc0-be44-f71e79b27a22?inc=artist-rels

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <work id="b1df2cf3-69a9-3bc0-be44-f71e79b27a22" type="Song" type-id="f061270a-2fd6-32f1-a641-f0f8676d14e6">
    <title>HELLO! また会おうね</title>
    <language>jpn</language>
    <language-list>
      <language>jpn</language>
    </language-list>
    <iswc>T-101.690.320-9</iswc>
    <iswc-list>
      <iswc>T-101.690.320-9</iswc>
    </iswc-list>
    <attribute-list>
      <attribute type="JASRAC ID" type-id="31048fcc-3dbb-3979-8f85-805afb933e0c">089-5005-9</attribute>
    </attribute-list>
    <relation-list target-type="artist">
      <relation type="composer" type-id="d59d99ea-23d4-4a80-b066-edca32ee158f">
        <target>d997d399-355e-4c49-9c7b-75a93d76bc0e</target>
        <direction>backward</direction>
        <artist id="d997d399-355e-4c49-9c7b-75a93d76bc0e" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
          <name>つんく♂</name>
          <sort-name>Tsunku</sort-name>
        </artist>
      </relation>
      <relation type="lyricist" type-id="3e48faba-ec01-47fd-8e89-30e81161661c">
        <target>d997d399-355e-4c49-9c7b-75a93d76bc0e</target>
        <direction>backward</direction>
        <artist id="d997d399-355e-4c49-9c7b-75a93d76bc0e" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
          <name>つんく♂</name>
          <sort-name>Tsunku</sort-name>
        </artist>
      </relation>
    </relation-list>
  </work>
</metadata>

JSON Response
  {
    id: "b1df2cf3-69a9-3bc0-be44-f71e79b27a22",
    title: "HELLO! また会おうね",
    type-id: "f061270a-2fd6-32f1-a641-f0f8676d14e6"
    type: "Song",
    disambiguation: "",
    iswcs: ["T-101.690.320-9"],
    languages: ["jpn"],
    attributes: [
      {
        type-id: "31048fcc-3dbb-3979-8f85-805afb933e0c",
        type: "JASRAC ID",
        value: "089-5005-9"
      }
    ],
    relations: [
      {
        type-id: "d59d99ea-23d4-4a80-b066-edca32ee158f",
        type: "composer",
        direction: "backward",
        target-type: "artist",
        artist: {
          id: "d997d399-355e-4c49-9c7b-75a93d76bc0e",
          name: "つんく♂",
          sort-name: "Tsunku",
          disambiguation: ""
        },
        source-credit: "",
        target-credit: "",
        attributes: [ ],
        attribute-ids: { },
        attribute-values: { },
        begin: null,
        end: null,
        ended: false
      },
        type-id: "3e48faba-ec01-47fd-8e89-30e81161661c",
        type: "lyricist",
        direction: "backward",
        target-type: "artist",
        artist: {
          id: "d997d399-355e-4c49-9c7b-75a93d76bc0e",
          name: "つんく♂",
          sort-name: "Tsunku",
          disambiguation: ""
        },
        source-credit: "",
        target-credit: "",
        attributes: [ ],
        attribute-ids: { },
        attribute-values: { },
        begin: null,
        end: null,
        ended: false
      }
    ]
  }

Browse requests

Request: http://musicbrainz.org/ws/2/release?label=47e718e1-7ee4-460c-b1cc-1192a841c6e5&offset=12&limit=2

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <release-list count="106" offset="12">
    <release id="6283480c-5004-4da7-993c-69fd7d2f0681">
      <title>Autumntunes</title>
      /* some properties omitted to keep this example shorter, see the release results for the full format */
    </release>
    <release id="26598ff2-4719-4d26-a3e5-5ccd77119455">
      <title>Around Past</title>
      /* some properties omitted to keep this example shorter, see the release results for the full format */
    </release>
  </release-list>
</metadata>
JSON Response
  {
    releases: [
      {
        id: "26598ff2-4719-4d26-a3e5-5ccd77119455",
        title: "Around Past"
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      },
      {
        id: "6283480c-5004-4da7-993c-69fd7d2f0681",
        title: "Autumntunes"
        /* some properties omitted to keep this example shorter, see the release results for the full format */
      }
    ],
    release-offset: 12,
    release-count: 106
  }

Relationships

You can find standard real-life examples of relationship requests above, under the lookup examples for Event and Work.

See the example below for a classical release (one-track, for simplicity) with both performers (recording level relationships) and composer (work level relationship) using recording-level-rels and work-level-rels.

Request: https://musicbrainz.org/ws/2/release/987f3e2d-22a6-4a4f-b840-c80c26b8b91a?inc=artist-credits+labels+recordings+recording-level-rels+work-rels+work-level-rels+artist-rels

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
    <release id="987f3e2d-22a6-4a4f-b840-c80c26b8b91a">
        <title>Become Desert</title>
        <status id="4e304316-386d-3409-af2e-78857eec5cfe">Official</status>
        <quality>normal</quality>
        <packaging id="119eba76-b343-3e02-a292-f0f00644bb9b">None</packaging>
        <text-representation>
            <language>eng</language>
            <script>Latn</script>
        </text-representation>
        <artist-credit>
            <name-credit joinphrase="; ">
                <artist id="96681463-98e2-4032-9728-5fbb7b002427" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                    <name>John Luther Adams</name>
                    <sort-name>Adams, John Luther</sort-name>
                </artist>
            </name-credit>
            <name-credit joinphrase=", ">
                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                    <name>Seattle Symphony</name>
                    <sort-name>Seattle Symphony</sort-name>
                </artist>
            </name-credit>
            <name-credit>
                <artist id="eace8da8-8535-47c4-82da-902c792ec9f4" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                    <name>Ludovic Morlot</name>
                    <sort-name>Morlot, Ludovic</sort-name>
                </artist>
            </name-credit>
        </artist-credit>
        <date>2019-06-14</date>
        <country>XW</country>
        <release-event-list count="1">
            <release-event>
                <date>2019-06-14</date>
                <area id="525d4e18-3d00-31b9-a58b-a146a916de8f">
                    <name>[Worldwide]</name>
                    <sort-name>[Worldwide]</sort-name>
                    <iso-3166-1-code-list>
                        <iso-3166-1-code>XW</iso-3166-1-code>
                    </iso-3166-1-code-list>
                </area>
            </release-event>
        </release-event-list>
        <cover-art-archive>
            <artwork>true</artwork>
            <count>1</count>
            <front>true</front>
            <back>false</back>
        </cover-art-archive>
        <label-info-list count="1">
            <label-info>
                <label id="3044afdb-c895-4f60-8e69-5796b3887c21" type="Original Production" type-id="7aaa37fe-2def-3476-b359-80245850062d">
                    <name>Cantaloupe Music</name>
                    <sort-name>Cantaloupe Music</sort-name>
                </label>
            </label-info>
        </label-info-list>
        <medium-list count="1">
            <medium>
                <position>1</position>
                <format id="907a28d9-b3b2-3ef6-89a8-7b18d91d4794">Digital Media</format>
                <track-list count="1" offset="0">
                    <track id="33781879-1dae-422c-a634-b26f89705e48">
                        <position>1</position>
                        <number>1</number>
                        <length>2422450</length>
                        <artist-credit>
                            <name-credit>
                                <artist id="96681463-98e2-4032-9728-5fbb7b002427" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                    <name>John Luther Adams</name>
                                    <sort-name>Adams, John Luther</sort-name>
                                </artist>
                            </name-credit>
                        </artist-credit>
                        <recording id="d90bc0ff-c7d9-4c09-a12b-d46f46f7281d">
                            <title>Become Desert</title>
                            <length>2422450</length>
                            <artist-credit>
                                <name-credit joinphrase=", ">
                                    <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                        <name>Seattle Symphony</name>
                                        <sort-name>Seattle Symphony</sort-name>
                                    </artist>
                                </name-credit>
                                <name-credit>
                                    <artist id="eace8da8-8535-47c4-82da-902c792ec9f4" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Ludovic Morlot</name>
                                        <sort-name>Morlot, Ludovic</sort-name>
                                    </artist>
                                </name-credit>
                            </artist-credit>
                            <relation-list target-type="artist">
                                <relation type="conductor" type-id="234670ce-5f22-4fd0-921b-ef1662695c5d">
                                    <target>eace8da8-8535-47c4-82da-902c792ec9f4</target>
                                    <direction>backward</direction>
                                    <begin>2018-09-25</begin>
                                    <end>2018-09-26</end>
                                    <ended>true</ended>
                                    <artist id="eace8da8-8535-47c4-82da-902c792ec9f4" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Ludovic Morlot</name>
                                        <sort-name>Morlot, Ludovic</sort-name>
                                    </artist>
                                </relation>
                                <relation type="mix" type-id="3e3102e1-1896-4f50-b5b2-dd9824e46efe">
                                    <target>ac0122d6-14e8-4335-a01f-5d6ee71d308b</target>
                                    <direction>backward</direction>
                                    <artist id="ac0122d6-14e8-4335-a01f-5d6ee71d308b" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Nathaniel Reichman</name>
                                        <sort-name>Reichman, Nathaniel</sort-name>
                                        <disambiguation>music producer, rerecording mixer</disambiguation>
                                    </artist>
                                </relation>
                                <relation type="performing orchestra" type-id="3b6616c5-88ba-4341-b4ee-81ce1e6d7ebb">
                                    <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
                                    <direction>backward</direction>
                                    <begin>2018-09-25</begin>
                                    <end>2018-09-26</end>
                                    <ended>true</ended>
                                    <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                        <name>Seattle Symphony</name>
                                        <sort-name>Seattle Symphony</sort-name>
                                    </artist>
                                </relation>
                                <relation type="producer" type-id="5c0ceac3-feb4-41f0-868d-dc06f6e27fc0">
                                    <target>748b47b2-604b-4487-b994-944918df19e9</target>
                                    <direction>backward</direction>
                                    <artist id="748b47b2-604b-4487-b994-944918df19e9" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Dmitriy Lipay</name>
                                        <sort-name>Lipay, Dmitriy</sort-name>
                                        <disambiguation>recording engineer & producer</disambiguation>
                                    </artist>
                                </relation>
                                <relation type="producer" type-id="5c0ceac3-feb4-41f0-868d-dc06f6e27fc0">
                                    <target>ac0122d6-14e8-4335-a01f-5d6ee71d308b</target>
                                    <direction>backward</direction>
                                    <artist id="ac0122d6-14e8-4335-a01f-5d6ee71d308b" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Nathaniel Reichman</name>
                                        <sort-name>Reichman, Nathaniel</sort-name>
                                        <disambiguation>music producer, rerecording mixer</disambiguation>
                                    </artist>
                                </relation>
                                <relation type="recording" type-id="a01ee869-80a8-45ef-9447-c59e91aa7926">
                                    <target>e2a6142d-83f5-4626-a48a-1211588d06db</target>
                                    <direction>backward</direction>
                                    <artist id="e2a6142d-83f5-4626-a48a-1211588d06db" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Alexander Lipay</name>
                                        <sort-name>Lipay, Alexander</sort-name>
                                    </artist>
                                </relation>
                                <relation type="recording" type-id="a01ee869-80a8-45ef-9447-c59e91aa7926">
                                    <target>748b47b2-604b-4487-b994-944918df19e9</target>
                                    <direction>backward</direction>
                                    <artist id="748b47b2-604b-4487-b994-944918df19e9" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                        <name>Dmitriy Lipay</name>
                                        <sort-name>Lipay, Dmitriy</sort-name>
                                        <disambiguation>recording engineer & producer</disambiguation>
                                    </artist>
                                </relation>
                            </relation-list>
                            <relation-list target-type="work">
                                <relation type="performance" type-id="a3005666-a872-32c3-ad06-98af558e99b0">
                                    <target>b6cb19ec-08d3-4563-9e82-9562e5cab030</target>
                                    <direction>forward</direction>
                                    <begin>2018-09-25</begin>
                                    <end>2018-09-26</end>
                                    <ended>true</ended>
                                    <work id="b6cb19ec-08d3-4563-9e82-9562e5cab030" type="Symphony" type-id="174314aa-0aa4-30cf-96a6-50b281d8d208">
                                        <title>Become Desert</title>
                                        <language>zxx</language>
                                        <language-list>
                                            <language>zxx</language>
                                        </language-list>
                                        <relation-list target-type="artist">
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
                                                <target>7cdb68bc-c4f1-4a92-9bd2-739641c5eff0</target>
                                                <direction>backward</direction>
                                                <artist id="7cdb68bc-c4f1-4a92-9bd2-739641c5eff0" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>New York Philharmonic</name>
                                                    <sort-name>New York Philharmonic</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
                                                <target>c5958778-9c97-4970-9e63-0072ab2c4189</target>
                                                <direction>backward</direction>
                                                <artist id="c5958778-9c97-4970-9e63-0072ab2c4189" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>Rotterdams Philharmonisch Orkest</name>
                                                    <sort-name>Rotterdams Philharmonisch Orkest</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
                                                <target>68f7b9d5-b329-40aa-a474-5abffd6dfb44</target>
                                                <direction>backward</direction>
                                                <artist id="68f7b9d5-b329-40aa-a474-5abffd6dfb44" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>San Diego Symphony</name>
                                                    <sort-name>San Diego Symphony</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="commissioned" type-id="95f0213a-dbe0-4d36-8036-9782e425e98a">
                                                <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
                                                <direction>backward</direction>
                                                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>Seattle Symphony</name>
                                                    <sort-name>Seattle Symphony</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="composer" type-id="d59d99ea-23d4-4a80-b066-edca32ee158f">
                                                <target>96681463-98e2-4032-9728-5fbb7b002427</target>
                                                <direction>backward</direction>
                                                <artist id="96681463-98e2-4032-9728-5fbb7b002427" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
                                                    <name>John Luther Adams</name>
                                                    <sort-name>Adams, John Luther</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="premiere" type-id="5cc8cfb5-cca0-4395-a44b-b7d3c1777608">
                                                <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
                                                <direction>backward</direction>
                                                <begin>2018-03-21</begin>
                                                <end>2018-03-21</end>
                                                <ended>true</ended>
                                                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>Seattle Symphony</name>
                                                    <sort-name>Seattle Symphony</sort-name>
                                                </artist>
                                            </relation>
                                            <relation type="premiere" type-id="5cc8cfb5-cca0-4395-a44b-b7d3c1777608">
                                                <target>0b51c328-1f2b-464c-9e2c-0c2a8cce20ae</target>
                                                <direction>backward</direction>
                                                <begin>2018-03-29</begin>
                                                <end>2018-03-29</end>
                                                <ended>true</ended>
                                                <artist id="0b51c328-1f2b-464c-9e2c-0c2a8cce20ae" type="Orchestra" type-id="a0b36c92-3eb1-3839-a4f9-4799823f54a5">
                                                    <name>Seattle Symphony</name>
                                                    <sort-name>Seattle Symphony</sort-name>
                                                </artist>
                                            </relation>
                                        </relation-list>
                                    </work>
                                </relation>
                            </relation-list>
                        </recording>
                    </track>
                </track-list>
            </medium>
        </medium-list>
    </release>
</metadata>
JSON Response
  {
    id: "987f3e2d-22a6-4a4f-b840-c80c26b8b91a",
    title: "Become Desert",
    disambiguation: "",
    artist-credit: [
      {
        name: "John Luther Adams",
        joinphrase: "; ",
        artist: {
          id: "96681463-98e2-4032-9728-5fbb7b002427",
          name: "John Luther Adams",
          sort-name: "Adams, John Luther",
          disambiguation: ""
        }
      },
      {
        name: "Seattle Symphony",
        joinphrase: ", ",
        artist: {
          id: "0b51c328-1f2b-464c-9e2c-0c2a8cce20ae",
          name: "Seattle Symphony",
          sort-name: "Seattle Symphony",
          disambiguation: ""
        }
      },
      {
        name: "Ludovic Morlot",
        joinphrase: "",
        artist: {
          id: "eace8da8-8535-47c4-82da-902c792ec9f4",
          name: "Ludovic Morlot",
          sort-name: "Morlot, Ludovic",
          disambiguation: ""
        }
      }
    ],
    text-representation: {
      language: "eng",
      script: "Latn"
    },
    date: "2019-06-14",
    country: "XW",
    release-events: [
      {
        date: "2019-06-14",
        area: {
          id: "525d4e18-3d00-31b9-a58b-a146a916de8f",
          name: "[Worldwide]",
          sort-name: "[Worldwide]",
          disambiguation: "",
          iso-3166-1-codes: ["XW"]
        }
      }
    ],
    label-info: [
      {
        label: {
          id: "3044afdb-c895-4f60-8e69-5796b3887c21",
          sort-name: "Cantaloupe Music",
          name: "Cantaloupe Music",
          label-code: null,
          disambiguation: ""
        },
        catalog-number: null
      }
    ],
    barcode: null,
    status-id: "4e304316-386d-3409-af2e-78857eec5cfe",
    status: "Official",
    packaging-id: "119eba76-b343-3e02-a292-f0f00644bb9b",
    packaging: "None",
    quality: "normal",
    relations: [ ],
    asin: null,
    media: [
      {
        position: 1,
        format-id: "907a28d9-b3b2-3ef6-89a8-7b18d91d4794",
        format: "Digital Media",
        title: "",
        track-count: 1,
        track-offset: 0,
        tracks: [
          {
            id: "33781879-1dae-422c-a634-b26f89705e48",
            title: "Become Desert",
            length: 2422450,
            number: "1",
            position: 1,
            artist-credit: [
              {
                name: "John Luther Adams",
                joinphrase: "",
                artist: {
                  id: "96681463-98e2-4032-9728-5fbb7b002427",
                  name: "John Luther Adams",
                  sort-name: "Adams, John Luther",
                  disambiguation: ""
                }
              }
            ],
            recording: {
              id: "d90bc0ff-c7d9-4c09-a12b-d46f46f7281d",
              title: "Become Desert",
              disambiguation: "",
              length: 2422450,
              video: false,
              artist-credit: [
                {
                  name: "Seattle Symphony",
                  joinphrase: ", ",
                  artist: {
                    id: "0b51c328-1f2b-464c-9e2c-0c2a8cce20ae",
                    name: "Seattle Symphony",
                    sort-name: "Seattle Symphony",
                    disambiguation: ""
                  }
                },
                {
                  name: "Ludovic Morlot",
                  joinphrase: "",
                  artist: {
                    id: "eace8da8-8535-47c4-82da-902c792ec9f4",
                    sort-name: "Morlot, Ludovic",
                    disambiguation: "",
                    name: "Ludovic Morlot"
                  }
                }
              ],
              relations: [
                {
                  type-id: "234670ce-5f22-4fd0-921b-ef1662695c5d",
                  type: "conductor",
                  direction: "backward",
                  target-type: "artist",
                  artist: {
                    id: "eace8da8-8535-47c4-82da-902c792ec9f4",
                    name: "Ludovic Morlot",
                    sort-name: "Morlot, Ludovic",
                    disambiguation: ""
                  },
                  begin: "2018-09-25",
                  end: "2018-09-26",
                  ended: true,
                  target-credit: "",
                  source-credit: "",
                  attributes: [ ],
                  attribute-values: { },
                  attribute-ids: { }
                },
                {
                  type-id: "3b6616c5-88ba-4341-b4ee-81ce1e6d7ebb",
                  type: "performing orchestra",
                  direction: "backward",
                  target-type: "artist",
                  artist: {
                    id: "0b51c328-1f2b-464c-9e2c-0c2a8cce20ae",
                    name: "Seattle Symphony",
                    sort-name: "Seattle Symphony",
                    disambiguation: ""
                  },
                  begin: "2018-09-25",
                  end: "2018-09-26",
                  ended: true,
                  target-credit: "",
                  source-credit: "",
                  attributes: [ ],
                  attribute-values: { },
                  attribute-ids: { }
                },
                {
                  type-id: "a01ee869-80a8-45ef-9447-c59e91aa7926",
                  type: "recording",
                  direction: "backward",
                  target-type: "artist",
                  artist: {
                    id: "e2a6142d-83f5-4626-a48a-1211588d06db",
                    name: "Alexander Lipay",
                    sort-name: "Lipay, Alexander",
                    disambiguation: ""
                  },
                  begin: null,
                  end: null,
                  ended: false,
                  target-credit: "",
                  source-credit: "",
                  attributes: [ ],
                  attribute-values: { },
                  attribute-ids: { }
                },
                {
                  type-id: "a3005666-a872-32c3-ad06-98af558e99b0",
                  type: "performance",
                  direction: "forward",
                  target-type: "work",
                  work: {
                    id: "b6cb19ec-08d3-4563-9e82-9562e5cab030",
                    title: "Become Desert",
                    disambiguation: "",
                    type-id: null,
                    type: null,
                    languages: ["zxx"],
                    iswcs: [ ],
                    attributes: [ ],
                    relations: [
                      {
                        type-id: "d59d99ea-23d4-4a80-b066-edca32ee158f",
                        type: "composer",
                        direction: "backward",
                        target-type: "artist",
                        artist: {
                          id: "96681463-98e2-4032-9728-5fbb7b002427",
                          name: "John Luther Adams",
                          sort-name: "Adams, John Luther",
                          disambiguation: ""
                        },
                        begin: null,
                        end: null,
                        ended: false,
                        source-credit: "",
                        target-credit: "",
                        attributes: [ ],
                        attribute-ids: { },
                        attribute-values: { }
                      },
                      {
                        type-id: "95f0213a-dbe0-4d36-8036-9782e425e98a",
                        type: "commissioned",
                        direction: "backward",
                        target-type: "artist",
                        artist: {
                          id: "7cdb68bc-c4f1-4a92-9bd2-739641c5eff0",
                          name: "New York Philharmonic",
                          sort-name: "New York Philharmonic",
                          disambiguation: ""
                        },
                        begin: null,
                        end: null,
                        ended: false,
                        source-credit: "",
                        target-credit: "",
                        attributes: [ ],
                        attribute-ids: { },
                        attribute-values: { }
                      }
                    ]
                  },
                  begin: "2018-09-25",
                  end: "2018-09-26",
                  ended: true,
                  target-credit: "",
                  source-credit: "",
                  attributes: [ ],
                  attribute-ids: { },
                  attribute-values: { }
                }
              ]
            }
          }
        ]
      }
    ],
    cover-art-archive: {
      artwork: true,
      count: 1,
      front: true,
      back: false,
      darkened: false
    }
  }


See below for an example of a relationship with relationship attributes (in this case, the work is part of a work catalogue series, and it is assigned a specific number for that series, stored as an attribute):

Request: https://musicbrainz.org/ws/2/work/c1b0e8a2-2461-4d48-9a89-f4e6d624d342?inc=series-rels

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <work id="c1b0e8a2-2461-4d48-9a89-f4e6d624d342" type="Symphony" type-id="174314aa-0aa4-30cf-96a6-50b281d8d208">
    <title>Sinfonie Nr. 1 c-Moll, op. 68</title>
    <language>zxx</language>
    <language-list>
      <language>zxx</language>
    </language-list>
    <attribute-list>
      <attribute value-id="d3d0b554-d3f4-3995-b995-5113f3771295" type="Key" type-id="7526c19d-3be4-3420-b6cc-9fb6e49fa1a9">C minor</attribute>
    </attribute-list>
    <relation-list target-type="series">
      <relation type="part of" type-id="b0d44366-cdf0-3acb-bee6-0f65a77a6ef0">
        <target>03531d5b-11e8-40c9-9fc3-d814e9886590</target>
        <ordering-key>114</ordering-key>
        <direction>backward</direction>
        <attribute-list>
          <attribute type-id="a59c5830-5ec7-38fe-9a21-c7ea54f6650a" value="op. 68">number</attribute>
        </attribute-list>
        <series id="03531d5b-11e8-40c9-9fc3-d814e9886590" type="Catalogue" type-id="49482ff0-fc9e-3b8c-a2d0-30e84d9df002">
          <name>Johannes Brahms. Thematisch-Bibliographisches Werkverzeichnis</name>
        </series>
      </relation>
    </relation-list>
  </work>
</metadata>
JSON Response
{
  id: "c1b0e8a2-2461-4d48-9a89-f4e6d624d342",
  title: "Sinfonie Nr. 1 c-Moll, op. 68"
  type-id: "174314aa-0aa4-30cf-96a6-50b281d8d208",
  type: "Symphony",
  disambiguation: "",
  language: "zxx",
  languages: ["zxx"],
  iswcs: [],
  attributes: [
    {
      value-id: "d3d0b554-d3f4-3995-b995-5113f3771295",
      type-id: "7526c19d-3be4-3420-b6cc-9fb6e49fa1a9",
      type: "Key",
      value: "C minor",
    }
  ],
  relations: [
    {
      direction: "backward",
      target-credit: "",
      type-id: "b0d44366-cdf0-3acb-bee6-0f65a77a6ef0",
      source-credit: "",
      begin: null,
      target-type: "series",
      ended: false,
      series: {
        type: "Catalogue",
        type-id: "49482ff0-fc9e-3b8c-a2d0-30e84d9df002",
        disambiguation: "",
        id: "03531d5b-11e8-40c9-9fc3-d814e9886590",
        name: "Johannes Brahms. Thematisch-Bibliographisches Werkverzeichnis"
      },
      attribute-ids: {
        number: "a59c5830-5ec7-38fe-9a21-c7ea54f6650a"
      },
      attributes: [
        "number"
      ],
      ordering-key: 114,
      type: "part of",
      attribute-values: {
        number: "op. 68"
      },
      end: null
    }
  ],
}

Genres, tags and ratings

You can include genres, tags and ratings to get this secondary data. Below is an example of a request including all of the three. With authentication, you can include user-genres, user-tags and user-ratings to get a list of only the genres, tags and ratings added by the authenticated user.

Request: http://musicbrainz.org/ws/2/artist/db92a151-1ac2-438b-bc43-b82e149ddd50?inc=aliases+genres+tags+ratings

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <artist id="db92a151-1ac2-438b-bc43-b82e149ddd50" type="Person" type-id="b6e035f4-3ce9-331c-97df-83397230b0df">
    <name>Rick Astley</name>
    <sort-name>Astley, Rick</sort-name>
    <disambiguation>English singer, songwriter and radio personality</disambiguation>
    <ipi>00159849414</ipi>
    <ipi-list>
      <ipi>00159849414</ipi>
    </ipi-list>
    <isni-list>
      <isni>0000000120203276</isni>
    </isni-list>
    <gender id="36d3d30a-839d-3eda-8cb3-29be4384e4a9">Male</gender>
    <country>GB</country>
    <area id="8a754a16-0027-3a29-b6d7-2b40ea0481ed">
      <name>United Kingdom</name>
      <sort-name>United Kingdom</sort-name>
      <iso-3166-1-code-list>
        <iso-3166-1-code>GB</iso-3166-1-code>
      </iso-3166-1-code-list>
    </area>
    <begin-area id="71baf484-64ec-4482-9ad2-225aa3b9a337">
      <name>Newton-le-Willows</name>
      <sort-name>Newton-le-Willows</sort-name>
    </begin-area>
    <life-span>
      <begin>1966-02-06</begin>
    </life-span>
    <alias-list count="5">
      <alias sort-name="Astley, Richard Paul" type="Legal name" type-id="d4dcd0c0-b341-3612-a332-c0ce797b25cf">Richard Paul Astley</alias>
    </alias-list>
    <tag-list>
      <tag count="2">
        <name>adult contemporary</name>
      </tag>
      <tag count="2">
        <name>blue-eyed soul</name>
      </tag>
      <tag count="0">
        <name>british</name>
      </tag>
      <tag count="0">
        <name>classic pop and rock</name>
      </tag>
      <tag count="2">
        <name>dance-pop</name>
      </tag>
      <tag count="0">
        <name>english</name>
      </tag>
      <tag count="2">
        <name>pop</name>
      </tag>
      <tag count="0">
        <name>uk</name>
      </tag>
    </tag-list>
    <genre-list>
      <genre count="2" id="650bda08-20ca-4012-b873-3b68c5768bdf">
        <name>blue-eyed soul</name>
      </genre>
      <genre count="2" id="b739a895-85ed-4ad3-8717-4e9ef5387dd8">
        <name>dance-pop</name>
      </genre>
      <genre count="2" id="911c7bbb-172d-4df8-9478-dbff4296e791">
        <name>pop</name>
      </genre>
    </genre-list>
    <rating votes-count="2">4.5</rating>
  </artist>
</metadata>
JSON Response
  {
    id: "db92a151-1ac2-438b-bc43-b82e149ddd50",
    name: "Rick Astley",
    sort-name: "Astley, Rick",
    disambiguation: "English singer, songwriter and radio personality",
    type-id: "b6e035f4-3ce9-331c-97df-83397230b0df",
    type: "Person",
    gender-id: "36d3d30a-839d-3eda-8cb3-29be4384e4a9",
    gender: "Male",
    life-span: {
      end: null,
      ended: false,
      begin: "1966-02-06"
    },
    country: "GB"
    area: {
      id: "8a754a16-0027-3a29-b6d7-2b40ea0481ed",
      name: "United Kingdom",
      sort-name: "United Kingdom",
      disambiguation: "",
      iso-3166-1-codes: ["GB"]
    },
    begin-area: {
      id: "71baf484-64ec-4482-9ad2-225aa3b9a337"
      name: "Newton-le-Willows",
      sort-name: "Newton-le-Willows",
      disambiguation: "",
    },
    end-area: null,
    ipis: ["00159849414"],
    isnis: ["0000000120203276"],
    aliases: [
      {
        name: "Richard Paul Astley",
        sort-name: "Astley, Richard Paul",
        type-id: "d4dcd0c0-b341-3612-a332-c0ce797b25cf",
        type: "Legal name",
        locale: null,
        primary: null,
        begin: null,
        end: null
        ended: false,
      }
    ],
    genres: [
      {
        name: "blue-eyed soul",
        id: "650bda08-20ca-4012-b873-3b68c5768bdf",
        count: 2,
        disambiguation: "",
      },
      {
        name: "dance-pop",
        id: "b739a895-85ed-4ad3-8717-4e9ef5387dd8",
        count: 2,
        disambiguation: "",
      },
      {
        name: "pop",
        id: "911c7bbb-172d-4df8-9478-dbff4296e791",
        count: 2,
        disambiguation: "",
      },
    ],
    tags: [
      {name: "blue-eyed soul", count: 2},
      {name: "british", count: 0}
    ],
    rating: {
      value: 4.5,
      votes-count: 2
    }
  }


Additionally, you can make a request to the /tag or /rating endpoint (requires authentication) to get only the tags or ratings assigned to a specific entity by the authenticated user.

Request: https://musicbrainz.org/ws/2/tag?id=ed35bc92-2b5a-4ddf-96d2-51af9ab239e7&entity=artist

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <user-tag-list>
    <user-tag>
      <name>classical</name>
    </user-tag>
  </user-tag-list>
</metadata>
JSON Response
  {
    user-tags: [
      {
        name: "classical"
      },
      {
        name: "production music"
      }
    ]
  }

Request: https://musicbrainz.org/ws/2/rating?id=ed35bc92-2b5a-4ddf-96d2-51af9ab239e7&entity=artist

XML Response
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
  <user-rating>80</user-rating>
</metadata>
JSON Response
  {
    user-rating: {
      value: 80
    }
  }