Product Types

Product type classification.

Available types: Album, Single, EP, Video

Defines the format and type of music releases.

List product types

GET

https://api.idol.io/api/v2

/product-types

Retrieve all available product types

List product types › query Parameters

page[number]

integer · min: 1

Page number for pagination

Default: 1

page[size]

integer · min: 1 · max: 200

Number of items per page (max 200)

Default: 20

List product types › Responses

Successful response

ProductTypeListResponse

ProductTypeResource[]

Array of resource objects (override with specific resource schema)

object[]

Related resources included in the response

PaginationMeta

PaginationLinks

GET/product-types

curl https://api.idol.io/api/v2/product-types \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": "1",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/1"
      },
      "attributes": {
        "name": "Album"
      }
    },
    {
      "id": "2",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/2"
      },
      "attributes": {
        "name": "Single"
      }
    },
    {
      "id": "3",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/3"
      },
      "attributes": {
        "name": "EP"
      }
    }
  ],
  "meta": {
    "record-count": 8,
    "page-count": 3
  },
  "links": {
    "first": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=1&page%5Bsize%5D=3",
    "next": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=2&page%5Bsize%5D=3",
    "last": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=3&page%5Bsize%5D=3"
  }
}

json

application/vnd.api+json

Get product type details

GET

https://api.idol.io/api/v2

/product-types/{id}

Retrieve details for a specific product type by ID

Get product type details › path Parameters

id

string · required

Resource ID

Get product type details › Responses

Successful response

ProductTypeResponse

ProductTypeResource

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

Localizations Product Genres

Labelcamp API v2

Product Types

Product type classification.

Available types: Album, Single, EP, Video

Defines the format and type of music releases.

List product types

GET

https://api.idol.io/api/v2

/product-types

Retrieve all available product types

List product types › query Parameters

page[number]

integer · min: 1

Page number for pagination

Default: 1

page[size]

integer · min: 1 · max: 200

Number of items per page (max 200)

Default: 20

List product types › Responses

Successful response

ProductTypeListResponse

ProductTypeResource[]

Array of resource objects (override with specific resource schema)

object[]

Related resources included in the response

PaginationMeta

PaginationLinks

GET/product-types

curl https://api.idol.io/api/v2/product-types \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": "1",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/1"
      },
      "attributes": {
        "name": "Album"
      }
    },
    {
      "id": "2",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/2"
      },
      "attributes": {
        "name": "Single"
      }
    },
    {
      "id": "3",
      "type": "product-types",
      "links": {
        "self": "https://api.idol.io/api/v2/product-types/3"
      },
      "attributes": {
        "name": "EP"
      }
    }
  ],
  "meta": {
    "record-count": 8,
    "page-count": 3
  },
  "links": {
    "first": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=1&page%5Bsize%5D=3",
    "next": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=2&page%5Bsize%5D=3",
    "last": "https://api.idol.io/api/v2/product-types?page%5Bnumber%5D=3&page%5Bsize%5D=3"
  }
}

json

application/vnd.api+json

Get product type details

GET

https://api.idol.io/api/v2

/product-types/{id}

Retrieve details for a specific product type by ID

Get product type details › path Parameters

id

string · required

Resource ID

Get product type details › Responses

Successful response

ProductTypeResponse

ProductTypeResource

The primary resource object (override with specific resource schema)

object[]

Related resources included in the response

object

Localizations Product Genres