The structure of results returned by the Quantone API is defined by the Quantone Object Model.

The reference guide below describes the contents of this model, including what objects are available, what properties they have, and the types of these proeprties.

The Quantone API returns data as either JSON (by default) or XML. If you are using the Quantone SDK, this data will automatically be deserialized and returned as objects.

All queries return a Query Result object. These Query Result objects contain a single result for lookup queries or a result set for search queries. The result object will be a Quantone Entity. For more information about what results are returned by the different queries, please see the Data Service documentation.

Activity

A role or job related to making music.

Class Activity
Parameters
NameResultObjectDescription
IdGuid Unique Identifier in the Quantone database.
Namestring The name of the activity.

Album

A collection of sound recordings.

Class Album
Parameters
NameResultObjectDescription
ArtistsArtist[] Main artists associated with this album.
ArtistsLiteralstring Main artists, as written on this album.
FormatContentFormat? A general indication of the structure of this album.
GenresGenre[] Tags associated with this entire album.
IdGuid Unique Identifier in the Quantone database..
IdentifiersAlbumIdentifier[] Identifiers which identify this album as a whole.
ImageIdGuid? ID of this album's cover art.
IsLivebool? Is this a live album?
IsUnofficialbool? Has this album not been released officially?
OriginalReleaseDatestring Original date this album was released.
ParticipationsParticipation[] Participations associated with this album as a whole, rather than with its recordings or works.
RecordingsRecording[] The recordings which are tracks on this album.
ReleasesRelease[] Releases of the album.
Titlestring The official name for this album.

AlbumIdentifier

A code which identifies an Album.

Class AlbumIdentifier
Parameters
NameResultObjectDescription
IdentifierTypeAlbumIdType Type of the identifier.
Valuestring Value of the identifier.
AdditionalInformationstring Additional information that might be necessary to use this identifier, such as the catalog name or the territory.

Annotation

Editorial text about a particular subject.

Class Annotation
Parameters
NameResultObjectDescription
ReferencesAnnotationReference[] Entities referenced in this annotation
Textstring The content of the annotation.

AnnotationReference

An entity that is referenced in an annotation.

Class AnnotationReference
Parameters
NameResultObjectDescription
DisplayTextstring The text that was replaced by the reference number in the annotation.
EntityIdGuid? The Id of the referenced entity.
EntityTypeEntityType? The type of the referenced entity.
ReferenceNumberint The reference number in the annotation.

Artist

A person or a group.

Class Artist
Parameters
NameResultObjectDescription
AppearanceTypeAppearanceType? Capacity in which an artist appears on an album or recording.
ArtistTypeArtistType Whether this artist is a person or an act.
BiographiesAnnotation[] Detailed biographies of the artist.
BirthDatestring The date this artist was born, if they are a person.
BirthPlacestring The place this artist was born, if they are a person.
DeathDatestring The date this artist died, if they are a person.
DeathPlacestring The place this artist died, if they are a deceased person.
GenderGender? Gender of this artist, if they are a person.
GenresGenre[] Tags associated with this artist.
GroupsArtist[] The groups that this artist has belonged to.
IdGuid Unique Identifier in the Quantone database.
IdentifiersArtistIdentifier[] Identifiers which identify this artist.
ImageIdGuid? ID of this artist's image.
IsFictionalbool Is this artist not a real person or group?
Joinstring Text which is used to connect the previous artist to this artist when written together.
MembersArtist[] The members of this artist, if it is a group.
MembershipDatestring This artist was a member of the encompassing artist during this date.
NameLiteralstring The name of the artist, as written on the album sleeve or liner notes.
NamesName[] All names for this artist.
ProbabilityProbability? Confidence that this is the correct artist.
RelatedArtistsArtist[] Other artists associated with this artist in some way.
RelationshipTypeArtistRelationshipType? How this artist is related to the encompassing artist.
ShortDescriptionsAnnotation[] Short descriptions of the artist.
StageNamestring The name by which this artist is known professionally.
WebAddressesWebAddress[] Addresses of websites associated with this artist.

ArtistIdentifier

A code which identifies an Artist.

Class ArtistIdentifier
Parameters
NameResultObjectDescription
IdentifierTypeArtistIdType Type of the identifier.
Valuestring Value of the identifier.
AdditionalInformationstring Additional information that might be necessary to use this identifier, such as the catalog name or the territory.

DiscTag

The digital file tags for tracks on a particular disc.

