Skip to content

Latest commit

 

History

History
7526 lines (6171 loc) · 156 KB

types.md

File metadata and controls

7526 lines (6171 loc) · 156 KB
Raw

Schema Types

You may also be interested in reading the schema in GraphQL syntax or the schemas provided by the built-in extensions.

Table of Contents

Query

The query root, from which multiple types of MusicBrainz requests can be made.

Field Argument Type Description
lookup LookupQuery

Perform a lookup of a MusicBrainz entity by its MBID.
browse BrowseQuery

Browse all MusicBrainz entities directly linked to another entity.
search SearchQuery

Search for MusicBrainz entities using Lucene query syntax.
node Node

Fetches an object given its ID
id ID!

The ID of an object

Objects

Alias

Aliases are variant names that are mostly used as search help: if a search matches an entity’s alias, the entity will be given as a result – even if the actual name wouldn’t be.

Field Argument Type Description
name String

The aliased name of the entity.
sortName String

The string to use for the purpose of ordering by name (for example, by moving articles like ‘the’ to the end or a person’s last name to the front).
locale Locale

The locale (language and/or country) in which the alias is used.
primary Boolean

Whether this is the main alias for the entity in the specified locale (this could mean the most recent or the most common).
type String

The type or purpose of the alias – whether it is a variant, search hint, etc.
typeID MBID

The MBID associated with the value of the type field.

Area

Areas are geographic regions or settlements (countries, cities, or the like).

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
name String

The official name of the entity.
sortName String

The string to use for the purpose of ordering by name (for example, by moving articles like ‘the’ to the end or a person’s last name to the front).
disambiguation String

A comment used to help distinguish identically named entitites.
aliases [Alias]

Aliases are used to store alternate names or misspellings.
isoCodes [String]

ISO 3166 codes are the codes assigned by ISO to countries and subdivisions.
standard String

Specify the particular ISO standard codes to retrieve. Available ISO standards are 3166-1, 3166-2, and 3166-3.
type String

The type of area (country, city, etc. – see the possible values).
typeID MBID

The MBID associated with the value of the type field.
artists ArtistConnection

A list of artists linked to this entity.
after String
first Int
events EventConnection

A list of events linked to this entity.
after String
first Int
labels LabelConnection

A list of labels linked to this entity.
after String
first Int
places PlaceConnection

A list of places linked to this entity.
after String
first Int
releases ReleaseConnection

A list of releases linked to this entity.
type [ReleaseGroupType]

Filter by one or more release group types.
status [ReleaseStatus]

Filter by one or more release statuses.
after String
first Int
relationships Relationships

Relationships between this entity and other entitites.
collections CollectionConnection

A list of collections containing this entity.
after String
first Int
tags TagConnection

A list of tags linked to this entity.
after String
first Int

AreaConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [AreaEdge]

A list of edges.
nodes [Area]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

AreaEdge

An edge in a connection.

Field Argument Type Description
node Area

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

Artist

An artist is generally a musician, group of musicians, or other music professional (like a producer or engineer). Occasionally, it can also be a non-musical person (like a photographer, an illustrator, or a poet whose writings are set to music), or even a fictional character.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
name String

The official name of the entity.
sortName String

The string to use for the purpose of ordering by name (for example, by moving articles like ‘the’ to the end or a person’s last name to the front).
disambiguation String

A comment used to help distinguish identically named entitites.
aliases [Alias]

Aliases are used to store alternate names or misspellings.
country String

The country with which an artist is primarily identified. It is often, but not always, its birth/formation country.
area Area

The area with which an artist is primarily identified. It is often, but not always, its birth/formation country.
beginArea Area

The area in which an artist began their career (or where they were born, if the artist is a person).
endArea Area

The area in which an artist ended their career (or where they died, if the artist is a person).
lifeSpan LifeSpan

The begin and end dates of the entity’s existence. Its exact meaning depends on the type of entity.
gender String

Whether a person or character identifies as male, female, or neither. Groups do not have genders.
genderID MBID

The MBID associated with the value of the gender field.
type String

Whether an artist is a person, a group, or something else.
typeID MBID

The MBID associated with the value of the type field.
ipis [IPI]

List of Interested Parties Information (IPI) codes for the artist.
isnis [ISNI]

List of International Standard Name Identifier (ISNI) codes for the artist.
recordings RecordingConnection

A list of recordings linked to this entity.
after String
first Int
releases ReleaseConnection

A list of releases linked to this entity.
type [ReleaseGroupType]

Filter by one or more release group types.
status [ReleaseStatus]

Filter by one or more release statuses.
after String
first Int
releaseGroups ReleaseGroupConnection

