Difference between revisions of "MusicBrainz API/Examples"

From MusicBrainz Wiki
(Recording)
 
(39 intermediate revisions by the same user not shown)
Line 1: Line 1:
The main web service is the [[Development/XML Web Service/Version_2|XML Web Service]]. This page is about the (beta) '''JSON''' format of that web service. For shared documentation, like the available inc= parameters, do follow the [[Development/XML Web Service/Version_2|info at the XML web service docs]]. To get a JSON response from the web service, you can either set the Accept header to "application/json" or add fmt=json to the query string (if both are set, fmt= takes precedence).
+
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.
  
==Beta==
+
==Lookup requests==
 +
===Area===
 +
 
 +
Request: https://musicbrainz.org/ws/2/area/45f07934-675a-46d6-a577-6f8637a411b1?inc=aliases
  
WARNING: This web service is available on the production server (musicbrainz.org/ws/2/) and mostly stable, but is still considered a beta, and while we do our best to avoid breaking changes, we may eventually need to make some before officially marking it as stable. If you find any issues, don't hesitate to [https://tickets.metabrainz.org/secure/Dashboard.jspa open a ticket] or contact us on IRC.
+
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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&#xE4;rnu</name>
 +
    <sort-name>P&#xE4;rnu</sort-name>
 +
    <alias-list count="2">
 +
      <alias locale="en" sort-name="P&#xE4;rnu" type="Area name" type-id="0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29" primary="primary">P&#xE4;rnu</alias>
 +
      <alias locale="et" sort-name="P&#xE4;rnu" type="Area name" type-id="0b5b3497-d5d9-34e7-a61b-9a6c18aa7b29" primary="primary">P&#xE4;rnu</alias>
 +
    </alias-list>
 +
  </area>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
==Lookup requests==
+
<div class="toccolours mw-collapsible mw-collapsed">
Some of the responses below have some fields omitted to keep the examples shorter, in the actual response the data will obviously be included.
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    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
 +
      }
 +
    ]
 +
  }
 +
</pre>
 +
</div>
 +
</div>
  
 
===Artist===
 
===Artist===
  
Request: http://musicbrainz.org/ws/2/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da?inc=aliases&fmt=json
+
Request: http://musicbrainz.org/ws/2/artist/5b11f4ce-a62d-471e-81fc-a69a8278c7da?inc=aliases
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 45: Line 142:
 
     },
 
     },
 
     isnis: ["0000000123486830", "0000000123487390"],
 
     isnis: ["0000000123486830", "0000000123487390"],
     ipis: [ ]
+
     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"
 +
      }
 +
    ]
 
   }
 
   }
 
</pre>
 
</pre>
Line 51: Line 172:
 
</div>
 
</div>
  
Request: http://musicbrainz.org/ws/2/artist/db92a151-1ac2-438b-bc43-b82e149ddd50?inc=aliases+genres+tags+ratings&fmt=json
+
===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
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
 
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
     id: "db92a151-1ac2-438b-bc43-b82e149ddd50",
+
     id: "fe39727a-3d21-4066-9345-3970cbd6cca4",
     name: "Rick Astley",
+
     name: "Nine Inch Nails at Arena Riga",
    sort-name: "Astley, Rick",
+
     disambiguation: "",
     disambiguation: "English singer, songwriter and radio personality",
+
     type-id: "ef55e8d7-3d00-394a-8012-f5506a29ff0b",
     type-id: "b6e035f4-3ce9-331c-97df-83397230b0df",
+
     type: "Concert",
     type: "Person",
 
    gender-id: "36d3d30a-839d-3eda-8cb3-29be4384e4a9",
 
    gender: "Male",
 
 
     life-span: {
 
     life-span: {
       end: null,
+
       end: "2014-05-06",
       ended: false,
+
       ended: true,
       begin: "1966-02-06"
+
       begin: "2014-05-06"
 
     },
 
     },
     country: "GB"