Class DiscTag
Parameters
NameResultObjectDescription
FileTagsFileTag[] Tags for individual tracks on the disc.

FileTag

Information for an MP3, FLAC or other digital file tag.

Class FileTag
Parameters
NameResultObjectDescription
AlbumEANstring International Article Number for the album.
AlbumIdGuid? Identifier of the album in the Quantone database.
AlbumMediumIdGuid? Identifier of the medium in the Quantone database.
AlbumTitlestring Title of the album.
BeatsPerMinutestring The number of music beats per minute of music on the track.
CatalogNumstring The label's catalog number for the album.
CddbIdstring CDDB disc checksum.
Composerstring The names of the composers of the works being performed on this track.
Conductorstring The name of conductor on this track.
DiscCountint? The total number of discs on the album.
DiscEANstring International article number for the disc.
DiscNumint? Disc number. 1-based.
DiscTitlestring Title of disc.
Durationdouble? Duration of the track, in seconds.
Genresstring Tags associated with this track.
MasteringDatestring The dates the track was mastered.
MasteringVenuestring The names of the venues where the track was mastered.
Matrixstring The matrix number of the disc.
MediaTypestring The format type of the medium.
MixingDatestring The dates the track was mixed.
MixingVenuestring The names of the venues where the track was mixed.
Participantsstring The names of the participants on the track and the activities they performed.
Publisherstring The publisher of the album.
Puidstring MusicIP sound print identifier for the track.
RecordingDatestring The dates the track was recorded.
RecordingIdGuid Identifier of the recording in the Quantone database.
RecordingVenuestring The names of the venues where the track was recorded.
ReleaseDatestring The date the recording was released.
RemixingDatestring The dates the track was remixed.
RemixingVenuestring The names of the venues where the track was remixed.
TrackAddendastring Any extra bits in the title, such as "Alternate take".
TrackArtiststring The main artist on the track.
TrackCountint? The total number of tracks on the album.
TrackNumberint? The position at which this recording appears on its disc. 1-based.
TrackNumberLiteralstring The track number as written on the album sleeve.
TrackTitlestring The title of the track.
Worksstring The names of the works being performed on this track.

Genre

A name frequently give to a musical tradition, style or set of conventions.

Class Genre
Parameters
NameResultObjectDescription
IdGuid Unique Identifier in the Quantone database.
Namestring The most commonly used name for this tag.

Label

A record label

Class Label
Parameters
NameResultObjectDescription
IdGuid Unique Identifier in the Quantone database.
IdentifiersLabelIdentifier[] Identifiers which identify this label.
LocationsLocation[] The locations where this label is active
Namestring The name of this label.

LabelIdentifier


Class LabelIdentifier
Parameters
NameResultObjectDescription
IdentifierTypeLabelIdType Type of the identifier.
Valuestring Value of the identifier.
AdditionalInformationstring Additional information that might be necessary to use this identifier, such as the catalog name or the territory.

Location

A place in the world.

Class Location
Parameters
NameResultObjectDescription
CategoryLocationCategory? What type of place is this location.
IdGuid Unique Identifier in the Quantone database.
IdentifiersLocationIdentifier[] Identifiers which identify this location.
Latitudedouble? The angular distance of a heavenly body from the ecliptic - the distance north or south from the equator measured in degrees
Longitudedouble? The arc or portion of the equator intersected between the meridian of a given place and the meridian of some other place. Measured in degrees East of Greenwich
Namestring The name of this location.
ParentLocationsLocation[] Identifiers which identify this location.

LocationIdentifier

A code which identifies an Location.

Class LocationIdentifier
Parameters
NameResultObjectDescription
IdentifierTypeLocationIdType Type of the identifier.
Valuestring Value of the identifier.
AdditionalInformationstring Additional information that might be necessary to use this identifier, such as the catalog name or the territory.

Mood

A mood describing a recording.

Class Mood
Parameters
NameResultObjectDescription
IdGuid Unique Identifier in the Quantone database.
Namestring The most commonly used name for this tag.

MusicForm

The musical form of a work.

Class MusicForm
Parameters
NameResultObjectDescription
IdGuid Unique Identifier in the Quantone database.
Namestring The most commonly used name for this tag.

MusicKey

The musical key of a recording or work.

Class MusicKey
Parameters
NameResultObjectDescription
IdGuid Unique Identifier in the Quantone database.
Namestring The most commonly used name for this tag.

MusicTempo