A list of release groups linked to this entity.
type [ReleaseGroupType]

Filter by one or more release group types.
after String
first Int
works WorkConnection

A list of works linked to this entity.
after String
first Int
relationships Relationships

Relationships between this entity and other entitites.
collections CollectionConnection

A list of collections containing this entity.
after String
first Int
rating Rating

The rating users have given to this entity.
tags TagConnection

A list of tags linked to this entity.
after String
first Int

ArtistConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [ArtistEdge]

A list of edges.
nodes [Artist]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

ArtistCredit

Artist credits indicate who is the main credited artist (or artists) for releases, release groups, tracks, and recordings, and how they are credited. They consist of artists, with (optionally) their names as credited in the specific release, track, etc., and join phrases between them.

Field Argument Type Description
artist Artist

The entity representing the artist referenced in the credits.
name String

The name of the artist as credited in the specific release, track, etc.
joinPhrase String

Join phrases might include words and/or punctuation to separate artist names as they appear on the release, track, etc.

ArtistEdge

An edge in a connection.

Field Argument Type Description
node Artist

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

BrowseQuery

A query for all MusicBrainz entities directly linked to another entity.

Field Argument Type Description
areas AreaConnection

Browse area entities linked to the given arguments.
collection MBID

The MBID of a collection in which the entity is found.
after String
first Int
artists ArtistConnection

Browse artist entities linked to the given arguments.
area MBID

The MBID of an area to which the entity is linked.
collection MBID

The MBID of a collection in which the entity is found.
recording MBID

The MBID of a recording to which the entity is linked.
release MBID

The MBID of a release to which the entity is linked.
releaseGroup MBID

The MBID of a release group to which the entity is linked.
work MBID

The MBID of a work to which the entity is linked.
after String
first Int
collections CollectionConnection

Browse collection entities linked to the given arguments.
area MBID

The MBID of an area to which the entity is linked.
artist MBID

The MBID of an artist to which the entity is linked.
editor String

The username of the editor who created the collection.
event MBID

The MBID of an event to which the entity is linked.
label MBID

The MBID of a label to which the entity is linked.
place MBID

The MBID of a place to which the entity is linked.
recording MBID

The MBID of a recording to which the entity is linked.
release MBID

The MBID of a release to which the entity is linked.
releaseGroup MBID

The MBID of a release group to which the entity is linked.
work MBID

The MBID of a work to which the entity is linked.
after String
first Int
events EventConnection

Browse event entities linked to the given arguments.
area MBID

The MBID of an area to which the entity is linked.
artist MBID

The MBID of an artist to which the entity is linked.
collection MBID

The MBID of a collection in which the entity is found.
place MBID

The MBID of a place to which the entity is linked.
after String
first Int
labels LabelConnection

Browse label entities linked to the given arguments.
area MBID

The MBID of an area to which the entity is linked.
collection MBID

The MBID of a collection in which the entity is found.
release MBID

The MBID of a release to which the entity is linked.
after String
first Int
places PlaceConnection

Browse place entities linked to the given arguments.
area MBID

The MBID of an area to which the entity is linked.
collection MBID

The MBID of a collection in which the entity is found.
after String
first Int
recordings RecordingConnection

Browse recording entities linked to the given arguments.
artist MBID

The MBID of an artist to which the entity is linked.
collection MBID

The MBID of a collection in which the entity is found.
isrc ISRC

The International Standard Recording Code (ISRC) of the recording.
release MBID

The MBID of a release to which the entity is linked.
after String
first Int
releases ReleaseConnection

Browse release entities linked to the given arguments.
area MBID

The MBID of an area to which the entity is linked.
artist MBID

The MBID of an artist to which the entity is linked.
collection MBID

The MBID of a collection in which the entity is found.
discID DiscID

A disc ID associated with the release.
label MBID

The MBID of a label to which the entity is linked.
recording MBID

The MBID of a recording to which the entity is linked.
releaseGroup MBID

The MBID of a release group to which the entity is linked.
track MBID

The MBID of a track that is included in the release.
trackArtist MBID

The MBID of an artist that appears on a track in the release, but is not included in the credits for the release itself.
type [ReleaseGroupType]

Filter by one or more release group types.
status [ReleaseStatus]

Filter by one or more release statuses.
after String
first Int
releaseGroups ReleaseGroupConnection

Browse release group entities linked to the given arguments.
artist MBID

The MBID of an artist to which the entity is linked.
collection MBID

The MBID of a collection in which the entity is found.
release MBID

The MBID of a release to which the entity is linked.
type [ReleaseGroupType]

Filter by one or more release group types.
after String
first Int
works WorkConnection

Browse work entities linked to the given arguments.
artist MBID