+
     time: "19: 00",
     area: {
+
    cancelled: false,
       id: "8a754a16-0027-3a29-b6d7-2b40ea0481ed",
+
     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",
       name: "United Kingdom",
+
    relations: [
      sort-name: "United Kingdom",
+
      {
      disambiguation: "",
+
        type-id: "936c7c95-3156-3889-a062-8a0cd57f8946",
      iso-3166-1-codes: ["GB"]
+
        type: "main performer",
    },
+
        direction: "backward",
    begin-area: {
+
        target-type: "artist",
       id: "71baf484-64ec-4482-9ad2-225aa3b9a337"
+
        artist: {
      name: "Newton-le-Willows",
+
          id: "b7ffd2af-418f-4be2-bdd1-22f8b48613da",
       sort-name: "Newton-le-Willows",
+
          name: "Nine Inch Nails",
      disambiguation: "",
+
          sort-name: "Nine Inch Nails",
     },
+
          disambiguation: ""
     end-area: null,
+
        },
     ipis: ["00159849414"],
+
        begin: null,
     isnis: ["0000000120203276"],
+
        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: [ ]
 +
  }
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
===Genre===
 +
 
 +
Request: http://musicbrainz.org/ws/2/genre/f66d7266-eb3d-4ef3-b4d8-b7cd992f918b
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <genre id="f66d7266-eb3d-4ef3-b4d8-b7cd992f918b">
 +
    <name>crust punk</name>
 +
  </genre>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    id: "f66d7266-eb3d-4ef3-b4d8-b7cd992f918b"
 +
    name: "crust punk",
 +
    disambiguation: "",
 +
  }
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
===Instrument===
 +
 
 +
Request: https://musicbrainz.org/ws/2/instrument/dd430e7f-36ba-49a5-825b-80a525e69190?inc=aliases
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    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: [
 
     aliases: [
 
       {
 
       {
         name: "Richard Paul Astley",
+
         name: "gumanak",
         sort-name: "Astley, Richard Paul",
+
         sort-name: "gumanak",
         type-id: "d4dcd0c0-b341-3612-a332-c0ce797b25cf",
+
        type-id: "2322fc94-fbf3-3c09-b23c-aa5ec8d14fcd",
         type: "Legal name",
+
        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,
 
         locale: null,
 
         primary: null,
 
         primary: null,
 
         begin: null,
 
         begin: null,
         end: null
+
         end: null,
         ended: false,
+
         ended: false
 
       }
 
       }
     ],
+
     ]
    genres: [
 
      {name: "blue-eyed soul", count: 2}
 
    ],
 
    tags: [
 
      {name: "blue-eyed soul", count: 2},
 
      {name: "british", count: 1}
 
    ],
 
    rating: {
 
      value: 4.5,
 
      votes-count: 2
 
    },
 
 
   }
 
   }
 
</pre>
 
</pre>
Line 118: Line 419:
 
===Label===
 
===Label===
  
Request: http://musicbrainz.org/ws/2/label/46f0f4cd-8aab-4b33-b698-f459faf64190?inc=aliases&fmt=json
+
Request: http://musicbrainz.org/ws/2/label/46f0f4cd-8aab-4b33-b698-f459faf64190?inc=aliases
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 158: Line 491:
 
     ipis: [ ],
 
     ipis: [ ],
 
     isnis: ["0000000107280584"]
 
     isnis: ["0000000107280584"]
 +
  }
 +
</pre>
 +
</div>
 +
</div>
 +
 +
===Place===
 +
 +
Request: https://musicbrainz.org/ws/2/place/478558f9-a951-4067-ad91-e83f6ba63e74?inc=aliases
 +
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
 +
</pre>
 +
</div>
 +
</div>
 +
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    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"]
 +
    },
 
   }
 
   }
 
</pre>
 
</pre>
Line 165: Line 578:
 
===Recording===
 
===Recording===
  
Request: https://musicbrainz.org/ws/2/recording/b9ad642e-b012-41c7-b72a-42cf4911f9ff?inc=artist-credits+isrcs+releases&fmt=json
+
Request: https://musicbrainz.org/ws/2/recording/b9ad642e-b012-41c7-b72a-42cf4911f9ff?inc=artist-credits+isrcs+releases
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 218: Line 671:
 
===Release===
 
===Release===
  
Request: http://musicbrainz.org/ws/2/release/59211ea4-ffd2-4ad9-9a4e-941d3148024a?inc=artist-credits+labels+discids+recordings&fmt=json
+
Request: http://musicbrainz.org/ws/2/release/59211ea4-ffd2-4ad9-9a4e-941d3148024a?inc=artist-credits+labels+discids+recordings
  
Response:
+
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
</pre>
 +
</div>
 +
</div>
  