A music tempo marking.

Class MusicTempo
Parameters
NameResultObjectDescription
IdGuid Unique Identifier in the Quantone database.
Namestring The most commonly used name for this tag.

Name

The name of something

Class Name
Parameters
NameResultObjectDescription
IsBirthNamebool Whether this is the birth name of the Artist.
IsGivenNamebool Whether this is a given name of the Work.
IsIncipitbool Whether this the incipit for the Work.
IsLegalNamebool Whether this is the legal name of the Artist.
IsMainNamebool Whether this is the main name of the entity.
IsNicknamebool Whether this is the nickname of the Work.
IsNormalFormNamebool Whether this is a Quantone normalized name.
LanguageLanguage? The language of the name. If null it is the default language.
Stringstring The literal text of the name

Orchestration

The Orchestration specified for this Work.

Class Orchestration
Parameters
NameResultObjectDescription
ActivitiesActivity[] The Activitys required by the orchestration
ActivityLiteralstring The names of the Activitys, as written.
IsFeaturedbool? True if this is featured on the Work.
MaximumNumberOfPartsint? Maxiumum number of people doing this Activity.
MinimumNumberOfPartsint Minimum number of people doing this Activity
SubOrchestrationsOrchestration[]Orchestrations that are constituent of this Orchestration

Participation

How a particular artist contributed to an album, recording, or work.

Class Participation
Parameters
NameResultObjectDescription
ActivitiesActivity[] The activities performed by the artist.
ActivityLiteralstring The names of the activities, as originally written.
ArtistsArtist[] The artists who participated.
ArtistsLiteralstring Names of the artists, as written on the album sleeve or the liner notes.
IsFeaturedbool? Whether this participation is of particular importance (typically the main or featured artist).

ProductionEvent

An event associated with the creation of a recording.

Class ProductionEvent
Parameters
NameResultObjectDescription
Datestring The date of this event.
IsMasteringbool? Was music mastered during this event?
IsMixingbool? Was music mixed during this event?
IsRecordingbool? Was music recorded during this event?
IsRemasteringbool? Was music remastered during this event?
LocationsLocation[] The locations where this event happened.

PublicationEvent

An event associated with the publication of a work.

Class PublicationEvent
Parameters
NameResultObjectDescription
Datestring The date of this event.
IsOriginalPublicationbool? Whether this is the original publication.
LocationsLocation[] The Location where this event happened.
ParticipationsParticipation[]Participations associated with this publication event.
Publisherstring The name of the publisher.

Recording

A single distinct recording of sound.

Class Recording
Parameters
NameResultObjectDescription
Addendastring Additional text describing this recording that is not part of the title.
AlbumSequenceint? This recording's position on the album. 1-based.
ArtistsArtist[] The main artists and featured artists on this recording.
BeatsPerMinutedouble? Number of beats in one minute of music on this recording.
ConstituentRecordingsRecording[] Recordings that this recording is made up of.
ConstituentRecordingTypeConstituentRecordingType? How the encompassing recording was derived from this recording.
Durationdouble? Duration of this track, in seconds.
FeaturedArtistsLiteralstring Featured artists on this recording, as written on the album.
GenresGenre[] Tags associated with this recording.
IdGuid Unique Identifier in the Quantone database.
IdentifiersRecordingIdentifier[] Identifiers which identify this recording.
IsConcertbool? Was this recorded in front of an audience?
IsLivebool? Was this recorded live?
MainArtistsLiteralstring The main artists on this recording, as written on the album.
MusicalKeysMusicKey[] The musical keys of this recording (may be different from the original work).
OriginalAlbumIdGuid? Quantone Id of the album on which this recording was originally released.
OriginalAlbumTitlestring Title of the album on which this recording was originally released.
OriginalReleaseDatestring The date when this recording was originally released.
ParticipationsParticipation[] Participations associated with this recording (directly, rather than with its album or work).
ProductionEventsProductionEvent[] Events associated with the production of this recording.
Titlestring The title of this recording.
WorksWork[] Works that are being performed on this recording.

RecordingIdentifier

A code which identifies a Recording.

Class RecordingIdentifier
Parameters
NameResultObjectDescription
IdentifierTypeRecordingIdType Type of the identifier.
Valuestring Value of the identifier.
AdditionalInformationstring Additional information that might be necessary to use this identifier, such as the catalog name or the territory.

Release

A particular release of an album.