The MBID of an artist to which the entity is linked.
collection MBID

The MBID of a collection in which the entity is found.
iswc ISWC

The International Standard Musical Work Code (ISWC) of the work.
after String
first Int

Collection

Collections are lists of entities that users can create.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
name String

The official name of the entity.
editor String!

The username of the editor who created the collection.
entityType String!

The type of entity listed in the collection.
type String

The type of collection.
typeID MBID

The MBID associated with the value of the type field.
areas AreaConnection

The list of areas found in this collection.
after String
first Int
artists ArtistConnection

The list of artists found in this collection.
after String
first Int
events EventConnection

The list of events found in this collection.
after String
first Int
instruments InstrumentConnection

The list of instruments found in this collection.
after String
first Int
labels LabelConnection

The list of labels found in this collection.
after String
first Int
places PlaceConnection

The list of places found in this collection.
after String
first Int
recordings RecordingConnection

The list of recordings found in this collection.
after String
first Int
releases ReleaseConnection

The list of releases found in this collection.
type [ReleaseGroupType]

Filter by one or more release group types.
status [ReleaseStatus]

Filter by one or more release statuses.
after String
first Int
releaseGroups ReleaseGroupConnection

The list of release groups found in this collection.
type [ReleaseGroupType]

Filter by one or more release group types.
after String
first Int
series SeriesConnection

The list of series found in this collection.
after String
first Int
works WorkConnection

The list of works found in this collection.
after String
first Int

CollectionConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [CollectionEdge]

A list of edges.
nodes [Collection]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

CollectionEdge

An edge in a connection.

Field Argument Type Description
node Collection

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

Coordinates

Geographic coordinates described with latitude and longitude.

Field Argument Type Description
latitude Degrees

The north–south position of a point on the Earth’s surface.
longitude Degrees

The east–west position of a point on the Earth’s surface.

Disc

Information about the physical CD and releases associated with a particular disc ID.

Field Argument Type Description
id ID!

The ID of an object
discID DiscID!

The disc ID of this disc.
offsetCount Int!

The number of offsets (tracks) on the disc.
offsets [Int]

The sector offset of each track on the disc.
sectors Int!

The sector offset of the lead-out (the end of the disc).
releases ReleaseConnection

The list of releases linked to this disc ID.
after String
first Int

Event

An event refers to an organised event which people can attend, and is relevant to MusicBrainz. Generally this means live performances, like concerts and festivals.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
name String

The official name of the entity.
disambiguation String

A comment used to help distinguish identically named entitites.
aliases [Alias]

Aliases are used to store alternate names or misspellings.
lifeSpan LifeSpan

The begin and end dates of the entity’s existence. Its exact meaning depends on the type of entity.
time Time

The start time of the event.
cancelled Boolean

Whether or not the event took place.
setlist String

A list of songs performed, optionally including links to artists and works. See the setlist documentation for syntax and examples.
type String

What kind of event the event is, e.g. concert, festival, etc.
typeID MBID

The MBID associated with the value of the type field.
relationships Relationships

Relationships between this entity and other entitites.
collections CollectionConnection

A list of collections containing this entity.
after String
first Int
rating Rating

The rating users have given to this entity.
tags TagConnection

A list of tags linked to this entity.
after String
first Int

EventConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [EventEdge]

A list of edges.
nodes [Event]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

EventEdge

An edge in a connection.

Field Argument Type Description
node Event

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

Instrument

Instruments are devices created or adapted to make musical sounds. Instruments are primarily used in relationships between two other entities.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
name String

The official name of the entity.
disambiguation String

A comment used to help distinguish identically named entitites.
aliases [Alias]

Aliases are used to store alternate names or misspellings.
description String

A brief description of the main characteristics of the instrument.
type String

The type categorises the instrument by the way the sound is created, similar to the Hornbostel-Sachs classification.
typeID MBID

The MBID associated with the value of the type field.
relationships Relationships

Relationships between this entity and other entitites.
collections CollectionConnection

A list of collections containing this entity.
after String
first Int
tags TagConnection

A list of tags linked to this entity.
after String
first Int

InstrumentConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [InstrumentEdge]

A list of edges.
nodes [Instrument]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

InstrumentEdge

An edge in a connection.

Field Argument Type Description
node Instrument

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

Label

Labels represent mostly (but not only) imprints. To a lesser extent, a label entity may be created to represent a record company.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
name String

The official name of the entity.
sortName String

The string to use for the purpose of ordering by name (for example, by moving articles like ‘the’ to the end or a person’s last name to the front).
disambiguation String

A comment used to help distinguish identically named entitites.
aliases [Alias]

