# Pastebin oSDKjTFq
openapi: 3.0.3
info:
  title: MusicBrainz API
  description: |-
    This is a test API description for MusicBrainz
  termsOfService: http://swagger.io/terms/
  contact:
    email: apiteam@swagger.io
  version: 1.0.11
externalDocs:
  description: Find out more about Swagger
  url: http://swagger.io
servers:
  - url: https://musicbrainz.org/ws/2/
tags:
  - name: recording
    description: Related to Recordings
    externalDocs:
      description: Find out more
      url: https://musicbrainz.org/doc/Recording
  - name: release
    description: Related to Releases
    externalDocs:
      description: Release Documentation
      url: https://musicbrainz.org/doc/Release
  - name: artist
    description: Related to Artists
    externalDocs:
      description: Artist documentation
      url: https://musicbrainz.org/doc/Artist
paths:
  /artist/{artist_mbid}:
    get:
      tags:
        - artist
      summary: Get Artist by MBID
      description: Returns a single Artist
      parameters:
        - name: artist_mbid
          in: path
          description: MBID of the Artist
          required: true
          schema:
            type: string
            format: uuid
        - name: inc
          in: query
          style: spaceDelimited
          description: Other items to include
          required: true
          schema:
            type: array
            items:
             # This should use openapi's "$ref" functionality to abstract this out
             enum:
              - area
              - collection
              - recording
              - release
              - release-group
              - work
              - area-rels
              - artist-rels
              - event-rels
              - instrument-rels
              - label-rels
              - place-rels
              - recording-rels
              - release-rels
              - release-group-rels
              - series-rels
              - url-rels
              - work-rels
      responses:
        '200':
          description: successful operation
          # TODO: "content" key explaining how the data looks. This could be autogenerated
          # for xml from the mmd-schema. Unsure about JSON
        '400':
          description: Invalid query supplied
        '404':
          description: Artist not found
  /artist:
    get:
      tags:
        - artist
      summary: Browse artists based on other related information
      responses:
        '200':
          description: successful operation
  /artist:
    get:
      tags:
        - artist
      summary: Search artists based on search criteria
      responses:
        '200':
          description: successful operation