diff --git a/docs/types.md b/docs/types.md index 6e5ab1e..a5fc121 100644 --- a/docs/types.md +++ b/docs/types.md @@ -99,48 +99,63 @@ You may also be interested in reading the [schema in GraphQL syntax](schema.md). The query root, from which multiple types of MusicBrainz requests can be made. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
lookupLookupQuery + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
lookupLookupQuery + Perform a lookup of a MusicBrainz entity by its MBID. -
browseBrowseQuery + +
browseBrowseQuery + Browse all MusicBrainz entities directly linked to another entity. -
searchSearchQuery + +
searchSearchQuery + Search for MusicBrainz entities using Lucene query syntax. -
nodeNode + +
nodeNode + Fetches an object given its ID -
idID!The ID of an object
+ +
idID! + +The ID of an object + +
## Objects @@ -150,333 +165,413 @@ Fetches an object given its ID 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. - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FieldArgumentTypeDescription
nameString + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - -
FieldArgumentTypeDescription
nameString + The aliased name of the entity. -
sortNameString -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). -
localeLocale -The locale (language and/or country) in which the alias is used. -
primaryBoolean -Whether this is the main alias for the entity in the specified locale (this could -mean the most recent or the most common). -
typeString -The type or purpose of the alias – whether it is a variant, search hint, etc. -
typeIDMBID -The MBID associated with the value of the type field. -
+ +
sortNameString + +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). + +
localeLocale + +The locale (language and/or country) in which the alias is +used. + +
primaryBoolean + +Whether this is the main alias for the entity in the +specified locale (this could mean the most recent or the most common). + +
typeString + +The type or purpose of the alias – whether it is a variant, +search hint, etc. + +
typeIDMBID + +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). - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
nameString + +
nameString + The official name of the entity. -
sortNameString -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). -
disambiguationString + +
sortNameString + +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). + +
disambiguationString + 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. -
artistsArtistConnection + +
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. + +
artistsArtistConnection + A list of artists linked to this entity. -
afterString
firstInt
eventsEventConnection + +
afterString
firstInt
eventsEventConnection + A list of events linked to this entity. -
afterString
firstInt
labelsLabelConnection + +
afterString
firstInt
labelsLabelConnection + A list of labels linked to this entity. -
afterString
firstInt
placesPlaceConnection + +
afterString
firstInt
placesPlaceConnection + A list of places linked to this entity. -
afterString
firstInt
releasesReleaseConnection + +
afterString
firstInt
releasesReleaseConnection + 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.
afterString
firstInt
relationshipsRelationships + +
type[ReleaseGroupType] + +Filter by one or more release group types. + +
status[ReleaseStatus] + +Filter by one or more release statuses. + +
afterString
firstInt
relationshipsRelationships + Relationships between this entity and other entitites. -
collectionsCollectionConnection + +
collectionsCollectionConnection + A list of collections containing this entity. -
afterString
firstInt
tagsTagConnection + +
afterString
firstInt
tagsTagConnection + A list of tags linked to this entity. -
afterString
firstInt
+ +
afterString
firstInt
### AreaConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[AreaEdge] + +
edges[AreaEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### AreaEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeArea + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeArea + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +The relevancy score (0–100) assigned by the search engine, if +these results were found through a search. + +
### Artist @@ -486,310 +581,388 @@ 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. - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
nameString + +
nameString + The official name of the entity. -
sortNameString -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). -
disambiguationString + +
sortNameString + +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). + +
disambiguationString + A comment used to help distinguish identically named entitites. -
aliases[Alias] -Aliases are used to store alternate -names or misspellings. -
countryString -The country with which an artist is primarily identified. It is often, but not -always, its birth/formation country. -
areaArea -The area with which an artist is primarily identified. It is often, but not always, -its birth/formation country. -
beginAreaArea -The area in which an artist began their career (or where they were born, if the -artist is a person). -
endAreaArea -The area in which an artist ended their career (or where they died, if the artist -is a person). -
lifeSpanLifeSpan -The begin and end dates of the entity’s existence. Its exact meaning depends on -the type of entity. -
genderString -Whether a person or character identifies as male, female, or neither. Groups do -not have genders. -
genderIDMBID -The MBID associated with the value of the gender field. -
typeString + +
aliases[Alias] + +[Aliases](https://musicbrainz.org/doc/Aliases) are used to store +alternate names or misspellings. + +
countryString + +The country with which an artist is primarily identified. It +is often, but not always, its birth/formation country. + +
areaArea + +The area with which an artist is primarily identified. It +is often, but not always, its birth/formation country. + +
beginAreaArea + +The area in which an artist began their career (or where +they were born, if the artist is a person). + +
endAreaArea + +The area in which an artist ended their career (or where +they died, if the artist is a person). + +
lifeSpanLifeSpan + +The begin and end dates of the entity’s existence. Its exact +meaning depends on the type of entity. + +
genderString + +Whether a person or character identifies as male, female, or +neither. Groups do not have genders. + +
genderIDMBID + +The MBID associated with the value of the `gender` +field. + +
typeString + Whether an artist is a person, a group, or something else. -
typeIDMBID -The MBID associated with the value of the type field. -
ipis[IPI] -List of Interested Parties Information + +
typeIDMBID + +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 (ISNI) codes for the artist. -
recordingsRecordingConnection + +
isnis[ISNI] + +List of [International Standard Name Identifier](https://musicbrainz.org/doc/ISNI) +(ISNI) codes for the artist. + +
recordingsRecordingConnection + A list of recordings linked to this entity. -
afterString
firstInt
releasesReleaseConnection + +
afterString
firstInt
releasesReleaseConnection + 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.
afterString
firstInt
releaseGroupsReleaseGroupConnection + +
type[ReleaseGroupType] + +Filter by one or more release group types. + +
status[ReleaseStatus] + +Filter by one or more release statuses. + +
afterString
firstInt
releaseGroupsReleaseGroupConnection + A list of release groups linked to this entity. -
type[ReleaseGroupType]Filter by one or more release group types.
afterString
firstInt
worksWorkConnection + +
type[ReleaseGroupType] + +Filter by one or more release group types. + +
afterString
firstInt
worksWorkConnection + A list of works linked to this entity. -
afterString
firstInt
relationshipsRelationships + +
afterString
firstInt
relationshipsRelationships + Relationships between this entity and other entitites. -
collectionsCollectionConnection + +
collectionsCollectionConnection + A list of collections containing this entity. -
afterString
firstInt
ratingRating + +
afterString
firstInt
ratingRating + The rating users have given to this entity. -
tagsTagConnection + +
tagsTagConnection + A list of tags linked to this entity. -
afterString
firstInt
+ +
afterString
firstInt
### ArtistConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[ArtistEdge] + +
edges[ArtistEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### ArtistCredit @@ -799,1041 +972,1399 @@ 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. - - - - - - - - - - - - - - - - - - - - - - - -
FieldArgumentTypeDescription
artistArtist -The entity representing the artist referenced in the credits. -
nameString -The name of the artist as credited in the specific release, track, etc. -
joinPhraseString -Join phrases might include words and/or punctuation to separate artist names as -they appear on the release, track, etc. -
+ + + + + + + + + + + + + + + + + + + + + + + + + + +
FieldArgumentTypeDescription
artistArtist + +The entity representing the artist referenced in the +credits. + +
nameString + +The name of the artist as credited in the specific release, +track, etc. + +
joinPhraseString + +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. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeArtist + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeArtist + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +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. - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FieldArgumentTypeDescription
areasAreaConnection + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - -
FieldArgumentTypeDescription
areasAreaConnection + Browse area entities linked to the given arguments. -
collectionMBIDThe MBID of a collection in which the entity is found.
afterString
firstInt
artistsArtistConnection + +
collectionMBID + +The MBID of a collection in which the entity is found. + +
afterString
firstInt
artistsArtistConnection + Browse artist entities linked to the given arguments. -
areaMBIDThe MBID of an area to which the entity is linked.
collectionMBIDThe MBID of a collection in which the entity is found.
recordingMBIDThe MBID of a recording to which the entity is linked.
releaseMBIDThe MBID of a release to which the entity is linked.
releaseGroupMBIDThe MBID of a release group to which the entity is linked.
workMBIDThe MBID of a work to which the entity is linked.
afterString
firstInt
collectionsCollectionConnection + +
areaMBID + +The MBID of an area to which the entity is linked. + +
collectionMBID + +The MBID of a collection in which the entity is found. + +
recordingMBID + +The MBID of a recording to which the entity is linked. + +
releaseMBID + +The MBID of a release to which the entity is linked. + +
releaseGroupMBID + +The MBID of a release group to which the entity is linked. + +
workMBID + +The MBID of a work to which the entity is linked. + +
afterString
firstInt
collectionsCollectionConnection + Browse collection entities linked to the given arguments. -
areaMBIDThe MBID of an area to which the entity is linked.
artistMBIDThe MBID of an artist to which the entity is linked.
editorStringThe username of the editor who created the collection.
eventMBIDThe MBID of an event to which the entity is linked.
labelMBIDThe MBID of a label to which the entity is linked.
placeMBIDThe MBID of a place to which the entity is linked.
recordingMBIDThe MBID of a recording to which the entity is linked.
releaseMBIDThe MBID of a release to which the entity is linked.
releaseGroupMBIDThe MBID of a release group to which the entity is linked.
workMBIDThe MBID of a work to which the entity is linked.
afterString
firstInt
eventsEventConnection + +
areaMBID + +The MBID of an area to which the entity is linked. + +
artistMBID + +The MBID of an artist to which the entity is linked. + +
editorString + +The username of the editor who created the collection. + +
eventMBID + +The MBID of an event to which the entity is linked. + +
labelMBID + +The MBID of a label to which the entity is linked. + +
placeMBID + +The MBID of a place to which the entity is linked. + +
recordingMBID + +The MBID of a recording to which the entity is linked. + +
releaseMBID + +The MBID of a release to which the entity is linked. + +
releaseGroupMBID + +The MBID of a release group to which the entity is linked. + +
workMBID + +The MBID of a work to which the entity is linked. + +
afterString
firstInt
eventsEventConnection + Browse event entities linked to the given arguments. -
areaMBIDThe MBID of an area to which the entity is linked.
artistMBIDThe MBID of an artist to which the entity is linked.
collectionMBIDThe MBID of a collection in which the entity is found.
placeMBIDThe MBID of a place to which the entity is linked.
afterString
firstInt
labelsLabelConnection + +
areaMBID + +The MBID of an area to which the entity is linked. + +
artistMBID + +The MBID of an artist to which the entity is linked. + +
collectionMBID + +The MBID of a collection in which the entity is found. + +
placeMBID + +The MBID of a place to which the entity is linked. + +
afterString
firstInt
labelsLabelConnection + Browse label entities linked to the given arguments. -
areaMBIDThe MBID of an area to which the entity is linked.
collectionMBIDThe MBID of a collection in which the entity is found.
releaseMBIDThe MBID of a release to which the entity is linked.
afterString
firstInt
placesPlaceConnection + +
areaMBID + +The MBID of an area to which the entity is linked. + +
collectionMBID + +The MBID of a collection in which the entity is found. + +
releaseMBID + +The MBID of a release to which the entity is linked. + +
afterString
firstInt
placesPlaceConnection + Browse place entities linked to the given arguments. -
areaMBIDThe MBID of an area to which the entity is linked.
collectionMBIDThe MBID of a collection in which the entity is found.
afterString
firstInt
recordingsRecordingConnection + +
areaMBID + +The MBID of an area to which the entity is linked. + +
collectionMBID + +The MBID of a collection in which the entity is found. + +
afterString
firstInt
recordingsRecordingConnection + Browse recording entities linked to the given arguments. -
artistMBIDThe MBID of an artist to which the entity is linked.
collectionMBIDThe MBID of a collection in which the entity is found.
isrcISRCThe International Standard Recording -Code (ISRC) of the recording.
releaseMBIDThe MBID of a release to which the entity is linked.
afterString
firstInt
releasesReleaseConnection + +
artistMBID + +The MBID of an artist to which the entity is linked. + +
collectionMBID + +The MBID of a collection in which the entity is found. + +
isrcISRC + +The [International Standard Recording Code](https://musicbrainz.org/doc/ISRC) +(ISRC) of the recording. + +
releaseMBID + +The MBID of a release to which the entity is linked. + +
afterString
firstInt
releasesReleaseConnection + Browse release entities linked to the given arguments. -
areaMBIDThe MBID of an area to which the entity is linked.
artistMBIDThe MBID of an artist to which the entity is linked.
collectionMBIDThe MBID of a collection in which the entity is found.
discIDDiscIDA disc ID associated with the -release.
labelMBIDThe MBID of a label to which the entity is linked.
recordingMBIDThe MBID of a recording to which the entity is linked.
releaseGroupMBIDThe MBID of a release group to which the entity is linked.
trackMBIDThe MBID of a track that is included in the release.
trackArtistMBIDThe 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.
afterString
firstInt
releaseGroupsReleaseGroupConnection + +
areaMBID + +The MBID of an area to which the entity is linked. + +
artistMBID + +The MBID of an artist to which the entity is linked. + +
collectionMBID + +The MBID of a collection in which the entity is found. + +
discIDDiscID + +A [disc ID](https://musicbrainz.org/doc/Disc_ID) +associated with the release. + +
labelMBID + +The MBID of a label to which the entity is linked. + +
recordingMBID + +The MBID of a recording to which the entity is linked. + +
releaseGroupMBID + +The MBID of a release group to which the entity is linked. + +
trackMBID + +The MBID of a track that is included in the release. + +
trackArtistMBID + +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. + +
afterString
firstInt
releaseGroupsReleaseGroupConnection + Browse release group entities linked to the given arguments. -
artistMBIDThe MBID of an artist to which the entity is linked.
collectionMBIDThe MBID of a collection in which the entity is found.
releaseMBIDThe MBID of a release to which the entity is linked.
type[ReleaseGroupType]Filter by one or more release group types.
afterString
firstInt
worksWorkConnection + +
artistMBID + +The MBID of an artist to which the entity is linked. + +
collectionMBID + +The MBID of a collection in which the entity is found. + +
releaseMBID + +The MBID of a release to which the entity is linked. + +
type[ReleaseGroupType] + +Filter by one or more release group types. + +
afterString
firstInt
worksWorkConnection + Browse work entities linked to the given arguments. -
artistMBIDThe MBID of an artist to which the entity is linked.
collectionMBIDThe MBID of a collection in which the entity is found.
iswcISWCThe International Standard Musical -Work Code (ISWC) of the work.
afterString
firstInt
+ +
artistMBID + +The MBID of an artist to which the entity is linked. + +
collectionMBID + +The MBID of a collection in which the entity is found. + +
iswcISWC + +The [International Standard Musical Work Code](https://musicbrainz.org/doc/ISWC) +(ISWC) of the work. + +
afterString
firstInt
### Collection [Collections](https://musicbrainz.org/doc/Collections) are lists of entities that users can create. - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
nameString + +
nameString + The official name of the entity. -
editorString! + +
editorString! + The username of the editor who created the collection. -
entityTypeString! + +
entityTypeString! + The type of entity listed in the collection. -
typeString + +
typeString + The type of collection. -
typeIDMBID -The MBID associated with the value of the type field. -
areasAreaConnection + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
areasAreaConnection + The list of areas found in this collection. -
afterString
firstInt
artistsArtistConnection + +
afterString
firstInt
artistsArtistConnection + The list of artists found in this collection. -
afterString
firstInt
eventsEventConnection + +
afterString
firstInt
eventsEventConnection + The list of events found in this collection. -
afterString
firstInt
instrumentsInstrumentConnection + +
afterString
firstInt
instrumentsInstrumentConnection + The list of instruments found in this collection. -
afterString
firstInt
labelsLabelConnection + +
afterString
firstInt
labelsLabelConnection + The list of labels found in this collection. -
afterString
firstInt
placesPlaceConnection + +
afterString
firstInt
placesPlaceConnection + The list of places found in this collection. -
afterString
firstInt
recordingsRecordingConnection + +
afterString
firstInt
recordingsRecordingConnection + The list of recordings found in this collection. -
afterString
firstInt
releasesReleaseConnection + +
afterString
firstInt
releasesReleaseConnection + 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.
afterString
firstInt
releaseGroupsReleaseGroupConnection + +
type[ReleaseGroupType] + +Filter by one or more release group types. + +
status[ReleaseStatus] + +Filter by one or more release statuses. + +
afterString
firstInt
releaseGroupsReleaseGroupConnection + The list of release groups found in this collection. -
type[ReleaseGroupType]Filter by one or more release group types.
afterString
firstInt
seriesSeriesConnection + +
type[ReleaseGroupType] + +Filter by one or more release group types. + +
afterString
firstInt
seriesSeriesConnection + The list of series found in this collection. -
afterString
firstInt
worksWorkConnection + +
afterString
firstInt
worksWorkConnection + The list of works found in this collection. -
afterString
firstInt
+ +
afterString
firstInt
### CollectionConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[CollectionEdge] + +
edges[CollectionEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### CollectionEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeCollection + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeCollection + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +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. - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
latitudeDegrees + + + + + + + + + + + + + + - - - - - + + + + + - -
FieldArgumentTypeDescription
latitudeDegrees + The north–south position of a point on the Earth’s surface. -
longitudeDegrees + +
longitudeDegrees + 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). - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
fileIDString! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - -
FieldArgumentTypeDescription
fileIDString! + The Internet Archive’s internal file ID for the image. -
imageURLString! + +
imageURLString! + The URL at which the image can be found. -
thumbnailsCoverArtImageThumbnails + +
thumbnailsCoverArtImageThumbnails + A set of thumbnails for the image. -
frontBoolean! + +
frontBoolean! + Whether this image depicts the “main front” of the release. -
backBoolean! + +
backBoolean! + Whether this image depicts the “main back” of the release. -
types[String] -A list of image types + +
types[String] + +A list of [image types](https://musicbrainz.org/doc/Cover_Art/Types) describing what part(s) of the release the image includes. -
editInt + +
editInt + The MusicBrainz edit ID. -
approvedBoolean + +
approvedBoolean + Whether the image was approved by the MusicBrainz edit system. -
commentString + +
commentString + A free-text comment left for the image. -
+ +
### CoverArtImageThumbnails URLs for thumbnails of different sizes for a particular piece of cover art. - - - - - - - - - - - - - - - - - - -
FieldArgumentTypeDescription
smallURLString -The URL of a small version of the cover art, where the maximum dimension is 250px. -
largeURLString -The URL of a large version of the cover art, where the maximum dimension is 500px. -
+ + + + + + + + + + + + + + + + + + + + + +
FieldArgumentTypeDescription
smallURLString + +The URL of a small version of the cover art, where the +maximum dimension is 250px. + +
largeURLString + +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). - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
discIDDiscID! -The disc ID of this disc. -
offsetCountInt! + +
discIDDiscID! + +The [disc ID](https://musicbrainz.org/doc/Disc_ID) of this disc. + +
offsetCountInt! + The number of offsets (tracks) on the disc. -
offsets[Int] + +
offsets[Int] + The sector offset of each track on the disc. -
sectorsInt! + +
sectorsInt! + The sector offset of the lead-out (the end of the disc). -
releasesReleaseConnection + +
releasesReleaseConnection + The list of releases linked to this disc ID. -
afterString
firstInt
+ +
afterString
firstInt
### Event @@ -1841,215 +2372,268 @@ 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. - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
nameString + +
nameString + The official name of the entity. -
disambiguationString + +
disambiguationString + A comment used to help distinguish identically named entitites. -
aliases[Alias] -Aliases are used to store alternate -names or misspellings. -
lifeSpanLifeSpan -The begin and end dates of the entity’s existence. Its exact meaning depends on -the type of entity. -
timeTime + +
aliases[Alias] + +[Aliases](https://musicbrainz.org/doc/Aliases) are used to store +alternate names or misspellings. + +
lifeSpanLifeSpan + +The begin and end dates of the entity’s existence. Its exact +meaning depends on the type of entity. + +
timeTime + The start time of the event. -
cancelledBoolean + +
cancelledBoolean + Whether or not the event took place. -
setlistString -A list of songs performed, optionally including links to artists and works. See -the setlist documentation + +
setlistString + +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. -
typeString + +
typeString + What kind of event the event is, e.g. concert, festival, etc. -
typeIDMBID -The MBID associated with the value of the type field. -
relationshipsRelationships + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
relationshipsRelationships + Relationships between this entity and other entitites. -
collectionsCollectionConnection + +
collectionsCollectionConnection + A list of collections containing this entity. -
afterString
firstInt
ratingRating + +
afterString
firstInt
ratingRating + The rating users have given to this entity. -
tagsTagConnection + +
tagsTagConnection + A list of tags linked to this entity. -
afterString
firstInt
+ +
afterString
firstInt
### EventConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[EventEdge] + +
edges[EventEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### EventEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeEvent + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeEvent + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +The relevancy score (0–100) assigned by the search engine, if +these results were found through a search. + +
### Instrument @@ -2057,186 +2641,232 @@ found through a search. devices created or adapted to make musical sounds. Instruments are primarily used in relationships between two other entities. - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
nameString + +
nameString + The official name of the entity. -
disambiguationString + +
disambiguationString + A comment used to help distinguish identically named entitites. -
aliases[Alias] -Aliases are used to store alternate -names or misspellings. -
descriptionString -A brief description of the main characteristics of the instrument. -
typeString -The type categorises the instrument by the way the sound is created, similar to -the Hornbostel-Sachs + +
aliases[Alias] + +[Aliases](https://musicbrainz.org/doc/Aliases) are used to store +alternate names or misspellings. + +
descriptionString + +A brief description of the main characteristics of the +instrument. + +
typeString + +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. -
typeIDMBID -The MBID associated with the value of the type field. -
relationshipsRelationships + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
relationshipsRelationships + Relationships between this entity and other entitites. -
collectionsCollectionConnection + +
collectionsCollectionConnection + A list of collections containing this entity. -
afterString
firstInt
tagsTagConnection + +
afterString
firstInt
tagsTagConnection + A list of tags linked to this entity. -
afterString
firstInt
+ +
afterString
firstInt
### InstrumentConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[InstrumentEdge] + +
edges[InstrumentEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### InstrumentEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeInstrument + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeInstrument + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +The relevancy score (0–100) assigned by the search engine, if +these results were found through a search. + +
### Label @@ -2244,481 +2874,650 @@ found through a search. (but not only) imprints. To a lesser extent, a label entity may be created to represent a record company. - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
nameString + +
nameString + The official name of the entity. -
sortNameString -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). -
disambiguationString + +
sortNameString + +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). + +
disambiguationString + A comment used to help distinguish identically named entitites. -
aliases[Alias] -Aliases are used to store alternate -names or misspellings. -
countryString + +
aliases[Alias] + +[Aliases](https://musicbrainz.org/doc/Aliases) are used to store +alternate names or misspellings. + +
countryString + The country of origin for the label. -
areaArea + +
areaArea + The area in which the label is based. -
lifeSpanLifeSpan -The begin and end dates of the entity’s existence. Its exact meaning depends on -the type of entity. -
labelCodeInt -The “LC” code of the -label. -
ipis[IPI] -List of Interested Parties Information + +
lifeSpanLifeSpan + +The begin and end dates of the entity’s existence. Its exact +meaning depends on the type of entity. + +
labelCodeInt + +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. -
typeString -A type describing the main activity of the label, e.g. imprint, production, distributor, -rights society, etc. -
typeIDMBID -The MBID associated with the value of the type field. -
releasesReleaseConnection + +
typeString + +A type describing the main activity of the label, e.g. +imprint, production, distributor, rights society, etc. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
releasesReleaseConnection + 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.
afterString
firstInt
relationshipsRelationships + +
type[ReleaseGroupType] + +Filter by one or more release group types. + +
status[ReleaseStatus] + +Filter by one or more release statuses. + +
afterString
firstInt
relationshipsRelationships + Relationships between this entity and other entitites. -
collectionsCollectionConnection + +
collectionsCollectionConnection + A list of collections containing this entity. -
afterString
firstInt
ratingRating + +
afterString
firstInt
ratingRating + The rating users have given to this entity. -
tagsTagConnection + +
tagsTagConnection + A list of tags linked to this entity. -
afterString
firstInt
+ +
afterString
firstInt
### LabelConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[LabelEdge] + +
edges[LabelEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### LabelEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeLabel + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeLabel + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +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). - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
beginDate + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - -
FieldArgumentTypeDescription
beginDate + The start date of the entity’s life span. -
endDate + +
endDate + The end date of the entity’s life span. -
endedBoolean + +
endedBoolean + Whether or not the entity’s life span has ended. -
+ +
### LookupQuery A lookup of an individual MusicBrainz entity by its MBID. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
areaArea + + + + + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - -
FieldArgumentTypeDescription
areaArea + Look up a specific area by its MBID. -
mbidMBID!The MBID of the entity.
artistArtist + +
mbidMBID! + +The MBID of the entity. + +
artistArtist + Look up a specific artist by its MBID. -
mbidMBID!The MBID of the entity.
collectionCollection + +
mbidMBID! + +The MBID of the entity. + +
collectionCollection + Look up a specific collection by its MBID. -
mbidMBID!The MBID of the entity.
discDisc + +
mbidMBID! + +The MBID of the entity. + +
discDisc + Look up a specific physical disc by its disc ID. -
discIDDiscID!The disc ID of the disc.
eventEvent + +
discIDDiscID! + +The [disc ID](https://musicbrainz.org/doc/Disc_ID) +of the disc. + +
eventEvent + Look up a specific event by its MBID. -
mbidMBID!The MBID of the entity.
instrumentInstrument + +
mbidMBID! + +The MBID of the entity. + +
instrumentInstrument + Look up a specific instrument by its MBID. -
mbidMBID!The MBID of the entity.
labelLabel + +
mbidMBID! + +The MBID of the entity. + +
labelLabel + Look up a specific label by its MBID. -
mbidMBID!The MBID of the entity.
placePlace + +
mbidMBID! + +The MBID of the entity. + +
placePlace + Look up a specific place by its MBID. -
mbidMBID!The MBID of the entity.
recordingRecording + +
mbidMBID! + +The MBID of the entity. + +
recordingRecording + Look up a specific recording by its MBID. -
mbidMBID!The MBID of the entity.
releaseRelease + +
mbidMBID! + +The MBID of the entity. + +
releaseRelease + Look up a specific release by its MBID. -
mbidMBID!The MBID of the entity.
releaseGroupReleaseGroup + +
mbidMBID! + +The MBID of the entity. + +
releaseGroupReleaseGroup + Look up a specific release group by its MBID. -
mbidMBID!The MBID of the entity.
seriesSeries + +
mbidMBID! + +The MBID of the entity. + +
seriesSeries + Look up a specific series by its MBID. -
mbidMBID!The MBID of the entity.
urlURL + +
mbidMBID! + +The MBID of the entity. + +
urlURL + Look up a specific URL by its MBID. -
mbidMBIDThe MBID of the entity.
resourceURLStringThe web address of the URL entity to look up.
workWork + +
mbidMBID + +The MBID of the entity. + +
resourceURLString + +The web address of the URL entity to look up. + +
workWork + Look up a specific work by its MBID. -
mbidMBID!The MBID of the entity.
+ +
mbidMBID! + +The MBID of the entity. + +
### Medium @@ -2728,325 +3527,407 @@ 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. - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
titleString + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - + + + + + - -
FieldArgumentTypeDescription
titleString + The title of this particular medium. -
formatString -The format of the medium -(e.g. CD, DVD, vinyl, cassette). -
formatIDMBID -The MBID associated with the value of the format field. -
positionInt -The order of this medium in the release (for example, in a multi-disc release). -
trackCountInt + +
formatString + +The [format](https://musicbrainz.org/doc/Release/Format) of +the medium (e.g. CD, DVD, vinyl, cassette). + +
formatIDMBID + +The MBID associated with the value of the `format` +field. + +
positionInt + +The order of this medium in the release (for example, in a +multi-disc release). + +
trackCountInt + The number of audio tracks on this medium. -
discs[Disc] + +
discs[Disc] + A list of physical discs and their disc IDs for this medium. -
+ +
### PageInfo Information about pagination in a connection. - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
hasNextPageBoolean! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - -
FieldArgumentTypeDescription
hasNextPageBoolean! + When paginating forwards, are there more items? -
hasPreviousPageBoolean! + +
hasPreviousPageBoolean! + When paginating backwards, are there more items? -
startCursorString + +
startCursorString + When paginating backwards, the cursor to continue. -
endCursorString + +
endCursorString + 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. - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
nameString + +
nameString + The official name of the entity. -
disambiguationString + +
disambiguationString + A comment used to help distinguish identically named entitites. -
aliases[Alias] -Aliases are used to store alternate -names or misspellings. -
addressString -The address describes the location of the place using the standard addressing -format for the country it is located in. -
areaArea -The area entity representing the area, such as the city, in which the place is -located. -
coordinatesCoordinates + +
aliases[Alias] + +[Aliases](https://musicbrainz.org/doc/Aliases) are used to store +alternate names or misspellings. + +
addressString + +The address describes the location of the place using the +standard addressing format for the country it is located in. + +
areaArea + +The area entity representing the area, such as the city, in +which the place is located. + +
coordinatesCoordinates + The geographic coordinates of the place. -
lifeSpanLifeSpan -The begin and end dates of the entity’s existence. Its exact meaning depends on -the type of entity. -
typeString -The type categorises the place based on its primary function. -
typeIDMBID -The MBID associated with the value of the type field. -
eventsEventConnection + +
lifeSpanLifeSpan + +The begin and end dates of the entity’s existence. Its exact +meaning depends on the type of entity. + +
typeString + +The type categorises the place based on its primary +function. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
eventsEventConnection + A list of events linked to this entity. -
afterString
firstInt
relationshipsRelationships + +
afterString
firstInt
relationshipsRelationships + Relationships between this entity and other entitites. -
collectionsCollectionConnection + +
collectionsCollectionConnection + A list of collections containing this entity. -
afterString
firstInt
tagsTagConnection + +
afterString
firstInt
tagsTagConnection + A list of tags linked to this entity. -
afterString
firstInt
+ +
afterString
firstInt
### PlaceConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[PlaceEdge] + +
edges[PlaceEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### PlaceEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodePlace + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodePlace + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +The relevancy score (0–100) assigned by the search engine, if +these results were found through a search. + +
### Rating @@ -3055,29 +3936,36 @@ 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. - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
voteCountInt! + + + + + + + + + + + + + + - - - - - + + + + + - -
FieldArgumentTypeDescription
voteCountInt! + The number of votes that have contributed to the rating. -
valueInt + +
valueInt + The average rating value based on the aggregated votes. -
+ +
### Recording @@ -3094,257 +3982,323 @@ 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. - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
titleString + +
titleString + The official title of the entity. -
disambiguationString + +
disambiguationString + A comment used to help distinguish identically named entitites. -
aliases[Alias] -Aliases are used to store alternate -names or misspellings. -
artistCredit ⚠️[ArtistCredit] + +
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] + +

⚠️ DEPRECATED

+
+ +The `artistCredit` field has been renamed to +`artistCredits`, since it is a list of credits and is referred to in the +plural form throughout the MusicBrainz documentation. This field is deprecated +and will be removed in a major release in the future. Use the equivalent +`artistCredits` field. + +
+
artistCredits[ArtistCredit] + The main credited artist(s). -
isrcs[ISRC] -A list of International Standard Recording -Codes (ISRCs) for this recording. -
lengthDuration -An approximation to the length of the recording, calculated from the lengths of -the tracks using it. -
videoBoolean + +
isrcs[ISRC] + +A list of [International Standard Recording Codes](https://musicbrainz.org/doc/ISRC) +(ISRCs) for this recording. + +
lengthDuration + +An approximation to the length of the recording, calculated +from the lengths of the tracks using it. + +
videoBoolean + Whether this is a video recording. -
artistsArtistConnection + +
artistsArtistConnection + A list of artists linked to this entity. -
afterString
firstInt
releasesReleaseConnection + +
afterString
firstInt
releasesReleaseConnection + 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.
afterString
firstInt
relationshipsRelationships + +
type[ReleaseGroupType] + +Filter by one or more release group types. + +
status[ReleaseStatus] + +Filter by one or more release statuses. + +
afterString
firstInt
relationshipsRelationships + Relationships between this entity and other entitites. -
collectionsCollectionConnection + +
collectionsCollectionConnection + A list of collections containing this entity. -
afterString
firstInt
ratingRating + +
afterString
firstInt
ratingRating + The rating users have given to this entity. -
tagsTagConnection + +
tagsTagConnection + A list of tags linked to this entity. -
afterString
firstInt
+ +
afterString
firstInt
### RecordingConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[RecordingEdge] + +
edges[RecordingEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### RecordingEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeRecording + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeRecording + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +The relevancy score (0–100) assigned by the search engine, if +these results were found through a search. + +
### Relationship @@ -3352,685 +4306,914 @@ found through a search. way to represent all the different ways in which entities are connected to each other and to URLs outside MusicBrainz. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
targetEntity! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - -
FieldArgumentTypeDescription
targetEntity! + The target entity. -
directionString! + +
directionString! + The direction of the relationship. -
targetTypeString! + +
targetTypeString! + The type of entity on the receiving end of the relationship. -
sourceCreditString -How the source entity was actually credited, if different from its main (performance) -name. -
targetCreditString -How the target entity was actually credited, if different from its main (performance) -name. -
beginDate + +
sourceCreditString + +How the source entity was actually credited, if different +from its main (performance) name. + +
targetCreditString + +How the target entity was actually credited, if different +from its main (performance) name. + +
beginDate + The date on which the relationship became applicable. -
endDate + +
endDate + The date on which the relationship became no longer applicable. -
endedBoolean + +
endedBoolean + 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. -
typeString + +
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. + +
typeString + The type of relationship. -
typeIDMBID -The MBID associated with the value of the type field. -
+ +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
### RelationshipConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[RelationshipEdge] + +
edges[RelationshipEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### RelationshipEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeRelationship + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeRelationship + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +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. - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FieldArgumentTypeDescription
areasRelationshipConnection + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FieldArgumentTypeDescription
areasRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
artistsRelationshipConnection + +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
artistsRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
eventsRelationshipConnection + +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
eventsRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
instrumentsRelationshipConnection + +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
instrumentsRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
labelsRelationshipConnection + +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
labelsRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
placesRelationshipConnection + +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
placesRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
recordingsRelationshipConnection + +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
recordingsRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
releasesRelationshipConnection + +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
releasesRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
releaseGroupsRelationshipConnection + +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
releaseGroupsRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
seriesRelationshipConnection + +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
seriesRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
urlsRelationshipConnection + +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
urlsRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
worksRelationshipConnection + +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
worksRelationshipConnection + A list of relationships between these two entity types. -
directionStringFilter by the relationship direction.
typeStringFilter by the relationship type.
typeIDMBIDThe MBID associated with the value of the type field.
afterString
firstInt
beforeString
lastInt
+ +
directionString + +Filter by the relationship direction. + +
typeString + +Filter by the relationship type. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
afterString
firstInt
beforeString
lastInt
### Release @@ -4040,313 +5223,390 @@ 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. - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
titleString + +
titleString + The official title of the entity. -
disambiguationString + +
disambiguationString + A comment used to help distinguish identically named entitites. -
aliases[Alias] -Aliases are used to store alternate -names or misspellings. -
artistCredit ⚠️[ArtistCredit] + +
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] + +

⚠️ 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] + +
releaseEvents[ReleaseEvent] + The release events for this release. -
dateDate -The release date is the -date in which a release was made available through some sort of distribution mechanism. -
countryString + +
dateDate + +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. + +
countryString + The country in which the release was issued. -
asinASIN -The Amazon Standard Identification -Number of the release. -
barcodeString -The barcode, if the release -has one. The most common types found on releases are 12-digit -UPCs and 13-digit -EANs. -
coverArtReleaseCoverArt! -A list and summary of the cover art images that are present for this release from -the Cover Art Archive. -
statusReleaseStatus + +
asinASIN + +The [Amazon Standard Identification Number](https://musicbrainz.org/doc/ASIN) +of the release. + +
barcodeString + +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). + +
coverArtReleaseCoverArt! + +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). + +
statusReleaseStatus + The status describes how “official” a release is. -
statusIDMBID -The MBID associated with the value of the status field. -
packagingString -The physical packaging that accompanies the release. See the list -of packaging for more information. -
packagingIDMBID -The MBID associated with the value of the packaging field. -
qualityString -Data quality indicates how good the data for a release is. It is not a mark of -how good or bad the music itself is – for that, use -ratings. -
media[Medium] + +
statusIDMBID + +The MBID associated with the value of the `status` +field. + +
packagingString + +The physical packaging that accompanies the release. See +the [list of packaging](https://musicbrainz.org/doc/Release/Packaging) for more +information. + +
packagingIDMBID + +The MBID associated with the value of the `packaging` +field. + +
qualityString + +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. -
artistsArtistConnection + +
artistsArtistConnection + A list of artists linked to this entity. -
afterString
firstInt
labelsLabelConnection + +
afterString
firstInt
labelsLabelConnection + A list of labels linked to this entity. -
afterString
firstInt
recordingsRecordingConnection + +
afterString
firstInt
recordingsRecordingConnection + A list of recordings linked to this entity. -
afterString
firstInt
releaseGroupsReleaseGroupConnection + +
afterString
firstInt
releaseGroupsReleaseGroupConnection + A list of release groups linked to this entity. -
type[ReleaseGroupType]Filter by one or more release group types.
afterString
firstInt
relationshipsRelationships + +
type[ReleaseGroupType] + +Filter by one or more release group types. + +
afterString
firstInt
relationshipsRelationships + Relationships between this entity and other entitites. -
collectionsCollectionConnection + +
collectionsCollectionConnection + A list of collections containing this entity. -
afterString
firstInt
tagsTagConnection + +
afterString
firstInt
tagsTagConnection + A list of tags linked to this entity. -
afterString
firstInt
+ +
afterString
firstInt
### ReleaseConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[ReleaseEdge] + +
edges[ReleaseEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### ReleaseCoverArt @@ -4354,150 +5614,191 @@ 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. - - - - - - - - - - - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
frontURLString -

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.

-
sizeCoverArtImageSizeThe 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.
backURLString -

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 + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - + + + + + - -
FieldArgumentTypeDescription
frontURLString + +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. + +
sizeCoverArtImageSize + +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. + +
backURLString + +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.

-
sizeCoverArtImageSizeThe 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. -
artworkBoolean! +check for null if you just want to determine the presence of an image. + +
sizeCoverArtImageSize + +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. + +
artworkBoolean! + Whether there is artwork present for this release. -
darkenedBoolean! -Whether the Cover Art Archive has received a take-down request for this release’s -artwork, disallowing new uploads. -
countInt! + +
darkenedBoolean! + +Whether the Cover Art Archive has received a take-down +request for this release’s artwork, disallowing new uploads. + +
countInt! + The number of artwork images present for this release. -
releaseRelease! + +
releaseRelease! + The particular release shown in the returned cover art. -
+ +

### ReleaseEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeRelease + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeRelease + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +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. - - - - - - - - - - - - - - - - - - -
FieldArgumentTypeDescription
areaArea -
dateDate -
+ + + + + + + + + + + + + + + + + + + + + +
FieldArgumentTypeDescription
areaArea
dateDate
### ReleaseGroup @@ -4510,245 +5811,310 @@ 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. - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
titleString + +
titleString + The official title of the entity. -
disambiguationString + +
disambiguationString + A comment used to help distinguish identically named entitites. -
aliases[Alias] -Aliases are used to store alternate -names or misspellings. -
artistCredit ⚠️[ArtistCredit] + +
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] + +

⚠️ 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). -
firstReleaseDateDate + +
firstReleaseDateDate + The date of the earliest release in the group. -
primaryTypeReleaseGroupType -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. -
primaryTypeIDMBID -The MBID associated with the value of the primaryType field. -
secondaryTypes[ReleaseGroupType] -Additional types + +
primaryTypeReleaseGroupType + +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. + +
primaryTypeIDMBID + +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. -
coverArtReleaseGroupCoverArt -The cover art for a release group, obtained from the Cover -Art Archive. -
artistsArtistConnection + +
secondaryTypeIDs[MBID] + +The MBIDs associated with the values of the `secondaryTypes` +field. + +
coverArtReleaseGroupCoverArt + +The cover art for a release group, obtained from the [Cover +Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive). + +
artistsArtistConnection + A list of artists linked to this entity. -
afterString
firstInt
releasesReleaseConnection + +
afterString
firstInt
releasesReleaseConnection + 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.
afterString
firstInt
relationshipsRelationships + +
type[ReleaseGroupType] + +Filter by one or more release group types. + +
status[ReleaseStatus] + +Filter by one or more release statuses. + +
afterString
firstInt
relationshipsRelationships + Relationships between this entity and other entitites. -
collectionsCollectionConnection + +
collectionsCollectionConnection + A list of collections containing this entity. -
afterString
firstInt
ratingRating + +
afterString
firstInt
ratingRating + The rating users have given to this entity. -
tagsTagConnection + +
tagsTagConnection + A list of tags linked to this entity. -
afterString
firstInt
+ +
afterString
firstInt
### ReleaseGroupConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[ReleaseGroupEdge] + +
edges[ReleaseGroupEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### ReleaseGroupCoverArt @@ -4756,356 +6122,452 @@ 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. - - - - - - - - - - - - - - - - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
frontURLString -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). -
sizeCoverArtImageSizeThe 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 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. -
artworkBoolean! + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + + + + + - -
FieldArgumentTypeDescription
frontURLString + +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). + +
sizeCoverArtImageSize + +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. + +
artworkBoolean! + Whether there is artwork present for this release group. -
releaseRelease! + +
releaseRelease! + The particular release shown in the returned cover art. -
+ +
### ReleaseGroupEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeReleaseGroup + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeReleaseGroup + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +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. - - - - - - - - - - - - + + + + + + + + + + + + + + + + + +
FieldArgumentTypeDescription
areasAreaConnection + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - -
FieldArgumentTypeDescription
areasAreaConnection + Search for area entities matching the given query. -
queryString!The query terms, in Lucene search syntax. See examples -and search fields.
afterString
firstInt
artistsArtistConnection + +
queryString! + +The query terms, in Lucene search syntax. See [examples +and search fields](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search). + +
afterString
firstInt
artistsArtistConnection + Search for artist entities matching the given query. -
queryString!The query terms, in Lucene search syntax. See examples -and search fields.
afterString
firstInt
eventsEventConnection + +
queryString! + +The query terms, in Lucene search syntax. See [examples +and search fields](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search). + +
afterString
firstInt
eventsEventConnection + Search for event entities matching the given query. -
queryString!The query terms, in Lucene search syntax. See examples -and search fields.
afterString
firstInt
instrumentsInstrumentConnection + +
queryString! + +The query terms, in Lucene search syntax. See [examples +and search fields](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search). + +
afterString
firstInt
instrumentsInstrumentConnection + Search for instrument entities matching the given query. -
queryString!The query terms, in Lucene search syntax. See examples -and search fields.
afterString
firstInt
labelsLabelConnection + +
queryString! + +The query terms, in Lucene search syntax. See [examples +and search fields](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search). + +
afterString
firstInt
labelsLabelConnection + Search for label entities matching the given query. -
queryString!The query terms, in Lucene search syntax. See examples -and search fields.
afterString
firstInt
placesPlaceConnection + +
queryString! + +The query terms, in Lucene search syntax. See [examples +and search fields](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search). + +
afterString
firstInt
placesPlaceConnection + Search for place entities matching the given query. -
queryString!The query terms, in Lucene search syntax. See examples -and search fields.
afterString
firstInt
recordingsRecordingConnection + +
queryString! + +The query terms, in Lucene search syntax. See [examples +and search fields](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search). + +
afterString
firstInt
recordingsRecordingConnection + Search for recording entities matching the given query. -
queryString!The query terms, in Lucene search syntax. See examples -and search fields.
afterString
firstInt
releasesReleaseConnection + +
queryString! + +The query terms, in Lucene search syntax. See [examples +and search fields](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search). + +
afterString
firstInt
releasesReleaseConnection + Search for release entities matching the given query. -
queryString!The query terms, in Lucene search syntax. See examples -and search fields.
afterString
firstInt
releaseGroupsReleaseGroupConnection + +
queryString! + +The query terms, in Lucene search syntax. See [examples +and search fields](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search). + +
afterString
firstInt
releaseGroupsReleaseGroupConnection + Search for release group entities matching the given query. -
queryString!The query terms, in Lucene search syntax. See examples -and search fields.
afterString
firstInt
seriesSeriesConnection + +
queryString! + +The query terms, in Lucene search syntax. See [examples +and search fields](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search). + +
afterString
firstInt
seriesSeriesConnection + Search for series entities matching the given query. -
queryString!The query terms, in Lucene search syntax. See examples -and search fields.
afterString
firstInt
worksWorkConnection + +
queryString! + +The query terms, in Lucene search syntax. See [examples +and search fields](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search). + +
afterString
firstInt
worksWorkConnection + Search for work entities matching the given query. -
queryString!The query terms, in Lucene search syntax. See examples -and search fields.
afterString
firstInt
+ +
queryString! + +The query terms, in Lucene search syntax. See [examples +and search fields](https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2/Search). + +
afterString
firstInt
### Series @@ -5113,169 +6575,211 @@ A [series](https://musicbrainz.org/doc/Series) is a sequence of separate release groups, releases, recordings, works or events with a common theme. - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
nameString + +
nameString + The official name of the entity. -
disambiguationString + +
disambiguationString + A comment used to help distinguish identically named entitites. -
typeString -The type primarily describes what type of entity the series contains. -
typeIDMBID -The MBID associated with the value of the type field. -
relationshipsRelationships + +
typeString + +The type primarily describes what type of entity the series +contains. + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
relationshipsRelationships + Relationships between this entity and other entitites. -
collectionsCollectionConnection + +
collectionsCollectionConnection + A list of collections containing this entity. -
afterString
firstInt
tagsTagConnection + +
afterString
firstInt
tagsTagConnection + A list of tags linked to this entity. -
afterString
firstInt
+ +
afterString
firstInt
### SeriesConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[SeriesEdge] + +
edges[SeriesEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### SeriesEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeSeries + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeSeries + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +The relevancy score (0–100) assigned by the search engine, if +these results were found through a search. + +
### Tag @@ -5283,100 +6787,126 @@ found through a search. with extra information – for example, the genres that apply to an artist, release, or recording. - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
nameString! + + + + + + + + + + + + + + - - - - - + + + + + - -
FieldArgumentTypeDescription
nameString! + The tag label. -
countInt + +
countInt + How many times this tag has been applied to the entity. -
+ +
### TagConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[TagEdge] + +
edges[TagEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### TagEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeTag + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeTag + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +The relevancy score (0–100) assigned by the search engine, if +these results were found through a search. + +
### URL @@ -5384,43 +6914,54 @@ 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. - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
resourceURLString! + +
resourceURLString! + The actual URL string. -
relationshipsRelationships + +
relationshipsRelationships + Relationships between this entity and other entitites. -
+ +
### Work @@ -5428,216 +6969,267 @@ 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. - - - - - - - - - - - - + + + + + + + + + + + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - + + + + + + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - - - - - - -
FieldArgumentTypeDescription
idID! + The ID of an object -
mbidMBID! + +
mbidMBID! + The MBID of the entity. -
titleString + +
titleString + The official title of the entity. -
disambiguationString + +
disambiguationString + 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. -
languageString + +
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. + +
languageString + The language in which the work was originally written. -
typeString + +
typeString + The type of work. -
typeIDMBID -The MBID associated with the value of the type field. -
artistsArtistConnection + +
typeIDMBID + +The MBID associated with the value of the `type` +field. + +
artistsArtistConnection + A list of artists linked to this entity. -
afterString
firstInt
relationshipsRelationships + +
afterString
firstInt
relationshipsRelationships + Relationships between this entity and other entitites. -
collectionsCollectionConnection + +
collectionsCollectionConnection + A list of collections containing this entity. -
afterString
firstInt
ratingRating + +
afterString
firstInt
ratingRating + The rating users have given to this entity. -
tagsTagConnection + +
tagsTagConnection + A list of tags linked to this entity. -
afterString
firstInt
+ +
afterString
firstInt
### WorkConnection A connection to a list of items. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
pageInfoPageInfo! + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
pageInfoPageInfo! + Information to aid in pagination. -
edges[WorkEdge] + +
edges[WorkEdge] + A list of edges. -
totalCountInt -A count of the total number of items in this connection, ignoring pagination. -
+ +
totalCountInt + +A count of the total number of items in this connection, +ignoring pagination. + +
### WorkEdge An edge in a connection. - - - - - - - - - - - - + + + + + + + +
FieldArgumentTypeDescription
nodeWork + + + + + + + + + + + + + + - - - - - + + + + + - - - - - - -
FieldArgumentTypeDescription
nodeWork + The item at the end of the edge -
cursorString! + +
cursorString! + A cursor for use in pagination -
scoreInt -The relevancy score (0–100) assigned by the search engine, if these results were -found through a search. -
+ +
scoreInt + +The relevancy score (0–100) assigned by the search engine, if +these results were found through a search. + +
## Enums @@ -5646,199 +7238,262 @@ found through a search. The image sizes that may be requested at the [Cover Art Archive](https://musicbrainz.org/doc/Cover_Art_Archive). - - - - - - - + + +
ValueDescription
SMALL + + + + + + + + + - - - - + + + + - - - - + + + + - -
ValueDescription
SMALL + A maximum dimension of 250px. -
LARGE + +
LARGE + A maximum dimension of 500px. -
FULL + +
FULL + The image’s original dimensions, with no maximum. -
+ +
### ReleaseGroupType A type used to describe release groups, e.g. album, single, EP, etc. - - - - - - - - - - - - - - - - - - - + + +
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 + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + - - - - - - - - + + + + + + + + - - - - + + + + - - - - - - - - - - - - + + + + + + + + + + + + - - - - - - - - + + + + + + + + - -
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 + +
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 + +
INTERVIEW + +An interview release contains an interview, generally with +an artist. + +
AUDIOBOOK + An audiobook is a book read by a narrator without music. -
LIVE + +
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 + +
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 + +
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. - - - - - - - - - - - - - - - - - - - - -
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. -
+ + + + + + + + + + + + + + + + + + + + + + + +
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 @@ -5948,40 +7603,50 @@ A web address. An entity in the MusicBrainz schema. - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
mbidMBID! + + + + + + + + + + + + + + - -
FieldArgumentTypeDescription
mbidMBID! + The MBID of the entity. -
+ +
### Node An object with an ID - - - - - - - - - - - - + + +
FieldArgumentTypeDescription
idID! + + + + + + + + + + + + + + - -
FieldArgumentTypeDescription
idID! + The id of the object. -
+ +
diff --git a/package.json b/package.json index 081aa24..a1ab0b8 100644 --- a/package.json +++ b/package.json @@ -91,8 +91,7 @@ "coveralls": "^2.13.0", "cross-env": "^4.0.0", "doctoc": "^1.3.0", - "graphql-markdown": "^1.3.0", - "marked": "^0.3.6", + "graphql-markdown": "^2.0.0", "nodemon": "^1.11.0", "nyc": "^10.2.0", "rimraf": "^2.6.1", diff --git a/yarn.lock b/yarn.lock index e7a61cd..cc55db8 100644 --- a/yarn.lock +++ b/yarn.lock @@ -2385,12 +2385,11 @@ graceful-fs@^4.1.2, graceful-fs@^4.1.4, graceful-fs@^4.1.6: version "1.0.1" resolved "https://registry.yarnpkg.com/graceful-readlink/-/graceful-readlink-1.0.1.tgz#4cafad76bc62f02fa039b2f94e9a3dd3a391a725" -graphql-markdown@^1.3.0: - version "1.3.0" - resolved "https://registry.yarnpkg.com/graphql-markdown/-/graphql-markdown-1.3.0.tgz#6a68252b79335f837b54df7f5b4cfe7a9edb01f4" +graphql-markdown@^2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/graphql-markdown/-/graphql-markdown-2.0.0.tgz#c5e54080493827d91bf2413603f50f8b1fb6ca74" dependencies: graphql "^0.9.1" - marked "^0.3.6" minimist "^1.2.0" node-fetch "^1.6.3" pre-commit "^1.2.2" @@ -3245,10 +3244,6 @@ markdown-to-ast@~3.4.0: structured-source "^3.0.2" traverse "^0.6.6" -marked@^0.3.6: - version "0.3.6" - resolved "https://registry.yarnpkg.com/marked/-/marked-0.3.6.tgz#b2c6c618fccece4ef86c4fc6cb8a7cbf5aeda8d7" - matcher@^0.1.1: version "0.1.2" resolved "https://registry.yarnpkg.com/matcher/-/matcher-0.1.2.tgz#ef20cbde64c24c50cc61af5b83ee0b1b8ff00101"