Product

List Products

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

Headers

Name	Type	Description
Authorization*	string	Bearer <token>
Content-Type*	string	application/vnd.api+json

200

{
  "data": [
    {
      "id": "<ID>",
      "type": "products",
      "links": {
        "self": "https://api.idol.io/api/v2/products/<ID>"
      },
      "attributes": {
        "created-at": "2022-08-30T18:52:22.000+02:00",
        "updated-at": "2023-05-28T14:23:11.054+02:00",
        "name": "Dark Side of the Moon",
        "status": "draft",
        "cover-url": "https://api.idol.io/dragonfly/W1siZiIsIi8yMDEyLzA4LzMwL1BvY2hldHRlIEFsYnVtLzM1MTE2XzEuanBnIl0sWyJwIiwidGh1bWIiLCIzMDB4MzAwIyIseyJmb3JtYXQiOiJqcGcifV1d.jpg?sha=a96d60dfde6d1046",
        "upc-code": "3700551739424",
        "release-date": "2022-08-27T00:00:00.000Z",
        "original-release-date": "2020-08-28T00:00:00.000Z",
        "mastered-by": "",
        "copyright-line": "1973 Pink Floyd",
        "production-line": "1973 Pink Floyd",
        "production-year": 1973,
        "label-internal-reference": "Moon001",
        "content-validation": false,
        "import-validation": false,
        "default-offer-validation": false,
        "is-active": false,
        "subtitle": "",
        "prod-comments": "",
        "label-comments": "",
        "front-cover": null,
        "booklet-url": null,
        "artist": [
          "Pink Floyd"
        ],
        "contributor": [
          "contributor 1",
          "contributor 2"
        ],
        "featuring": [
          "featuring 1",
          "featuring 2"
        ],
        "remixer": [
          "remixer 1",
          "remixer 2"
        ],
        "composer": [
          "composer 1",
          "composer 2"
        ],
        "author": [
          "author 1",
          "author 2"
        ],
        "is-mfit": false,
        "is-destroyable": true,
        "audio16bits": true,
        "audio24bits": false,
        "all16bits": true,
        "all24bits": false,
        "audios": true,
        "is-back-catalogue": false
      },
      "relationships": {
        "distributor": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/distributor",
            "related": "https://api.idol.io/api/v2/products/<ID>/distributor"
          },
          "data": {
            "type": "distributors",
            "id": "<ID>"
          }
        },
        "company": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/company",
            "related": "https://api.idol.io/api/v2/products/<ID>/company"
          },
          "data": {
            "type": "companies",
            "id": "<ID>"
          }
        },
        "label": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/label",
            "related": "https://api.idol.io/api/v2/products/<ID>/label"
          },
          "data": {
            "type": "labels",
            "id": "<ID>"
          }
        },
        "product-type": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/product-type",
            "related": "https://api.idol.io/api/v2/products/<ID>/product-type"
          },
          "data": {
            "type": "product-types",
            "id": "<ID>"
          }
        },
        "default-offer": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/default-offer",
            "related": "https://api.idol.io/api/v2/products/<ID>/default-offer"
          },
          "data": {
            "type": "offers",
            "id": "<ID>"
          }
        },
        "offers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/offers",
            "related": "https://api.idol.io/api/v2/products/<ID>/offers"
          }
        },
        "submissions": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/submissions",
            "related": "https://api.idol.io/api/v2/products/<ID>/submissions"
          }
        },
        "rights": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/rights",
            "related": "https://api.idol.io/api/v2/products/<ID>/rights"
          }
        },
        "tracks": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tracks",
            "related": "https://api.idol.io/api/v2/products/<ID>/tracks"
          },
          "data": [
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            }
          ]
        },
        "performers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/performers",
            "related": "https://api.idol.io/api/v2/products/<ID>/performers"
          },
          "data": [
            {
              "type": "artists",
              "id": "<ID>"
            },
            {
              "type": "artists",
              "id": "<ID>"
            }
          ]
        },
        "tags": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tags",
            "related": "https://api.idol.io/api/v2/products/<ID>/tags"
          }
        },
        "authors": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/authors",
            "related": "https://api.idol.io/api/v2/products/<ID>/authors"
          }
        },
        "composers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/composers",
            "related": "https://api.idol.io/api/v2/products/<ID>/composers"
          }
        },
        "contributors": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/contributors",
            "related": "https://api.idol.io/api/v2/products/<ID>/contributors"
          }
        },
        "remixers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/remixers",
            "related": "https://api.idol.io/api/v2/products/<ID>/remixers"
          }
        },
        "featuring": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/featuring",
            "related": "https://api.idol.io/api/v2/products/<ID>/featuring"
          }
        }
      }
    },
    {
      "id": "<ID>",
      "type": "products",
      "links": {
        "self": "https://api.idol.io/api/v2/products/<ID>"
      },
      "attributes": {
        "created-at": "2012-08-30T18:53:02.000+02:00",
        "updated-at": "2017-11-30T14:48:01.470+01:00",
        "name": "Teknival 09/<ID> Boom",
        "status": "draft",
        "cover-url": "https://api.idol.io/dragonfly/W1siZiIsIi8yMDEyLzA4LzMwL1BvY2hldHRlIEFsYnVtLzM1MTE3XzEuanBnIl0sWyJwIiwidGh1bWIiLCIzMDB4MzAwIyIseyJmb3JtYXQiOiJqcGcifV1d.jpg?sha=e82e6ca5eafb5481",
        "upc-code": "3700551739431",
        "release-date": "2012-08-28T00:00:00.000Z",
        "original-release-date": "2012-08-29T00:00:00.000Z",
        "mastered-by": "",
        "copyright-line": "2012 idolboom",
        "production-line": "2012 idolboom",
        "production-year": 2012,
        "label-internal-reference": "boom2",
        "content-validation": false,
        "import-validation": false,
        "default-offer-validation": true,
        "is-active": false,
        "subtitle": null,
        "prod-comments": "",
        "label-comments": "",
        "front-cover": null,
        "booklet-url": null,
        "artist": [
          "Various Artists"
        ],
        "contributor": null,
        "featuring": null,
        "remixer": null,
        "composer": null,
        "author": null,
        "is-mfit": false,
        "is-destroyable": false,
        "audio16bits": true,
        "audio24bits": false,
        "all16bits": true,
        "all24bits": false,
        "audios": true,
        "is-back-catalogue": false
      },
      "relationships": {
        "distributor": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/distributor",
            "related": "https://api.idol.io/api/v2/products/<ID>/distributor"
          },
          "data": {
            "type": "distributors",
            "id": "<ID>"
          }
        },
        "company": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/company",
            "related": "https://api.idol.io/api/v2/products/<ID>/company"
          },
          "data": {
            "type": "companies",
            "id": "<ID>"
          }
        },
        "label": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/label",
            "related": "https://api.idol.io/api/v2/products/<ID>/label"
          },
          "data": {
            "type": "labels",
            "id": "<ID>"
          }
        },
        "product-type": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/product-type",
            "related": "https://api.idol.io/api/v2/products/<ID>/product-type"
          },
          "data": {
            "type": "product-types",
            "id": "<ID>"
          }
        },
        "default-offer": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/default-offer",
            "related": "https://api.idol.io/api/v2/products/<ID>/default-offer"
          },
          "data": {
            "type": "offers",
            "id": "<ID>"
          }
        },
        "offers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/offers",
            "related": "https://api.idol.io/api/v2/products/<ID>/offers"
          }
        },
        "submissions": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/submissions",
            "related": "https://api.idol.io/api/v2/products/<ID>/submissions"
          }
        },
        "rights": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/rights",
            "related": "https://api.idol.io/api/v2/products/<ID>/rights"
          }
        },
        "tracks": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tracks",
            "related": "https://api.idol.io/api/v2/products/<ID>/tracks"
          },
          "data": [
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            },
            {
              "type": "tracks",
              "id": "<ID>"
            }
          ]
        },
        "performers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/performers",
            "related": "https://api.idol.io/api/v2/products/<ID>/performers"
          },
          "data": [
            {
              "type": "artists",
              "id": "<ID>"
            },
            {
              "type": "artists",
              "id": "<ID>"
            },
            {
              "type": "artists",
              "id": "<ID>"
            },
            {
              "type": "artists",
              "id": "<ID>"
            },
            {
              "type": "artists",
              "id": "<ID>"
            },
            {
              "type": "artists",
              "id": "<ID>"
            },
            {
              "type": "artists",
              "id": "<ID>"
            },
            {
              "type": "artists",
              "id": "<ID>"
            },
            {
              "type": "artists",
              "id": "<ID>"
            }
          ]
        },
        "tags": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tags",
            "related": "https://api.idol.io/api/v2/products/<ID>/tags"
          }
        },
        "authors": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/authors",
            "related": "https://api.idol.io/api/v2/products/<ID>/authors"
          }
        },
        "composers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/composers",
            "related": "https://api.idol.io/api/v2/products/<ID>/composers"
          }
        },
        "contributors": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/contributors",
            "related": "https://api.idol.io/api/v2/products/<ID>/contributors"
          }
        },
        "remixers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/remixers",
            "related": "https://api.idol.io/api/v2/products/<ID>/remixers"
          }
        },
        "featuring": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/featuring",
            "related": "https://api.idol.io/api/v2/products/<ID>/featuring"
          }
        }
      }
    },
    {
      "id": "<ID>",
      "type": "products",
      "links": {
        "self": "https://api.idol.io/api/v2/products/<ID>"
      },
      "attributes": {
        "created-at": "2020-08-30T18:53:29.000+02:00",
        "updated-at": "2023-11-30T14:47:59.800+01:00",
        "name": "Kro-boom",
        "status": "draft",
        "cover-url": "https://api.idol.io/dragonfly/W1siZiIsIi8yMDEyLzA4LzMwL1BvY2hldHRlIEFsYnVtLzM1MTE4XzEuanBnIl0sWyJwIiwidGh1bWIiLCIzMDB4MzAwIyIseyJmb3JtYXQiOiJqcGcifV1d.jpg?sha=66854de2150662fd",
        "upc-code": "3700551739448",
        "release-date": "2020-08-29T00:00:00.000Z",
        "original-release-date": "2019-08-30T00:00:00.000Z",
        "mastered-by": "",
        "copyright-line": "2020 recordboom",
        "production-line": "2020 recordboom",
        "production-year": 2012,
        "label-internal-reference": "boom321",
        "content-validation": false,
        "import-validation": false,
        "default-offer-validation": false,
        "is-active": false,
        "subtitle": null,
        "prod-comments": "",
        "label-comments": "",
        "front-cover": null,
        "booklet-url": null,
        "artist": [
          "Kluba Wylliam"
        ],
        "contributor": null,
        "featuring": null,
        "remixer": null,
        "composer": null,
        "author": null,
        "is-mfit": false,
        "is-destroyable": true,
        "audio16bits": true,
        "audio24bits": false,
        "all16bits": true,
        "all24bits": false,
        "audios": true,
        "is-back-catalogue": false
      },
      "relationships": {
        "distributor": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/distributor",
            "related": "https://api.idol.io/api/v2/products/<ID>/distributor"
          },
          "data": {
            "type": "distributors",
            "id": "<ID>"
          }
        },
        "company": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/company",
            "related": "https://api.idol.io/api/v2/products/<ID>/company"
          },
          "data": {
            "type": "companies",
            "id": "<ID>"
          }
        },
        "label": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/label",
            "related": "https://api.idol.io/api/v2/products/<ID>/label"
          },
          "data": {
            "type": "labels",
            "id": "<ID>"
          }
        },
        "product-type": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/product-type",
            "related": "https://api.idol.io/api/v2/products/<ID>/product-type"
          },
          "data": {
            "type": "product-types",
            "id": "<ID>"
          }
        },
        "default-offer": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/default-offer",
            "related": "https://api.idol.io/api/v2/products/<ID>/default-offer"
          },
          "data": {
            "type": "offers",
            "id": "<ID>"
          }
        },
        "offers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/offers",
            "related": "https://api.idol.io/api/v2/products/<ID>/offers"
          }
        },
        "submissions": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/submissions",
            "related": "https://api.idol.io/api/v2/products/<ID>/submissions"
          }
        },
        "rights": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/rights",
            "related": "https://api.idol.io/api/v2/products/<ID>/rights"
          }
        },
        "tracks": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tracks",
            "related": "https://api.idol.io/api/v2/products/<ID>/tracks"
          },
          "data": [
            {
              "type": "tracks",
              "id": "<ID>"
            }
          ]
        },
        "performers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/performers",
            "related": "https://api.idol.io/api/v2/products/<ID>/performers"
          },
          "data": [
            {
              "type": "artists",
              "id": "<ID>"
            }
          ]
        },
        "tags": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tags",
            "related": "https://api.idol.io/api/v2/products/<ID>/tags"
          }
        },
        "authors": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/authors",
            "related": "https://api.idol.io/api/v2/products/<ID>/authors"
          }
        },
        "composers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/composers",
            "related": "https://api.idol.io/api/v2/products/<ID>/composers"
          }
        },
        "contributors": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/contributors",
            "related": "https://api.idol.io/api/v2/products/<ID>/contributors"
          }
        },
        "remixers": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/remixers",
            "related": "https://api.idol.io/api/v2/products/<ID>/remixers"
          }
        },
        "featuring": {
          "links": {
            "self": "https://api.idol.io/api/v2/products/<ID>/relationships/featuring",
            "related": "https://api.idol.io/api/v2/products/<ID>/featuring"
          }
        }
      }
    }
  ],
  "meta": {
    "editing-record-count": 104,
    "record-count": 110,
    "page-count": 37
  },
  "links": {
    "first": "https://api.idol.io/api/v2/products?page%5Bnumber%5D=1&page%5Bsize%5D=3",
    "next": "https://api.idol.io/api/v2/products?page%5Bnumber%5D=2&page%5Bsize%5D=3",
    "last": "https://api.idol.io/api/v2/products?page%5Bnumber%5D=37&page%5Bsize%5D=3"
  }
}

