Tag

GET /v1/entities/tag/{entity_id}

Retrieves a specific tag.

Request Parameters

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

Example Request

GET /v1/entities/tag/documentary 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.category object
data.attributes.category.id string The string id of the category
data.attributes.category.name string The string name of the category
data.attributes.labels[].id string The string id of the label
data.attributes.labels[].name string The string name of the label
data.attributes.labels array
data.attributes.name string The string name of the tag
data.id string The string id of the tag
data.links object
data.links.self string The URL of the tag
data.type string The type of data (entity_tag in this case)
links object
links.self string The URL of this tag

Example Response

Header

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

Body

{
    "data": {
        "attributes": {
            "category": {
                "id": "style",
                "name": "Style"
            },
            "labels": [
                {
                    "id": "general",
                    "name": "General"
                },
                {
                    "id": "non_musical",
                    "name": "Non Musical"
                }
            ],
            "name": "Documentary"
        },
        "id": "documentary",
        "links": {
            "self": "https://api.ampermusic.com/v1/entities/tag/documentary"
        },
        "type": "entity_tag"
    },
    "links": {
        "self": "https://api.ampermusic.com/v1/entities/tag/documentary"
    }
}