Category

GET /v1/entities/category/{entity_id}

Retrieves a specific category.

Request Parameters

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

Example Request

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

Example Response

Header

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

Body

{
    "data": {
        "attributes": {
            "name": "Style"
        },
        "id": "style",
        "links": {
            "self": "https://api.ampermusic.com/v1/entities/category/style"
        },
        "type": "entity_category"
    },
    "links": {
        "self": "https://api.ampermusic.com/v1/entities/category/style"
    }
}