Band

GET /v1/entities/band/{entity_id}

Retrieves a specific band.

Request Parameters

Location Parameter Type Required/ Optional Description
path entity_id string 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.attributes object
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.name string The string name of the band
data.attributes.previews array
data.attributes.previews[].content_type string enum The content type of the previews, currently audio/mp3.
data.attributes.previews[].url string The URL of the band’s preview files
data.attributes.tags array
data.attributes.tags[].category object
data.attributes.tags[].category.id string The string id of the category
data.attributes.tags[].category.name string The string name of the category
data.attributes.tags[].id string The string id of the tag
data.attributes.tags[].name string The string name of the tag
data.id string The string ID of the band
data.links object
data.links.self string The URL of the band.
data.type string The type of data (entity_band in this case)
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": "studio_djembe",
                    "name": "Djembe - Full"
                },
          ...
            ],
            "name": "Slightly less than epic",
            "previews": [
                {
                    "content_type": "audio/mp3",
                    "url": "https://public-cdn.ampermusic.com/bands/previews/slightly_less_than_epic_ambient_uplifting_low_v1.mp3"
                }
            ],
            "tags": [
                {
                    "category": {
                        "id": "band_size",
                        "name": "Band Size"
                    },
                    "id": "large",
                    "name": "Large"
                },
          ...
            ]
        },
        "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"
    }
}