Filter resources

Distributor

api/v2/products?filter[distributor-id]=1

Companies

api/v2/products?filter[company-ids]=1,2

Labels

api/v2/products?filter[label-ids]=1,2

Genres

api/v2/products?filter[product-genre-ids]=1,2

Subgenres

api/v2/products?filter[distributor-product-subgenre-ids]=1,2

Statuses

# draft
# reviewing
# active
# archived

api/v2/products?filter[statuses]=draft,active

UpcCode

api/v2/products?filter[upc-code]=9832422323234

Get Product

GET https://api.idol.io/api/v2/products/:id

Path Parameters

Name	Type	Description
id*	number	ID of the Product

Headers

Name	Type	Description
Authorization*	string	Bearer <token>
Content-Type*	string	application/vnd.api+json

200

{
  "data": {
    "id": "<ID>",
    "type": "products",
    "links": {
      "self": "https://api.idol.io/api/v2/products/<ID>"
    },
    "attributes": {
      "created-at": "2020-08-30T18:52:22.000+02:00",
      "updated-at": "2022-05-28T14:23:11.054+02:00",
      "name": "Dark Side of the Moon",
      "status": "draft",
      "cover-url": "https://api.idol.io/dragonfly/W1siZiIsIi8yMDEyLzA4LzMwL1BvY2hldHRlIEFsYnVtLzM1MTE2XzEuanBnIl0sWyJwIiwidGh1bWIiLCIzMDB4MzAwIyIseyJmb3JtYXQiOiJqcGcifV1d.jpg?sha=a96d60dfde6d1046",
      "upc-code": "3700551739424",
      "release-date": "2020-08-27T00:00:00.000Z",
      "original-release-date": "2020-08-28T00:00:00.000Z",
      "mastered-by": "",
      "copyright-line": "1973 Pink Floyd",
      "production-line": "1973 Pink Floyd",
      "production-year": 1973,
      "label-internal-reference": "Moon001",
      "content-validation": false,
      "import-validation": false,
      "default-offer-validation": false,
      "is-active": false,
      "subtitle": "",
      "prod-comments": "",
      "label-comments": "",
      "front-cover": null,
      "booklet-url": null,
      "artist": [
        "Pink Floyd"
      ],
      "contributor": [
        "contributor 1",
        "contributor 2"
      ],
      "featuring": [
        "featuring 1",
        "featuring 2"
      ],
      "remixer": [
        "remixer 1",
        "remixer 2"
      ],
      "composer": [
        "composer 1",
        "composer 2"
      ],
      "author": [
        "author 1",
        "author 2"
      ],
      "is-mfit": false,
      "is-destroyable": true,
      "audio16bits": true,
      "audio24bits": false,
      "all16bits": true,
      "all24bits": false,
      "audios": true,
      "is-back-catalogue": false
    },
    "relationships": {
      "distributor": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/distributor",
          "related": "https://api.idol.io/api/v2/products/<ID>/distributor"
        },
        "data": {
          "type": "distributors",
          "id": "<ID>"
        }
      },
      "company": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/company",
          "related": "https://api.idol.io/api/v2/products/<ID>/company"
        },
        "data": {
          "type": "companies",
          "id": "<ID>"
        }
      },
      "label": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/label",
          "related": "https://api.idol.io/api/v2/products/<ID>/label"
        },
        "data": {
          "type": "labels",
          "id": "<ID>"
        }
      },
      "product-type": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/product-type",
          "related": "https://api.idol.io/api/v2/products/<ID>/product-type"
        },
        "data": {
          "type": "product-types",
          "id": "<ID>"
        }
      },
      "default-offer": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/default-offer",
          "related": "https://api.idol.io/api/v2/products/<ID>/default-offer"
        },
        "data": {
          "type": "offers",
          "id": "<ID>"
        }
      },
      "offers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/offers",
          "related": "https://api.idol.io/api/v2/products/<ID>/offers"
        }
      },
      "submissions": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/submissions",
          "related": "https://api.idol.io/api/v2/products/<ID>/submissions"
        }
      },
      "rights": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/rights",
          "related": "https://api.idol.io/api/v2/products/<ID>/rights"
        }
      },
      "tracks": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tracks",
          "related": "https://api.idol.io/api/v2/products/<ID>/tracks"
        },
        "data": [
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          },
          {
            "type": "tracks",
            "id": "<ID>"
          }
        ]
      },
      "performers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/performers",
          "related": "https://api.idol.io/api/v2/products/<ID>/performers"
        },
        "data": [
          {
            "type": "artists",
            "id": "<ID>"
          },
          {
            "type": "artists",
            "id": "<ID>"
          }
        ]
      },
      "tags": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tags",
          "related": "https://api.idol.io/api/v2/products/<ID>/tags"
        }
      },
      "authors": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/authors",
          "related": "https://api.idol.io/api/v2/products/<ID>/authors"
        }
      },
      "composers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/composers",
          "related": "https://api.idol.io/api/v2/products/<ID>/composers"
        }
      },
      "contributors": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/contributors",
          "related": "https://api.idol.io/api/v2/products/<ID>/contributors"
        }
      },
      "remixers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/remixers",
          "related": "https://api.idol.io/api/v2/products/<ID>/remixers"
        }
      },
      "featuring": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/featuring",
          "related": "https://api.idol.io/api/v2/products/<ID>/featuring"
        }
      }
    }
  },
  "meta": {
    "editing-record-count": 104
  }
}