<pre>
+
<div class="toccolours mw-collapsible mw-collapsed">
{
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
    "id": "59211ea4-ffd2-4ad9-9a4e-941d3148024a",
+
<pre class="mw-collapsible-content">
    "title": "æ³o & h³æ",
+
  {
    "date": "2003-12-04",
+
    id: "59211ea4-ffd2-4ad9-9a4e-941d3148024a",
    "text-representation": { "language": "eng", "script": "Latn" },
+
    title: "æ³o & h³æ",
    "country": "GB",
+
    disambiguation: "",
    "status": "Official",
+
    artist-credit: [
    "quality": "normal",
+
      {
    "release-group": {
+
        name: "Autechre",
        "id": "bb5622c1-65b2-3bc4-83e6-0dcaa56abaf2",
+
        joinphrase: " & ",
        "primary-type": "EP"
+
        artist: {
    },
+
          id: "410c9baf-5469-44f6-9852-826524b80c61",
    "artist-credit": [
+
          name: "Autechre",
        {
+
          sort-name: "Autechre",
            "joinphrase": " & ",
+
          disambiguation: "English electronic music duo Rob Brown & Sean Booth"
            "name": "Autechre",
+
        }
            "artist": {
+
      },
                "id": "410c9baf-5469-44f6-9852-826524b80c61",
+
      {
                "name": "Autechre",
+
        name: "The Hafler Trio",
                "sort-name": "Autechre",
+
        joinphrase: "",
                "disambiguation": null
+
        artist: {
            }
+
          id: "146c01d0-d3a2-44c3-acb5-9208bce75e14",
        },
+
          name: "The Hafler Trio",
        {
+
          sort-name: "Hafler Trio, The",
            "name": "The Hafler Trio",
+
          disambiguation: ""
            "joinphrase": "",
+
        }
            "artist": {
+
      }
                "id": "146c01d0-d3a2-44c3-acb5-9208bce75e14",
+
    ],
                "sort-name": "Hafler Trio, The",
+
    date: "2003-12-04",
                "name": "The Hafler Trio",
+
    country: "GB",
                "disambiguation": null
+
    release-events: [
            }
+
      {
        }
+
        date: "2003-12-04",
    ],
+
        area: {
    "label-info": [
+
          id: "8a754a16-0027-3a29-b6d7-2b40ea0481ed",
        {
+
          name: "United Kingdom",
            "label": {
+
          sort-name: "United Kingdom",
                "id": "a0759efa-f583-49ea-9a8d-d5bbce55541c",
+
          iso-3166-1-codes: ["GB"],
                "name": "Phonometrography",
+
          disambiguation: ""
                "sort-name": "Phonometrography",
+
        }
                "label-code": null,
+
      }
                "disambiguation": null
+
    ],
            },
+
    label-info: [
            "catalog-number": "pgram002"
+
      {
        }
+
        catalog-number: "pgram002",
    ],
+
        label: {
    "media": [
+
          id: "a0759efa-f583-49ea-9a8d-d5bbce55541c",
        {
+
          name: "Phonometrography",
            "track-offset": 0,
+
          disambiguation: "",
            "track-count": 1,
+
          label-code: null
            "title": "æ³o",
+
        }
            "format": "CD",
+
      }
            "discids": [
+
    ],
                { "id": "nN2g3a0ZSjovyIgK3bJl6_.j8C4-", "sectors": 73241 }
+
    barcode: null,
            ],
+
    packaging-id: null,
            "tracks": [
+
    packaging: null,
                {
+
    status-id: "4e304316-386d-3409-af2e-78857eec5cfe",
                    "number": "1",
+
    status: "Official",
                    "length": 974546,
+
    quality: "normal",
                    "title": "æ³o",
+
    text-representation: {
                    "recording": { /* recording data omitted for this example. */ },
+
      language: "eng",
                    "artist-credit": [ /* as on release, not repeated in this example. */ ]
+
      script: "Latn"
                }
+
    },
            ]
+
    asin: null,
        },
+
    media: [
        {
+
      {
            "track-offset": 0,
+
        discs: [
            "track-count": 1,
+
          {
            "title": "h³æ",
+
            id: "nN2g3a0ZSjovyIgK3bJl6_.j8C4-",
            "format": "CD",
+
            sectors: 73241,
            "discids": [
+
            offsets: [150],
                { "id": "aSHvkMnq2jZVFEK.DmSPbvN_f54-", "sectors": 69341 }
+
            offset-count: 1
            ],
+
          }
            "tracks": [
+
        ],
                {
+
        position: 1,
                    "number": "1",
+
        title: "æ³o",
                    "length": 922546,
+
        format-id: "9712d52a-4509-3d4b-a1a2-67c88c643e31",
                    "title": "h³æ",
+
        format: "CD",
                    "recording": { /* recording data omitted for this example. */ },
+
        track-count: 1,
                    "artist-credit": [ /* as on release, not repeated in this example. */ ]
+
        track-offset: 0,
                }
+
        tracks: [
            ]
+
          {
        }
+
            id: "61af3e5a-14e0-350d-9826-a884c6e586b1",
    ],
+
            title: "æ³o",
    "barcode": null,
+
            length: 974546,
    "disambiguation": null,
+
            number: "1",
    "packaging": null,
+
            position: 1,
    "asin": null
+
            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
 +
    }
 +
  }
 
</pre>
 
</pre>
 +
</div>
 +
</div>
  
 
===Release Group===
 
===Release Group===
  
Request: http://musicbrainz.org/ws/2/release-group/c9fdb94c-4975-4ed6-a96f-ef6d80bb7738?inc=artist-credits+releases&fmt=json
+
Request: http://musicbrainz.org/ws/2/release-group/c9fdb94c-4975-4ed6-a96f-ef6d80bb7738?inc=artist-credits+releases
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
  {
 
  {
Line 349: Line 1,112:
 
   }
 
   }
  
 +
</pre>
 +
</div>
 +
</div>
 +
 +
===URL===
 +
 +
Request: https://musicbrainz.org/ws/2/url/46d8f693-52e4-4d03-936f-7ca8459019a7
 +
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <url id="46d8f693-52e4-4d03-936f-7ca8459019a7">
 +
    <resource>https://www.arvopart.ee/</resource>
 +
  </url>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
 +
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    id: "46d8f693-52e4-4d03-936f-7ca8459019a7",
 +
    resource: "https://www.arvopart.ee/"
 +
  }
 
</pre>
 
</pre>
 
</div>
 
</div>
Line 355: Line 1,145:
 
===Work===
 
===Work===
  
Request: http://musicbrainz.org/ws/2/work/b1df2cf3-69a9-3bc0-be44-f71e79b27a22?fmt=json
+
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
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
 
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
Line 375: Line 1,209:
 
       }
 
       }
 
     ],
 
     ],
 +
    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
 +
      }
 +
    ]
 
   }
 
   }
 