Class Release
Parameters
NameResultObjectDescription
FormatTypesstring Formats of this release.
IdGuid Unique Identifier in the Quantone database.
IdentifiersReleaseIdentifier[] Identifiers which identify this release.
LabelLiteralstring Label on which this release was released.
LabelsLabel[] The labels on which this release was released.
LocationsLocation[] The locations where this release was released.
ReleaseDatestringdate when this release was released.
ReleaseRegionLiteralstring Region in which this release was released.

ReleaseIdentifier

A code which identifies a Release.

Class ReleaseIdentifier
Parameters
NameResultObjectDescription
IdentifierTypeReleaseIdType Type of the identifier.
Valuestring Value of the identifier.
AdditionalInformationstring Additional information that might be necessary to use this identifier, such as the catalog name or the territory.

Tag

A named classification group.

Class Tag
Parameters
NameResultObjectDescription
IdGuid Unique Identifier in the Quantone database.
Namestring The most commonly used name for this tag.

TimeSignature

A scored time signature, such as "4/4".

Class TimeSignature
Parameters
NameResultObjectDescription
IdGuid Unique Identifier in the Quantone database.
Namestring The most commonly used name for this tag.

WebAddress

An address which references a resource on the world wide web.

Class WebAddress
Parameters
NameResultObjectDescription
Addressstring The address of the resource.
Websitestring Name of the web site that this address points to.

Work

A musical composition.

Class Work
Parameters
NameResultObjectDescription
CatalogsWorkCatalog[] Where this work appears in each of its WorkCatalogs.
ConstituentWorksWork[] Subworks that this work is made up of.
DerivedWorkTypeDerivedWorkType? The nature of how this work is derived from the enclosing work.
FormsMusicForm[] Musical form(s) assigned to this work.
GenresGenre[] Musical genres assigned to this work.
IdGuid Unique Identifier in the Quantone database.
IdentifiersWorkIdentifier[]WorkIdentifiers which identify this work.
IsExtractbool? True if this work is specifically chosen piece of a larger work.
IsFragmentbool? True if the entirety of the work no longer exists.
IsGeneratedbool? True if this work is an derived artifact of the Quantone database.
IsIncompletebool? True if this work is not in a plenary state.
IsInconclusivebool? True if there is no definitive version extant of this work.
IsLostbool? True if this work once existed but no copies remain.
IsSpuriousbool? True if this work is considered to be falsely attributed to the named composer.
KeysMusicKey[] Musical key(s) assigned to this work. Combination of keynote and mode
LibrettiWork[] Texts to which this composition is related.
LiteralSequenceNumberstring Where this work appears in the enclosing work.
Namestring The default name for this work.
NameNormalizedstring The normalized name for this work.
NamesName[] The various Names used for this work.
NotablePerformancesRecording[] Important performances of this work - such as the premiere.
OrchestrationsOrchestration[]Orchestrations associated with this work
ParentWorksWork[] Parent works from which this work is derived.
ParticipationsParticipation[]Participations associated with this work.
PublicationInfoPublicationEvent[] The PublicationEvents of this work.
RecordingSequenceint? This work's position on the recording. 1-based.
TempiMusicTempo[] Tempo markings assigned to this work (usually for classical music, usually in original language)
TimeSignaturesTimeSignature[] Time signature assigned to this work, e.g. 4/4
WorkEventsWorkEvent[]WorkEvent associated with the production of this work.
WorkTypeWorkType? The hierarchical level of the work collection, piece or section).

WorkCatalog

A musical composition.

Class WorkCatalog
Parameters
NameResultObjectDescription
CatalogIdGuid Internal Id of the catalog.
CatalogNamestring The name of the catalog e.g. BWV, HWV, String Quartet catalog.
IsOpusbool? Whether this is an Opus catalog.
LiteralSequenceNumberstring This work's position in the catalog - as written.
SequenceNumberint? This work's position in the catalog - in normalized form.

WorkEvent

An event associated with the creation of a Work.

Class WorkEvent
Parameters
NameResultObjectDescription
Datestring The date of this event.
LocationsLocation[] The Locations where this event happened.
WorkEventTypeWorkEventType? The WorkEventType of this event

WorkIdentifier

A code which identifies a Work.

Class WorkIdentifier
Parameters
NameResultObjectDescription
IdentifierTypeWorkIdType Type of the identifier.
Valuestring Value of the identifier.
AdditionalInformationstring Additional information that might be necessary to use this identifier, such as the catalog name or the territory.