# Schema Types You may also be interested in the [schema in GraphQL syntax](schema.md).
**Table of Contents**

## Query The query root, from which multiple types of MusicBrainz requests can be made.
Field / ArgumentTypeDescription
node Node Fetches an object given its ID
id [ID](#id)! The ID of an object
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.
## Objects ### Alias [Aliases](https://musicbrainz.org/doc/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. They are available for artists, labels, and works.
Field / ArgumentTypeDescription
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 String 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](https://musicbrainz.org/doc/Area) are geographic regions or settlements (countries, cities, or the like).
Field / ArgumentTypeDescription
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.
artists ArtistConnection A list of artists linked to this entity.
after [String](#string)
first [Int](#int)
events EventConnection A list of events linked to this entity.
after [String](#string)
first [Int](#int)
labels LabelConnection A list of labels linked to this entity.
after [String](#string)
first [Int](#int)
places PlaceConnection A list of places linked to this entity.
after [String](#string)
first [Int](#int)
releases ReleaseConnection A list of releases linked to this entity.
after [String](#string)
first [Int](#int)
type [[ReleaseGroupType](#releasegrouptype)] Filter by one or more release group types.
status [[ReleaseStatus](#releasestatus)] Filter by one or more release statuses.
relationships Relationships Relationships between this entity and other entitites.
tags TagConnection A list of tags linked to this entity.
after [String](#string)
first [Int](#int)
### AreaConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [AreaEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### AreaEdge An edge in a connection.
Field / ArgumentTypeDescription
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](https://musicbrainz.org/doc/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 / ArgumentTypeDescription
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 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.
recordings RecordingConnection A list of recordings linked to this entity.
after [String](#string)
first [Int](#int)
releases ReleaseConnection A list of releases linked to this entity.
after [String](#string)
first [Int](#int)
type [[ReleaseGroupType](#releasegrouptype)] Filter by one or more release group types.
status [[ReleaseStatus](#releasestatus)] Filter by one or more release statuses.
releaseGroups ReleaseGroupConnection A list of release groups linked to this entity.
after [String](#string)
first [Int](#int)
type [[ReleaseGroupType](#releasegrouptype)] Filter by one or more release group types.
works WorkConnection A list of works linked to this entity.
after [String](#string)
first [Int](#int)
relationships Relationships Relationships between this entity and other entitites.
tags TagConnection A list of tags linked to this entity.
after [String](#string)
first [Int](#int)
### ArtistConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [ArtistEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### ArtistCredit [Artist credits](https://musicbrainz.org/doc/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 / ArgumentTypeDescription
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 / ArgumentTypeDescription
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 / ArgumentTypeDescription
areas AreaConnection Browse area entities linked to the given arguments.
after [String](#string)
first [Int](#int)
collection [MBID](#mbid) The MBID of a collection in which the entity is found.
artists ArtistConnection Browse artist entities linked to the given arguments.
after [String](#string)
first [Int](#int)
area [MBID](#mbid) The MBID of an area to which the entity is linked.
collection [MBID](#mbid) The MBID of a collection in which the entity is found.
recording [MBID](#mbid) The MBID of a recording to which the entity is linked.
release [MBID](#mbid) The MBID of a release to which the entity is linked.
releaseGroup [MBID](#mbid) The MBID of a release group to which the entity is linked.
work [MBID](#mbid) The MBID of a work to which the artist is linked.
events EventConnection Browse event entities linked to the given arguments.
after [String](#string)
first [Int](#int)
area [MBID](#mbid) The MBID of an area to which the entity is linked.
artist [MBID](#mbid) The MBID of an artist to which the entity is linked.
collection [MBID](#mbid) The MBID of a collection in which the entity is found.
place [MBID](#mbid) The MBID of a place to which the event is linked.
labels LabelConnection Browse label entities linked to the given arguments.
after [String](#string)
first [Int](#int)
area [MBID](#mbid) The MBID of an area to which the entity is linked.
collection [MBID](#mbid) The MBID of a collection in which the entity is found.
release [MBID](#mbid) The MBID of a release to which the entity is linked.
places PlaceConnection Browse place entities linked to the given arguments.
after [String](#string)
first [Int](#int)
area [MBID](#mbid) The MBID of an area to which the entity is linked.
collection [MBID](#mbid) The MBID of a collection in which the entity is found.
recordings RecordingConnection Browse recording entities linked to the given arguments.
after [String](#string)
first [Int](#int)
artist [MBID](#mbid) The MBID of an artist to which the entity is linked.
collection [MBID](#mbid) The MBID of a collection in which the entity is found.
release [MBID](#mbid) The MBID of a release to which the entity is linked.
releases ReleaseConnection Browse release entities linked to the given arguments.
after [String](#string)
first [Int](#int)
area [MBID](#mbid) The MBID of an area to which the entity is linked.
artist [MBID](#mbid) The MBID of an artist to which the entity is linked.
collection [MBID](#mbid) The MBID of a collection in which the entity is found.
label [MBID](#mbid) The MBID of a label to which the release is linked.
track [MBID](#mbid) The MBID of a track that is included in the release.
trackArtist [MBID](#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.
recording [MBID](#mbid) The MBID of a recording to which the entity is linked.
releaseGroup [MBID](#mbid) The MBID of a release group to which the entity is linked.
releaseGroups ReleaseGroupConnection Browse release group entities linked to the given arguments.
after [String](#string)
first [Int](#int)
artist [MBID](#mbid) The MBID of an artist to which the entity is linked.
collection [MBID](#mbid) The MBID of a collection in which the entity is found.
release [MBID](#mbid) The MBID of a release to which the entity is linked.
works WorkConnection Browse work entities linked to the given arguments.
after [String](#string)
first [Int](#int)
artist [MBID](#mbid) The MBID of an artist to which the entity is linked.
collection [MBID](#mbid) The MBID of a collection in which the entity is found.
urls URLConnection Browse URL entities linked to the given arguments.
after [String](#string)
first [Int](#int)
resource [URLString](#urlstring) The web address for which to browse URL entities.
### Coordinates Geographic coordinates described with latitude and longitude.
Field / ArgumentTypeDescription
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.
### Event An [event](https://musicbrainz.org/doc/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 / ArgumentTypeDescription
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.
tags TagConnection A list of tags linked to this entity.
after [String](#string)
first [Int](#int)
### EventConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [EventEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### EventEdge An edge in a connection.
Field / ArgumentTypeDescription
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](https://musicbrainz.org/doc/Instrument) are devices created or adapted to make musical sounds. Instruments are primarily used in relationships between two other entities.
Field / ArgumentTypeDescription
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.
tags TagConnection A list of tags linked to this entity.
after [String](#string)
first [Int](#int)
### InstrumentConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [InstrumentEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### InstrumentEdge An edge in a connection.
Field / ArgumentTypeDescription
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](https://musicbrainz.org/doc/Label) represent mostly (but not only) imprints. To a lesser extent, a label entity may be created to represent a record company.
Field / ArgumentTypeDescription
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 IPI (interested party 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.
after [String](#string)
first [Int](#int)
type [[ReleaseGroupType](#releasegrouptype)] Filter by one or more release group types.
status [[ReleaseStatus](#releasestatus)] Filter by one or more release statuses.
relationships Relationships Relationships between this entity and other entitites.
tags TagConnection A list of tags linked to this entity.
after [String](#string)
first [Int](#int)
### LabelConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [LabelEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### LabelEdge An edge in a connection.
Field / ArgumentTypeDescription
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 / ArgumentTypeDescription
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 / ArgumentTypeDescription
area Area Look up a specific area by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
artist Artist Look up a specific artist by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
event Event Look up a specific event by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
instrument Instrument Look up a specific instrument by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
label Label Look up a specific label by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
place Place Look up a specific place by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
recording Recording Look up a specific recording by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
release Release Look up a specific release by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
releaseGroup ReleaseGroup Look up a specific release group by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
series Series Look up a specific series by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
url URL Look up a specific URL by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
work Work Look up a specific work by its MBID.
mbid [MBID](#mbid)! The MBID of the entity.
### PageInfo Information about pagination in a connection.
Field / ArgumentTypeDescription
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](https://musicbrainz.org/doc/Place) is a venue, studio or other place where music is performed, recorded, engineered, etc.
Field / ArgumentTypeDescription
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](#string)
first [Int](#int)
relationships Relationships Relationships between this entity and other entitites.
tags TagConnection A list of tags linked to this entity.
after [String](#string)
first [Int](#int)
### PlaceConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [PlaceEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### PlaceEdge An edge in a connection.
Field / ArgumentTypeDescription
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.
### Recording A [recording](https://musicbrainz.org/doc/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 / ArgumentTypeDescription
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).
length Int 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](#string)
first [Int](#int)
releases ReleaseConnection A list of releases linked to this entity.
after [String](#string)
first [Int](#int)
type [[ReleaseGroupType](#releasegrouptype)] Filter by one or more release group types.
status [[ReleaseStatus](#releasestatus)] Filter by one or more release statuses.
relationships Relationships Relationships between this entity and other entitites.
tags TagConnection A list of tags linked to this entity.
after [String](#string)
first [Int](#int)
### RecordingConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [RecordingEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### RecordingEdge An edge in a connection.
Field / ArgumentTypeDescription
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](https://musicbrainz.org/doc/Relationships) are a way to represent all the different ways in which entities are connected to each other and to URLs outside MusicBrainz.
Field / ArgumentTypeDescription
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 / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [RelationshipEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### RelationshipEdge An edge in a connection.
Field / ArgumentTypeDescription
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 / ArgumentTypeDescription
areas RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
artists RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
events RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
instruments RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
labels RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
places RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
recordings RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
releases RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
releaseGroups RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
series RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
urls RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
works RelationshipConnection A list of relationships between these two entity types.
after [String](#string)
first [Int](#int)
before [String](#string)
last [Int](#int)
direction [String](#string) Filter by the relationship direction.
type [String](#string) Filter by the relationship type.
typeID [MBID](#mbid) The MBID associated with the value of the type field.
### Release A [release](https://musicbrainz.org/doc/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 / ArgumentTypeDescription
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).
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.
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.
artists ArtistConnection A list of artists linked to this entity.
after [String](#string)
first [Int](#int)
labels LabelConnection A list of labels linked to this entity.
after [String](#string)
first [Int](#int)
recordings RecordingConnection A list of recordings linked to this entity.
after [String](#string)
first [Int](#int)
releaseGroups ReleaseGroupConnection A list of release groups linked to this entity.
after [String](#string)
first [Int](#int)
type [[ReleaseGroupType](#releasegrouptype)] Filter by one or more release group types.
relationships Relationships Relationships between this entity and other entitites.
tags TagConnection A list of tags linked to this entity.
after [String](#string)
first [Int](#int)
### ReleaseConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [ReleaseEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### ReleaseEdge An edge in a connection.
Field / ArgumentTypeDescription
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 Date on which a release was issued in a country/region with a particular label, catalog number, barcode, and what release format was used.
Field / ArgumentTypeDescription
area Area
date Date
### ReleaseGroup A [release group](https://musicbrainz.org/doc/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 / ArgumentTypeDescription
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).
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](#string)
first [Int](#int)
releases ReleaseConnection A list of releases linked to this entity.
after [String](#string)
first [Int](#int)
type [[ReleaseGroupType](#releasegrouptype)] Filter by one or more release group types.
status [[ReleaseStatus](#releasestatus)] Filter by one or more release statuses.
relationships Relationships Relationships between this entity and other entitites.
tags TagConnection A list of tags linked to this entity.
after [String](#string)
first [Int](#int)
### ReleaseGroupConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [ReleaseGroupEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### ReleaseGroupEdge An edge in a connection.
Field / ArgumentTypeDescription
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 / ArgumentTypeDescription
areas AreaConnection Search for area entities matching the given query.
query [String](#string)! The query terms, in Lucene search syntax. See examples and search fields.
after [String](#string)
first [Int](#int)
artists ArtistConnection Search for artist entities matching the given query.
query [String](#string)! The query terms, in Lucene search syntax. See examples and search fields.
after [String](#string)
first [Int](#int)
events EventConnection Search for event entities matching the given query.
query [String](#string)! The query terms, in Lucene search syntax. See examples and search fields.
after [String](#string)
first [Int](#int)
instruments InstrumentConnection Search for instrument entities matching the given query.
query [String](#string)! The query terms, in Lucene search syntax. See examples and search fields.
after [String](#string)
first [Int](#int)
labels LabelConnection Search for label entities matching the given query.
query [String](#string)! The query terms, in Lucene search syntax. See examples and search fields.
after [String](#string)
first [Int](#int)
places PlaceConnection Search for place entities matching the given query.
query [String](#string)! The query terms, in Lucene search syntax. See examples and search fields.
after [String](#string)
first [Int](#int)
recordings RecordingConnection Search for recording entities matching the given query.
query [String](#string)! The query terms, in Lucene search syntax. See examples and search fields.
after [String](#string)
first [Int](#int)
releases ReleaseConnection Search for release entities matching the given query.
query [String](#string)! The query terms, in Lucene search syntax. See examples and search fields.
after [String](#string)
first [Int](#int)
releaseGroups ReleaseGroupConnection Search for release group entities matching the given query.
query [String](#string)! The query terms, in Lucene search syntax. See examples and search fields.
after [String](#string)
first [Int](#int)
series SeriesConnection Search for series entities matching the given query.
query [String](#string)! The query terms, in Lucene search syntax. See examples and search fields.
after [String](#string)
first [Int](#int)
works WorkConnection Search for work entities matching the given query.
query [String](#string)! The query terms, in Lucene search syntax. See examples and search fields.
after [String](#string)
first [Int](#int)
### Series A [series](https://musicbrainz.org/doc/Series) is a sequence of separate release groups, releases, recordings, works or events with a common theme.
Field / ArgumentTypeDescription
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.
tags TagConnection A list of tags linked to this entity.
after [String](#string)
first [Int](#int)
### SeriesConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [SeriesEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### SeriesEdge An edge in a connection.
Field / ArgumentTypeDescription
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](https://musicbrainz.org/tags) are a way to mark entities with extra information – for example, the genres that apply to an artist, release, or recording.
Field / ArgumentTypeDescription
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 / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [TagEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### TagEdge An edge in a connection.
Field / ArgumentTypeDescription
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.
### URL A [URL](https://musicbrainz.org/doc/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 / ArgumentTypeDescription
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.
### URLConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [URLEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### URLEdge An edge in a connection.
Field / ArgumentTypeDescription
node URL 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.
### Work A [work](https://musicbrainz.org/doc/Work) is a distinct intellectual or artistic creation, which can be expressed in the form of one or more audio recordings.
Field / ArgumentTypeDescription
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](#string)
first [Int](#int)
relationships Relationships Relationships between this entity and other entitites.
tags TagConnection A list of tags linked to this entity.
after [String](#string)
first [Int](#int)
### WorkConnection A connection to a list of items.
Field / ArgumentTypeDescription
pageInfo PageInfo! Information to aid in pagination.
edges [WorkEdge] A list of edges.
totalCount Int A count of the total number of items in this connection, ignoring pagination.
### WorkEdge An edge in a connection.
Field / ArgumentTypeDescription
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
ValueDescription
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
ValueDescription
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 ### 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. ### 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 [IPI](https://musicbrainz.org/doc/IPI) (interested party information) code is an identifying number assigned by the CISAC database for musical rights management. ### Int The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1. ### 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. ### Node An object with an ID