</pre>
 
</pre>
Line 380: Line 1,255:
 
</div>
 
</div>
  
===Genre===
+
==Browse requests==
 +
 
 +
Request: http://musicbrainz.org/ws/2/release?label=47e718e1-7ee4-460c-b1cc-1192a841c6e5&offset=12&limit=2
  
Request: http://musicbrainz.org/ws/2/genre/f66d7266-eb3d-4ef3-b4d8-b7cd992f918b?fmt=json
+
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
</pre>
 +
</div>
 +
</div>
  
 
<div class="toccolours mw-collapsible mw-collapsed">
 
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Response</div>
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 
<pre class="mw-collapsible-content">
 
<pre class="mw-collapsible-content">
 
   {
 
   {
    id: "f66d7266-eb3d-4ef3-b4d8-b7cd992f918b"
+
    releases: [
    name: "crust punk",
+
      {
    disambiguation: "",
+
        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
 
   }
 
   }
 
</pre>
 
</pre>
Line 396: Line 1,301:
 
</div>
 
</div>
  
==Browse Requests==
+
==Relationships==
 +
You can find standard real-life examples of relationship requests above, under the lookup examples for Event and Work.
  
Browse requests return a toplevel object with offset and count properties to
+
See the example below for a classical release (one-track, for simplicity) with both performers (recording level relationships) and composer (work level relationship) using <code>recording-level-rels</code> and <code>work-level-rels</code>.
help with paging, and a property for the requested entity.
 
The key for this property will be the english plural of the entity, so:
 
artists, labels, recordings, releases, release-groups or works.
 
  
Request: http://musicbrainz.org/ws/2/release?label=47e718e1-7ee4-460c-b1cc-1192a841c6e5&offset=12&limit=2&fmt=json
+
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
  
Response:
+
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
</pre>
 +
</div>
 +
</div>
  
<pre>
+
<div class="toccolours mw-collapsible mw-collapsed">
{
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
    "releases": [
+
<pre class="mw-collapsible-content">
         {
+
  {
            "id": "0b405ea7-8785-402f-bcf7-d55f5000dc3e",
+
    id: "987f3e2d-22a6-4a4f-b840-c80c26b8b91a",
            "title": "Wintertunes"
+
    title: "Become Desert",
            /* some properties omitted to keep this example shorter. */
+
    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
             "id": "7eb37a3a-646d-4501-a373-e9071186b88d",
+
      }
             "title": "Adventure Magic Supreme Journey Music"
+
    ],
            /* some properties omitted to keep this example shorter. */
+
    barcode: null,
         }
+
    status-id: "4e304316-386d-3409-af2e-78857eec5cfe",
    ],
+
    status: "Official",
    "release-offset": 12,
+
    packaging-id: "119eba76-b343-3e02-a292-f0f00644bb9b",
    "release-count": 48
+
    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
 +
    }
 +
  }
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
 
 +
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
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
{
 +
  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
 +
    }
 +
  ],
 +
}
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
== 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
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<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>
 +