Aliases are used to store alternate names or misspellings.
country String

The country of origin for the label.
area Area

The area in which the label is based.
lifeSpan LifeSpan

The begin and end dates of the entity’s existence. Its exact meaning depends on the type of entity.
labelCode Int

The “LC” code of the label.
ipis [IPI]

List of Interested Parties Information codes for the label.
type String

A type describing the main activity of the label, e.g. imprint, production, distributor, rights society, etc.
typeID MBID

The MBID associated with the value of the type field.
releases ReleaseConnection

A list of releases linked to this entity.
type [ReleaseGroupType]

Filter by one or more release group types.
status [ReleaseStatus]

Filter by one or more release statuses.
after String
first Int
relationships Relationships

Relationships between this entity and other entitites.
collections CollectionConnection

A list of collections containing this entity.
after String
first Int
rating Rating

The rating users have given to this entity.
tags TagConnection

A list of tags linked to this entity.
after String
first Int

LabelConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [LabelEdge]

A list of edges.
nodes [Label]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

LabelEdge

An edge in a connection.

Field Argument Type Description
node Label

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

LifeSpan

Fields indicating the begin and end date of an entity’s lifetime, including whether it has ended (even if the date is unknown).

Field Argument Type Description
begin Date

The start date of the entity’s life span.
end Date

The end date of the entity’s life span.
ended Boolean

Whether or not the entity’s life span has ended.

LookupQuery

A lookup of an individual MusicBrainz entity by its MBID.

Field Argument Type Description
area Area

Look up a specific area by its MBID.
mbid MBID!

The MBID of the entity.
artist Artist

Look up a specific artist by its MBID.
mbid MBID!

The MBID of the entity.
collection Collection

Look up a specific collection by its MBID.
mbid MBID!

The MBID of the entity.
disc Disc

Look up a specific physical disc by its disc ID.
discID DiscID!

The disc ID of the disc.
event Event

Look up a specific event by its MBID.
mbid MBID!

The MBID of the entity.
instrument Instrument

Look up a specific instrument by its MBID.
mbid MBID!

The MBID of the entity.
label Label

Look up a specific label by its MBID.
mbid MBID!

The MBID of the entity.
place Place

Look up a specific place by its MBID.
mbid MBID!

The MBID of the entity.
recording Recording

Look up a specific recording by its MBID.
mbid MBID!

The MBID of the entity.
release Release

Look up a specific release by its MBID.
mbid MBID!

The MBID of the entity.
releaseGroup ReleaseGroup

Look up a specific release group by its MBID.
mbid MBID!

The MBID of the entity.
series Series

Look up a specific series by its MBID.
mbid MBID!

The MBID of the entity.
url URL

Look up a specific URL by its MBID.
mbid MBID

The MBID of the entity.
resource URLString

The web address of the URL entity to look up.
work Work

Look up a specific work by its MBID.
mbid MBID!

The MBID of the entity.

Medium

A medium is the actual physical medium the audio content is stored upon. This means that each CD in a multi-disc release will be entered as separate mediums within the release, and that both sides of a vinyl record or cassette will exist on one medium. Mediums have a format (e.g. CD, DVD, vinyl, cassette) and can optionally also have a title.

Field Argument Type Description
title String

The title of this particular medium.
format String

The format of the medium (e.g. CD, DVD, vinyl, cassette).
formatID MBID

The MBID associated with the value of the format field.
position Int

The order of this medium in the release (for example, in a multi-disc release).
trackCount Int

The number of audio tracks on this medium.
discs [Disc]

A list of physical discs and their disc IDs for this medium.
tracks [Track]

The list of tracks on the given media.

PageInfo

Information about pagination in a connection.

Field Argument Type Description
hasNextPage Boolean!

When paginating forwards, are there more items?
hasPreviousPage Boolean!

When paginating backwards, are there more items?
startCursor String

When paginating backwards, the cursor to continue.
endCursor String

When paginating forwards, the cursor to continue.

Place

A place is a venue, studio, or other place where music is performed, recorded, engineered, etc.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
name String

The official name of the entity.
disambiguation String

A comment used to help distinguish identically named entitites.
aliases [Alias]

Aliases are used to store alternate names or misspellings.
address String

The address describes the location of the place using the standard addressing format for the country it is located in.
area Area

The area entity representing the area, such as the city, in which the place is located.
coordinates Coordinates

The geographic coordinates of the place.
lifeSpan LifeSpan

The begin and end dates of the entity’s existence. Its exact meaning depends on the type of entity.
type String

The type categorises the place based on its primary function.
typeID MBID

The MBID associated with the value of the type field.
events EventConnection

A list of events linked to this entity.
after String
first Int
relationships Relationships

