Entities

Overview

An Entity is a piece of data that is useful for describing music to the composer. See the glossary for more information.

Id vs. Name

Many Entities contain both an id and a name. The name field is provided as a human-readable string that is usable for display in a UI. For working with timelines however the id field, which is always lowercase_snake_case, is used.

Methods and URLs

Method URL Description
GET /v1/entities/descriptor/{entity_id} Retrieves information for an individual descriptor
GET /v1/entities/descriptor Retrieves information for multiple descriptors
GET /v1/entities/band/{entity_id} Retrieves information for an individual band
GET /v1/entities/band Retrieves information for multiple bands
GET /v1/entities/category/{entity_id} Retrieves information for an individual category
GET /v1/entities/category Retrieves information for multiple categories
GET /v1/entities/descriptor/{entity_id} Retrieves information for an individual descriptor
GET /v1/entities/descriptor Retrieves information for multiple descriptors
GET /v1/entities/hit/{entity_id} Retrieves information for an individual hit
GET /v1/entities/hit Retrieves information for multiple hits
GET /v1/entities/instrument/{entity_id} Retrieves information for an individual instrument
GET /v1/entities/instrument Retrieves information for multiple instruments
GET /v1/entities/label/{entity_id} Retrieves information for an individual label
GET /v1/entities/label Retrieves information for multiple labels
GET /v1/entities/tag/{entity_id} Retrieves information for an individual tag
GET /v1/entities/tag Retrieves information for multiple tags