Create Product

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

Headers

Name	Type	Description
Authorization*	string	Bearer <token>
Content-Type*	string	application/vnd.api+json

Request Body

Name	Type	Description
product-type*	object	ProductType Object
label*	object	Label Object
name*	string	Album test
subtitle	string	Album subtitle
artist*	array	["Artist name"]
upc-code*	string	93847264721847
label-internal-reference	string	Catalog number
copyright-line*	string	2023 Test Copyright
production-line*	string	2023 Test Production
production-year*	string	2023
original-release-date	string	date - e.g. 2023-01-01
front-cover	string	Base64 - e.g. data:image/jpg;base64,JsqWlWh...
front-cover-md5	string	e2cf9dfacc282c31c8...
language	object	Language Object
tracks	object	Track Object
rights	object	Right Object
offers	object	Offer Object
status*	string	draft / reviewing / active / archived
booklet	string	Base64 - e.g. data:application/pdf;base64,JsqWlWh...
mastered-by	string	[email protected]
is-compilation	boolean	true
tags	object	Tag Object

In addition, you can add any available contributor role from the list provided at this endpoint to the input attribute, using the same syntax as the artist attribute.

200

{
  "data": {
    "id": "<ID>",
    "type": "products",
    "links": {
      "self": "https://api.idol.io/api/v2/products/<ID>"
    },
    "attributes": {
      "created-at": "2023-05-29T15:24:17.929+02:00",
      "updated-at": "2023-05-29T15:24:17.929+02:00",
      "name": "Demo album",
      "cover-url": "https://idolcamp.idol.io/dragonfly/W1siZmYiLCJwdWJsaWMvaW1hZ2VzL2RlZmF1bHRfY292ZXIucG5nIl0sWyJwIiwidGh1bWIiLCIzMDB4MzAwIyIseyJmb3JtYXQiOiJqcGcifV1d.jpg?sha=e647a9b04caeab50",
      "upc-code": "",
      "release-date": "2023-01-01T00:00:00.000Z",
      "original-release-date": null,
      "mastered-by": null,
      "copyright-line": "2023 Demo",
      "production-line": "2023 Demo",
      "production-year": 2023,
      "label-internal-reference": "",
      "content-validation": null,
      "import-validation": false,
      "default-offer-validation": null,
      "send-tasks-count": 0,
      "send-tasks-completed-count": 0,
      "send-tasks-error-count": 0,
      "send-tasks-stuck-count": 0,
      "is-active": true,
      "subtitle": null,
      "prod-comments": null,
      "label-comments": null,
      "front-cover": null,
      "artist": [
        "Artist demo"
      ],
      "contributor": null,
      "featuring": null,
      "remixer": null,
      "composer": null,
      "author": null,
      "is-mfit": false,
      "is-destroyable": true,
      "is-processing-num": false,
      "audio16bits": false,
      "audio24bits": false,
      "all16bits": false,
      "all24bits": false,
      "audios": false,
      "is-back-catalogue": false
    },
    "relationships": {
      "distributor": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/distributor",
          "related": "https://api.idol.io/api/v2/products/<ID>/distributor"
        },
        "data": {
          "type": "distributors",
          "id": "<ID>"
        }
      },
      "company": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/company",
          "related": "https://api.idol.io/api/v2/products/<ID>/company"
        },
        "data": {
          "type": "companies",
          "id": "<ID>"
        }
      },
      "label": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/label",
          "related": "https://api.idol.io/api/v2/products/<ID>/label"
        },
        "data": {
          "type": "labels",
          "id": "<ID>"
        }
      },
      "product-type": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/product-type",
          "related": "https://api.idol.io/api/v2/products/<ID>/product-type"
        },
        "data": null
      },
      "default-offer": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/default-offer",
          "related": "https://api.idol.io/api/v2/products/<ID>/default-offer"
        },
        "data": {
          "type": "offers",
          "id": "<ID>"
        }
      },
      "offers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/offers",
          "related": "https://api.idol.io/api/v2/products/<ID>/offers"
        }
      },
      "submissions": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/submissions",
          "related": "https://api.idol.io/api/v2/products/<ID>/submissions"
        }
      },
      "rights": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/rights",
          "related": "https://api.idol.io/api/v2/products/<ID>/rights"
        }
      },
      "tracks": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tracks",
          "related": "https://api.idol.io/api/v2/products/<ID>/tracks"
        },
        "data": []
      },
      "performers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/performers",
          "related": "https://api.idol.io/api/v2/products/<ID>/performers"
        },
        "data": []
      },
      "tags": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tags",
          "related": "https://api.idol.io/api/v2/products/<ID>/tags"
        }
      },
      "authors": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/authors",
          "related": "https://api.idol.io/api/v2/products/<ID>/authors"
        }
      },
      "composers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/composers",
          "related": "https://api.idol.io/api/v2/products/<ID>/composers"
        }
      },
      "contributors": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/contributors",
          "related": "https://api.idol.io/api/v2/products/<ID>/contributors"
        }
      },
      "remixers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/remixers",
          "related": "https://api.idol.io/api/v2/products/<ID>/remixers"
        }
      },
      "featuring": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/featuring",
          "related": "https://api.idol.io/api/v2/products/<ID>/featuring"
        }
      }
    }
  }
}

