Band

GET /v1/entities/band/{entity_id}

Retrieves a specific band.

Request Parameters

Location Parameter Type Required/ Optional Description
path entity_id number optional The string id of the band being searched for

Example Request

GET /v1/entities/band/slightly_less_than_epic HTTP/1.1
Host: api.ampermusic.com
Content-Type: application/vnd.api+json
Authorization: Basic abcxyz

Response Data

Data Item Type Description
data object
data.type string The type of data (entity_band in this case)
data.id string The string ID of the band
data.attributes object
data.attributes.name string The string name of the band
data.attributes.instruments array
data.attributes.instruments[].id string The string id of the instrument
data.attributes.instruments[].name string The string name of the instrument
data.attributes.preview array
data.attributes.preview[].url string The string url of the band’s preview file
data.attributes.preview[].content_type string enum The content type of the preview. Of the following values:
audio/mp3
audio/ogg
data.attributes.tags array
data.attributes.tags[].id string The string id of the tag
data.attributes.tags[].name string The string name of the tag
data.attributes.tags[].category string The string category of the tag
data.links object
data.links.self string The URL of the band.
links object
links.self string The URL of this band

Example Response

Header

HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

Body

{
	"data": {
		"attributes": {
			"instruments": [
				{
					"id": "octave_synth_pad",
					"name": "Octave Synth Pad"
				},
				{
					"id": "classical_grand_piano",
					"name": "Classical 6ft Grant Piano"
				}
			],
			"name": "Slightly less than epic",
			"preview": [
				{
					"content_type": "audio/mp3",
					"url": "<some_url>"
				},
				{
					"content_type": "audio/ogg",
					"url": "<some_url>"
				}
			],
			"tags": [
				{
					"category": "band_size",
					"id": "large",
					"name": "Large"
				},
				{
					"category": "descriptor",
					"id": "ambient_uplifting_low",
					"name": "Uplifting Atmospheric Cinematic"
				}
			]
		},
		"id": "slightly_less_than_epic",
		"links": {
			"self": "https://api.ampermusic.com/v1/entities/band/slightly_less_than_epic"
		},
		"type": "entity_band"
	},
	"links": {
		"self": "https://api.ampermusic.com/v1/entities/band/slightly_less_than_epic"
	}
}