# Schema Types You may also be interested in reading the [schema in GraphQL syntax](schema.md).

Table of Contents

* [Query](#query) * [Objects](#objects) * [Alias](#alias) * [Area](#area) * [AreaConnection](#areaconnection) * [AreaEdge](#areaedge) * [Artist](#artist) * [ArtistConnection](#artistconnection) * [ArtistCredit](#artistcredit) * [ArtistEdge](#artistedge) * [BrowseQuery](#browsequery) * [Collection](#collection) * [CollectionConnection](#collectionconnection) * [CollectionEdge](#collectionedge) * [Coordinates](#coordinates) * [CoverArtImage](#coverartimage) * [CoverArtImageThumbnails](#coverartimagethumbnails) * [Disc](#disc) * [Event](#event) * [EventConnection](#eventconnection) * [EventEdge](#eventedge) * [Instrument](#instrument) * [InstrumentConnection](#instrumentconnection) * [InstrumentEdge](#instrumentedge) * [Label](#label) * [LabelConnection](#labelconnection) * [LabelEdge](#labeledge) * [LifeSpan](#lifespan) * [LookupQuery](#lookupquery) * [Medium](#medium) * [PageInfo](#pageinfo) * [Place](#place) * [PlaceConnection](#placeconnection) * [PlaceEdge](#placeedge) * [Rating](#rating) * [Recording](#recording) * [RecordingConnection](#recordingconnection) * [RecordingEdge](#recordingedge) * [Relationship](#relationship) * [RelationshipConnection](#relationshipconnection) * [RelationshipEdge](#relationshipedge) * [Relationships](#relationships) * [Release](#release) * [ReleaseConnection](#releaseconnection) * [ReleaseCoverArt](#releasecoverart) * [ReleaseEdge](#releaseedge) * [ReleaseEvent](#releaseevent) * [ReleaseGroup](#releasegroup) * [ReleaseGroupConnection](#releasegroupconnection) * [ReleaseGroupCoverArt](#releasegroupcoverart) * [ReleaseGroupEdge](#releasegroupedge) * [SearchQuery](#searchquery) * [Series](#series) * [SeriesConnection](#seriesconnection) * [SeriesEdge](#seriesedge) * [Tag](#tag) * [TagConnection](#tagconnection) * [TagEdge](#tagedge) * [URL](#url) * [Work](#work) * [WorkConnection](#workconnection) * [WorkEdge](#workedge) * [Enums](#enums) * [CoverArtImageSize](#coverartimagesize) * [ReleaseGroupType](#releasegrouptype) * [ReleaseStatus](#releasestatus) * [Scalars](#scalars) * [ASIN](#asin) * [Boolean](#boolean) * [Date](#date) * [Degrees](#degrees) * [DiscID](#discid) * [Duration](#duration) * [ID](#id) * [IPI](#ipi) * [ISNI](#isni) * [ISRC](#isrc) * [ISWC](#iswc) * [Int](#int) * [Locale](#locale) * [MBID](#mbid) * [String](#string) * [Time](#time) * [URLString](#urlstring) * [Interfaces](#interfaces) * [Entity](#entity) * [Node](#node)

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

Field	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](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.

Field	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](https://musicbrainz.org/doc/Area) are geographic regions or settlements (countries, cities, or the like).

Field	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](https://musicbrainz.org/doc/Aliases) are used to store alternate names or misspellings.
isoCodes	[String]	[ISO 3166 codes](https://en.wikipedia.org/wiki/ISO_3166) are the codes assigned by ISO to countries and subdivisions.
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	Type	Description
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	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](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	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](https://musicbrainz.org/doc/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](https://musicbrainz.org/doc/IPI) (IPI) codes for the artist.
isnis	[ISNI]	List of [International Standard Name Identifier](https://musicbrainz.org/doc/ISNI) (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	Type	Description
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	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	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	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](https://musicbrainz.org/doc/ISRC) (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](https://musicbrainz.org/doc/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](https://musicbrainz.org/doc/ISWC) (ISWC) of the work.
after	String
first	Int

### Collection [Collections](https://musicbrainz.org/doc/Collections) are lists of entities that users can create.

Field	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	Type	Description
pageInfo	PageInfo!	Information to aid in pagination.
edges	[CollectionEdge]	A list of edges.
totalCount	Int	A count of the total number of items in this connection, ignoring pagination.

### CollectionEdge An edge in a connection.

Field	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.

### CoverArtImage An individual piece of album artwork from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive).

Field	Type	Description
fileID	String!	The Internet Archive’s internal file ID for the image.
image	URLString!	The URL at which the image can be found.
thumbnails	CoverArtImageThumbnails	A set of thumbnails for the image.
front	Boolean!	Whether this image depicts the “main front” of the release.
back	Boolean!	Whether this image depicts the “main back” of the release.
types	[String]	A list of [image types](https://musicbrainz.org/doc/Cover_Art/Types) describing what part(s) of the release the image includes.
edit	Int	The MusicBrainz edit ID.
approved	Boolean	Whether the image was approved by the MusicBrainz edit system.
comment	String	A free-text comment left for the image.

### CoverArtImageThumbnails URLs for thumbnails of different sizes for a particular piece of cover art.

Field	Argument	Type	Description
small		URLString	The URL of a small version of the cover art, where the maximum dimension is 250px.
large		URLString	The URL of a large version of the cover art, where the maximum dimension is 500px.

### Disc Information about the physical CD and releases associated with a particular [disc ID](https://musicbrainz.org/doc/Disc_ID).

Field	Type	Description
id	ID!	The ID of an object
discID	DiscID!	The [disc ID](https://musicbrainz.org/doc/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](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	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](https://musicbrainz.org/doc/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](https://musicbrainz.org/doc/Event/Setlist) 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	Type	Description
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	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](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	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](https://musicbrainz.org/doc/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](https://en.wikipedia.org/wiki/Hornbostel%E2%80%93Sachs) 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	Type	Description
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	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](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	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](https://musicbrainz.org/doc/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](https://musicbrainz.org/doc/Label/Label_Code) of the label.
ipis	[IPI]	List of [Interested Parties Information](https://musicbrainz.org/doc/IPI) 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	Type	Description
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	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	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	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](https://musicbrainz.org/doc/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	Type	Description
title	String	The title of this particular medium.
format	String	The [format](https://musicbrainz.org/doc/Release/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.

### PageInfo Information about pagination in a connection.

Field	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](https://musicbrainz.org/doc/Place) is a venue, studio, or other place where music is performed, recorded, engineered, etc.

Field	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](https://musicbrainz.org/doc/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	Type	Description
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	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](https://musicbrainz.org/doc/Rating_System) 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		Int	The average rating value based on the aggregated votes.

### 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	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](https://musicbrainz.org/doc/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](https://musicbrainz.org/doc/ISRC) (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	Type	Description
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	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](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	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](https://musicbrainz.org/relationship-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	Type	Description
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	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	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](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	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](https://musicbrainz.org/doc/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](https://musicbrainz.org/doc/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](https://musicbrainz.org/doc/ASIN) of the release.
barcode	String	The [barcode](https://en.wikipedia.org/wiki/Barcode), if the release has one. The most common types found on releases are 12-digit [UPCs](https://en.wikipedia.org/wiki/Universal_Product_Code) and 13-digit [EANs](https://en.wikipedia.org/wiki/International_Article_Number).
coverArt	ReleaseCoverArt!	A list and summary of the cover art images that are present for this release from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive).
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](https://musicbrainz.org/doc/Release/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](https://musicbrainz.org/doc/Rating_System).
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	Type	Description
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.

### ReleaseCoverArt An object containing a list of the cover art images for a release obtained from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive), as well as a summary of what artwork is available.

Field	Type	Description
front	URLString	The URL of an image depicting the album cover or “main front” of the release, i.e. the front of the packaging of the audio recording (or in the case of a digital release, the image associated with it in a digital media store). In the MusicBrainz schema, this field is a Boolean value indicating the presence of a front image, whereas here the value is the URL for the image itself if one exists. You can check for null if you just want to determine the presence of an image.
size	CoverArtImageSize	The size of the image to retrieve. By default, the returned image will have its full original dimensions, but certain thumbnail sizes may be retrieved as well.
back	URLString	The URL of an image depicting the “main back” of the release, i.e. the back of the packaging of the audio recording. In the MusicBrainz schema, this field is a Boolean value indicating the presence of a back image, whereas here the value is the URL for the image itself. You can check for null if you just want to determine the presence of an image.
size	CoverArtImageSize	The size of the image to retrieve. By default, the returned image will have its full original dimensions, but certain thumbnail sizes may be retrieved as well.
images	[CoverArtImage]	A list of images depicting the different sides and surfaces of a release’s media and packaging.
artwork	Boolean!	Whether there is artwork present for this release.
darkened	Boolean!	Whether the Cover Art Archive has received a take-down request for this release’s artwork, disallowing new uploads.
count	Int!	The number of artwork images present for this release.
release	Release!	The particular release shown in the returned cover art.

### ReleaseEdge An edge in a connection.

Field	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](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	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](https://musicbrainz.org/doc/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](https://musicbrainz.org/doc/Release_Group/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](https://musicbrainz.org/doc/Release_Group/Type) that apply to this release group.
secondaryTypeIDs	[MBID]	The MBIDs associated with the values of the `secondaryTypes` field.
coverArt	ReleaseGroupCoverArt	The cover art for a release group, obtained from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive).
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	Type	Description
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.

### ReleaseGroupCoverArt An object containing the cover art for a release group obtained from the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive). For release groups, just the front cover of a particular release will be selected.

Field	Type	Description
front	URLString	The URL of an image depicting the album cover or “main front” of a release in the release group, i.e. the front of the packaging of the audio recording (or in the case of a digital release, the image associated with it in a digital media store).
size	CoverArtImageSize	The size of the image to retrieve. By default, the returned image will have its full original dimensions, but certain thumbnail sizes may be retrieved as well.
images	[CoverArtImage]	A list of images returned by the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive) for a release group. A particular release’s front image will be included in the list, and likely no others, even if other images are available.
artwork	Boolean!	Whether there is artwork present for this release group.
release	Release!	The particular release shown in the returned cover art.

### ReleaseGroupEdge An edge in a connection.

Field	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	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](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search).
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](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search).
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](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search).
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](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search).
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](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search).
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](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search).
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](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search).
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](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search).
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](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search).
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](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search).
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](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search).
after	String
first	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	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	Type	Description
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	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](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	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	Type	Description
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	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.

### 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	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](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	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](https://musicbrainz.org/doc/Aliases) are used to store alternate names or misspellings.
iswcs	[String]	A list of [ISWCs](https://musicbrainz.org/doc/ISWC) 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	Type	Description
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	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 ### CoverArtImageSize The image sizes that may be requested at the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive).

Value	Description
SMALL	A maximum dimension of 250px.
LARGE	A maximum dimension of 500px.
FULL	The image’s original dimensions, with no maximum.

### 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](https://musicbrainz.org/doc/ASIN) (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](https://musicbrainz.org/doc/Disc_ID) is the code number which MusicBrainz uses to link a physical CD to a [release](https://musicbrainz.org/doc/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. ### 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](https://musicbrainz.org/doc/IPI) (IPI) code is an identifying number assigned by the CISAC database for musical rights management. ### ISNI The [International Standard Name Identifier](https://musicbrainz.org/doc/ISNI) (ISNI) is an ISO standard for uniquely identifying the public identities of contributors to media content. ### ISRC The [International Standard Recording Code](https://musicbrainz.org/doc/ISRC) (ISRC) is an identification system for audio and music video recordings. It is standarized by the [IFPI](http://www.ifpi.org/) 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](https://musicbrainz.org/doc/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](https://musicbrainz.org/doc/ISWC) (ISWCs). ### ISWC The [International Standard Musical Work Code](https://musicbrainz.org/doc/ISWC) (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.