</pre>
 +
</div>
 +
</div>
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
 +
<pre class="mw-collapsible-content">
 +
  {
 +
    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
 +
    }
 +
  }
 
</pre>
 
</pre>
 +
</div>
 +
</div>
 +
  
==Relationships==
+
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: http://musicbrainz.org/ws/2/release/275b01eb-8551-47ff-bd6b-2d142b4bf422?inc=url-rels&fmt=json
+
Request: https://musicbrainz.org/ws/2/tag?id=ed35bc92-2b5a-4ddf-96d2-51af9ab239e7&entity=artist
  
Response:
+
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <user-tag-list>
 +
    <user-tag>
 +
      <name>classical</name>
 +
    </user-tag>
 +
  </user-tag-list>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
<pre>
+
<div class="toccolours mw-collapsible mw-collapsed">
{
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
    "id": "275b01eb-8551-47ff-bd6b-2d142b4bf422",
+
<pre class="mw-collapsible-content">
    "title": "Kraftwerk Kover Kollection, Volume 1",
+
  {
    "quality": "normal",
+
    user-tags: [
    "text-representation": { "language": "eng", "script": "Latn" },
+
      {
    "date": "2012",
+
        name: "classical"
    "relations": [
+
      },
        {
+
      {
            "direction": "backward",
+
        name: "production music"
            "type": "download for free",
+
      }
            "url": "http://soundcloud.com/strictly/kraftwerk-kover-kollection-vol"
+
    ]
        }
+
  }
    ],
 
    "country": null,
 
    "status": null,
 
    "barcode": null,
 
    "disambiguation": null,
 
    "packaging": null,
 
    "asin": null
 
}
 
 
</pre>
 
</pre>
 +
</div>
 +
</div>
  
Request: http://musicbrainz.org/ws/2/work/b1df2cf3-69a9-3bc0-be44-f71e79b27a22?inc=artist-rels+recording-rels&fmt=json
+
Request: https://musicbrainz.org/ws/2/rating?id=ed35bc92-2b5a-4ddf-96d2-51af9ab239e7&entity=artist
  
Response:
+
<div class="toccolours mw-collapsible mw-collapsed">
 +
<div style="font-weight:bold;line-height:1.6;">XML Response</div>
 +
<pre class="mw-collapsible-content">
 +
<metadata xmlns="http://musicbrainz.org/ns/mmd-2.0#">
 +
  <user-rating>80</user-rating>
 +
</metadata>
 +
</pre>
 +
</div>
 +
</div>
  
<pre>
+
<div class="toccolours mw-collapsible mw-collapsed">
{
+
<div style="font-weight:bold;line-height:1.6;">JSON Response</div>
  "id": "b1df2cf3-69a9-3bc0-be44-f71e79b27a22",
+
<pre class="mw-collapsible-content">
  "title": "HELLO! また会おうね",
+
  {
  "language": "jpn",
+
    user-rating: {
  "iswcs": [ "T-101.690.320-9" ],
+
      value: 80
  "relations": [
+
    }
        {
+
  }
            "direction": "backward",
 
            "type": "composer",
 
            "artist": {
 
                "id": "d997d399-355e-4c49-9c7b-75a93d76bc0e",
 
                "name": "つんく♂",
 
                "sort-name": "Tsunku",
 
                "disambiguation": null
 
            }
 
        },
 
        {
 
            "direction": "backward",
 
            "type": "lyricist",
 
            "artist": {
 
                "id": "d997d399-355e-4c49-9c7b-75a93d76bc0e",
 
                "name": "つんく♂",
 
                "sort-name": "Tsunku",
 
                "disambiguation": null
 
            }
 
        },
 
        {
 
            "direction": "backward",
 
            "type": "performance",
 
            "recording": {
 
                "id": "487cac92-eed5-4efa-8563-c9a818079b9a",
 
                "title": "HELLO! また会おうね (7人祭 version)",
 
                "length": 283600,
 
                "disambiguation": null
 
            }
 
        },
 
        {
 
            "type": "performance",
 
            "direction": "backward",
 
            "recording": {
 
                "id": "fd3061c1-cb9a-4698-bc5f-f6e0e6a36272",
 
                "title": "HELLO! また会おうね (20人祭 version)",
 
                "length": 283600,
 
                "disambiguation": "PV"
 
            }
 
        }
 
    ]
 
}
 
 
</pre>
 
</pre>
 +
</div>
 +
</div>

Latest revision as of 20:20, 5 January 2021

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
    }
  }