Relationships between this entity and other entitites.
collections CollectionConnection

A list of collections containing this entity.
after String
first Int
tags TagConnection

A list of tags linked to this entity.
after String
first Int

PlaceConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [PlaceEdge]

A list of edges.
nodes [Place]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

PlaceEdge

An edge in a connection.

Field Argument Type Description
node Place

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

Rating

Ratings allow users to rate MusicBrainz entities. User may assign a value between 1 and 5; these values are then aggregated by the server to compute an average community rating for the entity.

Field Argument Type Description
voteCount Int!

The number of votes that have contributed to the rating.
value Float

The average rating value based on the aggregated votes.

Recording

A recording is an entity in MusicBrainz which can be linked to tracks on releases. Each track must always be associated with a single recording, but a recording can be linked to any number of tracks.

A recording represents distinct audio that has been used to produce at least one released track through copying or mastering. A recording itself is never produced solely through copying or mastering.

Generally, the audio represented by a recording corresponds to the audio at a stage in the production process before any final mastering but after any editing or mixing.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
title String

The official title of the entity.
disambiguation String

A comment used to help distinguish identically named entitites.
aliases [Alias]

Aliases are used to store alternate names or misspellings.
artistCredit ⚠️ [ArtistCredit]

The main credited artist(s).

⚠️ DEPRECATED

The artistCredit field has been renamed to artistCredits, since it is a list of credits and is referred to in the plural form throughout the MusicBrainz documentation. This field is deprecated and will be removed in a major release in the future. Use the equivalent artistCredits field.
artistCredits [ArtistCredit]

The main credited artist(s).
isrcs [ISRC]

A list of International Standard Recording Codes (ISRCs) for this recording.
length Duration

An approximation to the length of the recording, calculated from the lengths of the tracks using it.
video Boolean

Whether this is a video recording.
artists ArtistConnection

A list of artists linked to this entity.
after String
first Int
releases ReleaseConnection

A list of releases linked to this entity.
type [ReleaseGroupType]

Filter by one or more release group types.
status [ReleaseStatus]

Filter by one or more release statuses.
after String
first Int
relationships Relationships

Relationships between this entity and other entitites.
collections CollectionConnection

A list of collections containing this entity.
after String
first Int
rating Rating

The rating users have given to this entity.
tags TagConnection

A list of tags linked to this entity.
after String
first Int

RecordingConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [RecordingEdge]

A list of edges.
nodes [Recording]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

RecordingEdge

An edge in a connection.

Field Argument Type Description
node Recording

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

Relationship

Relationships are a way to represent all the different ways in which entities are connected to each other and to URLs outside MusicBrainz.

Field Argument Type Description
target Entity!

The target entity.
direction String!

The direction of the relationship.
targetType String!

The type of entity on the receiving end of the relationship.
sourceCredit String

How the source entity was actually credited, if different from its main (performance) name.
targetCredit String

How the target entity was actually credited, if different from its main (performance) name.
begin Date

The date on which the relationship became applicable.
end Date

The date on which the relationship became no longer applicable.
ended Boolean

Whether the relationship still applies.
attributes [String]

Attributes which modify the relationship. There is a list of all attributes, but the attributes which are available, and how they should be used, depends on the relationship type.
type String

The type of relationship.
typeID MBID

The MBID associated with the value of the type field.

RelationshipConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [RelationshipEdge]

A list of edges.
nodes [Relationship]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

RelationshipEdge

An edge in a connection.

Field Argument Type Description
node Relationship

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

Relationships

Lists of entity relationships for each entity type.

Field Argument Type Description
areas RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int
artists RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int
events RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int
instruments RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int
labels RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int
places RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int
recordings RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int
releases RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int
releaseGroups RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int
series RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int
urls RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int
works RelationshipConnection

A list of relationships between these two entity types.
direction String

Filter by the relationship direction.
type String

Filter by the relationship type.
typeID MBID

The MBID associated with the value of the type field.
after String
first Int
before String
last Int

Release

A release represents the unique release (i.e. issuing) of a product on a specific date with specific release information such as the country, label, barcode, packaging, etc. If you walk into a store and purchase an album or single, they’re each represented in MusicBrainz as one release.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
title String

The official title of the entity.
disambiguation String

A comment used to help distinguish identically named entitites.
aliases [Alias]

Aliases are used to store alternate names or misspellings.
artistCredit ⚠️ [ArtistCredit]

The main credited artist(s).

⚠️ DEPRECATED

The artistCredit field has been renamed to artistCredits, since it is a list of credits and is referred to in the plural form throughout the MusicBrainz documentation. This field is deprecated and will be removed in a major release in the future. Use the equivalent artistCredits field.
artistCredits [ArtistCredit]