Update Product

PUT https://api.idol.io/api/v2/products/:id

Path Parameters

Name	Type	Description
id	number	ID of the Product

Headers

Name	Type	Description
Authorization	string	Bearer <token>
Content-Type	string	application/vnd.api+json

Request Body

Name	Type	Description
original-release-date	string	date - e.g. 2023-01-01
label-internal-reference	string	Catalog number
label*	object	Label Object
product-type*	object	ProductType Object
language	object	Language Object
offers	object	Offer Object
rights	object	Right Object
tracks	object	Track Object
tags	object	Tag Object
name*	string	Album test
subtitle	string	Album subtitle
upc-code*	string	93847264721847
status*	string	draft / reviewing / active / archived
front-cover	string	Base64 - e.g. data:image/jpg;base64,JsqWlWh...
front-cover-md5	string	e2cf9dfacc282c31c8...
is-compilation	boolean	true
copyright-line*	string	2023 Test Copyright
production-line*	string	2023 Test Production
production-year*	string	2023
mastered-by	string	[email protected]
artist*	array	["Artist name"]
booklet	string	Base64 - e.g. data:application/pdf;base64,JsqWlWh...

200

{
  "data": {
    "id": "<ID>",
    "type": "products",
    "links": {
      "self": "https://api.idol.io/api/v2/products/<ID>"
    },
    "attributes": {
      "created-at": "2023-05-29T15:24:17.929+02:00",
      "updated-at": "2023-05-29T15:24:17.929+02:00",
      "name": "Demo album",
      "cover-url": "https://idolcamp.idol.io/dragonfly/W1siZmYiLCJwdWJsaWMvaW1hZ2VzL2RlZmF1bHRfY292ZXIucG5nIl0sWyJwIiwidGh1bWIiLCIzMDB4MzAwIyIseyJmb3JtYXQiOiJqcGcifV1d.jpg?sha=e647a9b04caeab50",
      "upc-code": "",
      "release-date": "2023-01-01T00:00:00.000Z",
      "original-release-date": null,
      "mastered-by": null,
      "copyright-line": "2023 Demo",
      "production-line": "2023 Demo",
      "production-year": 2023,
      "label-internal-reference": "",
      "content-validation": null,
      "import-validation": false,
      "default-offer-validation": null,
      "send-tasks-count": 0,
      "send-tasks-completed-count": 0,
      "send-tasks-error-count": 0,
      "send-tasks-stuck-count": 0,
      "is-active": true,
      "subtitle": null,
      "prod-comments": null,
      "label-comments": null,
      "front-cover": null,
      "artist": [
        "Artist demo"
      ],
      "contributor": null,
      "featuring": null,
      "remixer": null,
      "composer": null,
      "author": null,
      "is-mfit": false,
      "is-destroyable": true,
      "is-processing-num": false,
      "audio16bits": false,
      "audio24bits": false,
      "all16bits": false,
      "all24bits": false,
      "audios": false,
      "is-back-catalogue": false
    },
    "relationships": {
      "distributor": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/distributor",
          "related": "https://api.idol.io/api/v2/products/<ID>/distributor"
        },
        "data": {
          "type": "distributors",
          "id": "<ID>"
        }
      },
      "company": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/company",
          "related": "https://api.idol.io/api/v2/products/<ID>/company"
        },
        "data": {
          "type": "companies",
          "id": "<ID>"
        }
      },
      "label": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/label",
          "related": "https://api.idol.io/api/v2/products/<ID>/label"
        },
        "data": {
          "type": "labels",
          "id": "<ID>"
        }
      },
      "product-type": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/product-type",
          "related": "https://api.idol.io/api/v2/products/<ID>/product-type"
        },
        "data": null
      },
      "default-offer": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/default-offer",
          "related": "https://api.idol.io/api/v2/products/<ID>/default-offer"
        },
        "data": {
          "type": "offers",
          "id": "<ID>"
        }
      },
      "offers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/offers",
          "related": "https://api.idol.io/api/v2/products/<ID>/offers"
        }
      },
      "submissions": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/submissions",
          "related": "https://api.idol.io/api/v2/products/<ID>/submissions"
        }
      },
      "rights": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/rights",
          "related": "https://api.idol.io/api/v2/products/<ID>/rights"
        }
      },
      "tracks": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tracks",
          "related": "https://api.idol.io/api/v2/products/<ID>/tracks"
        },
        "data": []
      },
      "performers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/performers",
          "related": "https://api.idol.io/api/v2/products/<ID>/performers"
        },
        "data": []
      },
      "tags": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/tags",
          "related": "https://api.idol.io/api/v2/products/<ID>/tags"
        }
      },
      "authors": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/authors",
          "related": "https://api.idol.io/api/v2/products/<ID>/authors"
        }
      },
      "composers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/composers",
          "related": "https://api.idol.io/api/v2/products/<ID>/composers"
        }
      },
      "contributors": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/contributors",
          "related": "https://api.idol.io/api/v2/products/<ID>/contributors"
        }
      },
      "remixers": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/remixers",
          "related": "https://api.idol.io/api/v2/products/<ID>/remixers"
        }
      },
      "featuring": {
        "links": {
          "self": "https://api.idol.io/api/v2/products/<ID>/relationships/featuring",
          "related": "https://api.idol.io/api/v2/products/<ID>/featuring"
        }
      }
    }
  }
}

In addition, you can add any available role from the list available on this endpoint into the input attribute, using the same syntax as the artist attribute.

Delete Product

DELETE https://api.idol.io/api/v2/products/:id

Path Parameters

Name	Type	Description
id*	number	ID of the Group

Headers

Name	Type	Description
Authorization*	string	Bearer <token>
Content-Type*	string	application/vnd.api+json

200

You are able to destroy a product only if its status is Draft or Reviewing and if it has no DspStates associated