Label

GET /v1/entities/label/{entity_id}

Retrieves a specific label.

Request Parameters

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

Example Request

GET /v1/entities/label/general 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.name string The string name of the label
data.id string The string id of the label
data.links object
data.links.self string The URL of this label
data.type string The type of data (entity_label in this case)
links object
links.self string The URL of this label

Example Response

Header

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

Body

{
    "data": {
        "attributes": {
            "name": "General"
        },
        "id": "general",
        "links": {
            "self": "https://api.ampermusic.com/v1/entities/label/general"
        },
        "type": "entity_label"
    },
    "links": {
        "self": "https://api.ampermusic.com/v1/entities/label/general"
    }
}