The main credited artist(s).
releaseEvents [ReleaseEvent]

The release events for this release.
date Date

The release date is the date in which a release was made available through some sort of distribution mechanism.
country String

The country in which the release was issued.
asin ASIN

The Amazon Standard Identification Number of the release.
barcode String

The barcode, if the release has one. The most common types found on releases are 12-digit UPCs and 13-digit EANs.
status ReleaseStatus

The status describes how “official” a release is.
statusID MBID

The MBID associated with the value of the status field.
packaging String

The physical packaging that accompanies the release. See the list of packaging for more information.
packagingID MBID

The MBID associated with the value of the packaging field.
quality String

Data quality indicates how good the data for a release is. It is not a mark of how good or bad the music itself is – for that, use ratings.
media [Medium]

The media on which the release was distributed.
artists ArtistConnection

A list of artists linked to this entity.
after String
first Int
labels LabelConnection

A list of labels linked to this entity.
after String
first Int
recordings RecordingConnection

A list of recordings linked to this entity.
after String
first Int
releaseGroups ReleaseGroupConnection

A list of release groups linked to this entity.
type [ReleaseGroupType]

Filter by one or more release group types.
after String
first Int
relationships Relationships

Relationships between this entity and other entitites.
collections CollectionConnection

A list of collections containing this entity.
after String
first Int
tags TagConnection

A list of tags linked to this entity.
after String
first Int

ReleaseConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [ReleaseEdge]

A list of edges.
nodes [Release]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

ReleaseEdge

An edge in a connection.

Field Argument Type Description
node Release

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

ReleaseEvent

The date on which a release was issued in a country/region with a particular label, catalog number, barcode, and format.

Field Argument Type Description
area Area
date Date

ReleaseGroup

A release group is used to group several different releases into a single logical entity. Every release belongs to one, and only one release group.

Both release groups and releases are “albums” in a general sense, but with an important difference: a release is something you can buy as media such as a CD or a vinyl record, while a release group embraces the overall concept of an album – it doesn’t matter how many CDs or editions/versions it had.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
title String

The official title of the entity.
disambiguation String

A comment used to help distinguish identically named entitites.
aliases [Alias]

Aliases are used to store alternate names or misspellings.
artistCredit ⚠️ [ArtistCredit]

The main credited artist(s).

⚠️ DEPRECATED

The artistCredit field has been renamed to artistCredits, since it is a list of credits and is referred to in the plural form throughout the MusicBrainz documentation. This field is deprecated and will be removed in a major release in the future. Use the equivalent artistCredits field.
artistCredits [ArtistCredit]

The main credited artist(s).
firstReleaseDate Date

The date of the earliest release in the group.
primaryType ReleaseGroupType

The type of a release group describes what kind of releases the release group represents, e.g. album, single, soundtrack, compilation, etc. A release group can have a “main” type and an unspecified number of additional types.
primaryTypeID MBID

The MBID associated with the value of the primaryType field.
secondaryTypes [ReleaseGroupType]

Additional types that apply to this release group.
secondaryTypeIDs [MBID]

The MBIDs associated with the values of the secondaryTypes field.
artists ArtistConnection

A list of artists linked to this entity.
after String
first Int
releases ReleaseConnection

A list of releases linked to this entity.
type [ReleaseGroupType]

Filter by one or more release group types.
status [ReleaseStatus]

Filter by one or more release statuses.
after String
first Int
relationships Relationships

Relationships between this entity and other entitites.
collections CollectionConnection

A list of collections containing this entity.
after String
first Int
rating Rating

The rating users have given to this entity.
tags TagConnection

A list of tags linked to this entity.
after String
first Int

ReleaseGroupConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [ReleaseGroupEdge]

A list of edges.
nodes [ReleaseGroup]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

ReleaseGroupEdge

An edge in a connection.

Field Argument Type Description
node ReleaseGroup

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

SearchQuery

A search for MusicBrainz entities using Lucene query syntax.

Field Argument Type Description
areas AreaConnection

Search for area entities matching the given query.
query String!

The query terms, in Lucene search syntax. See examples and search fields.
after String
first Int
artists ArtistConnection

Search for artist entities matching the given query.
query String!

The query terms, in Lucene search syntax. See examples and search fields.
after String
first Int
events EventConnection

Search for event entities matching the given query.
query String!

The query terms, in Lucene search syntax. See examples and search fields.
after String
first Int
instruments InstrumentConnection

Search for instrument entities matching the given query.
query String!

The query terms, in Lucene search syntax. See examples and search fields.
after String
first Int
labels LabelConnection

Search for label entities matching the given query.
query String!

The query terms, in Lucene search syntax. See examples and search fields.
after String
first Int
places PlaceConnection

Search for place entities matching the given query.
query String!

The query terms, in Lucene search syntax. See examples and search fields.
after String
first Int
recordings RecordingConnection

Search for recording entities matching the given query.
query String!

The query terms, in Lucene search syntax. See examples and search fields.
after String
first Int
releases ReleaseConnection

Search for release entities matching the given query.
query String!

The query terms, in Lucene search syntax. See examples and search fields.
after String
first Int
releaseGroups ReleaseGroupConnection

Search for release group entities matching the given query.
query String!

The query terms, in Lucene search syntax. See examples and search fields.
after String
first Int
series SeriesConnection

Search for series entities matching the given query.
query String!

The query terms, in Lucene search syntax. See examples and search fields.
after String
first Int
works WorkConnection

Search for work entities matching the given query.
query String!

The query terms, in Lucene search syntax. See examples and search fields.
after String
first Int

Series

A series is a sequence of separate release groups, releases, recordings, works or events with a common theme.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
name String

The official name of the entity.
disambiguation String

A comment used to help distinguish identically named entitites.
type String

The type primarily describes what type of entity the series contains.
typeID MBID

The MBID associated with the value of the type field.
relationships Relationships

Relationships between this entity and other entitites.
collections CollectionConnection

A list of collections containing this entity.
after String
first Int
tags TagConnection

A list of tags linked to this entity.
after String
first Int

SeriesConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [SeriesEdge]

A list of edges.
nodes [Series]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

SeriesEdge

An edge in a connection.

Field Argument Type Description
node Series

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

Tag

Tags are a way to mark entities with extra information – for example, the genres that apply to an artist, release, or recording.

Field Argument Type Description
name String!

The tag label.
count Int

How many times this tag has been applied to the entity.

TagConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [TagEdge]

A list of edges.
nodes [Tag]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

TagEdge

An edge in a connection.

Field Argument Type Description
node Tag

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

Track

A track is the way a recording is represented on a particular release (or, more exactly, on a particular medium). Every track has a title (see the guidelines for titles) and is credited to one or more artists.

Field Argument Type Description
mbid MBID!

The MBID of the entity.
title String

The official title of the entity.
position Int

The track’s position on the overall release (including all tracks from all discs).
number String

The track number, which may include information about the disc or side it appears on, e.g. “A1” or “B3”.
length Duration

The length of the track.
recording Recording

The recording that appears on the track.

URL

A URL pointing to a resource external to MusicBrainz, i.e. an official homepage, a site where music can be acquired, an entry in another database, etc.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
resource URLString!

The actual URL string.
relationships Relationships

Relationships between this entity and other entitites.

Work

A work is a distinct intellectual or artistic creation, which can be expressed in the form of one or more audio recordings.

Field Argument Type Description
id ID!

The ID of an object
mbid MBID!

The MBID of the entity.
title String

The official title of the entity.
disambiguation String

A comment used to help distinguish identically named entitites.
aliases [Alias]

Aliases are used to store alternate names or misspellings.
iswcs [String]

A list of ISWCs assigned to the work by copyright collecting agencies.
language String

The language in which the work was originally written.
type String

The type of work.
typeID MBID

The MBID associated with the value of the type field.
artists ArtistConnection

A list of artists linked to this entity.
after String
first Int
relationships Relationships

Relationships between this entity and other entitites.
collections CollectionConnection

A list of collections containing this entity.
after String
first Int
rating Rating

The rating users have given to this entity.
tags TagConnection

A list of tags linked to this entity.
after String
first Int

WorkConnection

A connection to a list of items.

Field Argument Type Description
pageInfo PageInfo!

Information to aid in pagination.
edges [WorkEdge]

A list of edges.
nodes [Work]

A list of nodes in the connection (without going through the edges field).
totalCount Int

A count of the total number of items in this connection, ignoring pagination.

WorkEdge

An edge in a connection.

Field Argument Type Description
node Work

The item at the end of the edge
cursor String!

A cursor for use in pagination
score Int

The relevancy score (0–100) assigned by the search engine, if these results were found through a search.

Enums

ReleaseGroupType

A type used to describe release groups, e.g. album, single, EP, etc.

Value Description
ALBUM

An album, perhaps better defined as a “Long Play” (LP) release, generally consists of previously unreleased material (unless this type is combined with secondary types which change that, such as “Compilation”). This includes album re-issues, with or without bonus tracks.
SINGLE

A single typically has one main song and possibly a handful of additional tracks or remixes of the main track. A single is usually named after its main song.
EP

An EP is a so-called “Extended Play” release and often contains the letters EP in the title. Generally an EP will be shorter than a full length release (an LP or “Long Play”) and the tracks are usually exclusive to the EP, in other words the tracks don’t come from a previously issued release. EP is fairly difficult to define; usually it should only be assumed that a release is an EP if the artist defines it as such.
OTHER

Any release that does not fit any of the other categories.
BROADCAST

An episodic release that was originally broadcast via radio, television, or the Internet, including podcasts.
COMPILATION

A compilation is a collection of previously released tracks by one or more artists.
SOUNDTRACK

A soundtrack is the musical score to a movie, TV series, stage show, computer game, etc.
SPOKENWORD

A non-music spoken word release.
INTERVIEW

An interview release contains an interview, generally with an artist.
AUDIOBOOK

An audiobook is a book read by a narrator without music.
LIVE

A release that was recorded live.
REMIX

A release that was (re)mixed from previously released material.
DJMIX

A DJ-mix is a sequence of several recordings played one after the other, each one modified so that they blend together into a continuous flow of music. A DJ mix release requires that the recordings be modified in some manner, and the DJ who does this modification is usually (although not always) credited in a fairly prominent way.
MIXTAPE

Promotional in nature (but not necessarily free), mixtapes and street albums are often released by artists to promote new artists, or upcoming studio albums by prominent artists. They are also sometimes used to keep fans’ attention between studio releases and are most common in rap & hip hop genres. They are often not sanctioned by the artist’s label, may lack proper sample or song clearances and vary widely in production and recording quality. While mixtapes are generally DJ-mixed, they are distinct from commercial DJ mixes (which are usually deemed compilations) and are defined by having a significant proportion of new material, including original production or original vocals over top of other artists’ instrumentals. They are distinct from demos in that they are designed for release directly to the public and fans, not to labels.
DEMO

A release that was recorded for limited circulation or reference use rather than for general public release.
NAT

A non-album track (special case).

ReleaseStatus

A type used to describe the status of releases, e.g. official, bootleg, etc.

Value Description
OFFICIAL

Any release officially sanctioned by the artist and/or their record company. (Most releases will fit into this category.)
PROMOTION

A giveaway release or a release intended to promote an upcoming official release, e.g. prerelease albums or releases included with a magazine.
BOOTLEG

An unofficial/underground release that was not sanctioned by the artist and/or the record company.
PSEUDORELEASE

A pseudo-release is a duplicate release for translation/transliteration purposes.

Scalars

ASIN

An Amazon Standard Identification Number (ASIN) is a 10-character alphanumeric unique identifier assigned by Amazon.com and its partners for product identification within the Amazon organization.

Boolean

The Boolean scalar type represents true or false.

Date

Year, month (optional), and day (optional) in YYYY-MM-DD format.

Degrees

Decimal degrees, used for latitude and longitude.

DiscID

Disc ID is the code number which MusicBrainz uses to link a physical CD to a release listing.

A release may have any number of disc IDs, and a disc ID may be linked to multiple releases. This is because disc ID calculation involves a hash of the frame offsets of the CD tracks.

Different pressing of a CD often have slightly different frame offsets, and hence different disc IDs.

Conversely, two different CDs may happen to have exactly the same set of frame offsets and hence the same disc ID.

Duration

A length of time, in milliseconds.

Float

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

ID

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

IPI

An Interested Parties Information (IPI) code is an identifying number assigned by the CISAC database for musical rights management.

ISNI

The International Standard Name Identifier (ISNI) is an ISO standard for uniquely identifying the public identities of contributors to media content.

ISRC

The International Standard Recording Code (ISRC) is an identification system for audio and music video recordings. It is standarized by the IFPI in ISO 3901:2001 and used by IFPI members to assign a unique identifier to every distinct sound recording they release. An ISRC identifies a particular sound recording, not the song itself. Therefore, different recordings, edits, remixes and remasters of the same song will each be assigned their own ISRC. However, note that same recording should carry the same ISRC in all countries/territories. Songs are identified by analogous International Standard Musical Work Codes (ISWCs).

ISWC

The International Standard Musical Work Code (ISWC) is an ISO standard similar to ISBNs for identifying musical works / compositions.

Int

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Locale

Language code, optionally with country and encoding.

MBID

The MBID scalar represents MusicBrainz identifiers, which are 36-character UUIDs.

String

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Time

A time of day, in 24-hour hh:mm notation.

URLString

A web address.

Interfaces

Entity

An entity in the MusicBrainz schema.

Field Argument Type Description
mbid MBID!

The MBID of the entity.

Node

An object with an ID

Field Argument Type Description
id ID!

The id of the object.