LUluminatedata
Musical Works

Musical Works

Receive metadata for a Musical Work using a Luminate ID or ISWC.

get/musical_works/{id}

Request

  • Base URL
    https://api.luminatedata.com
  • URL
    https://api.luminatedata.com/musical_works/{id}
  • Auth
    API key in header x-api-key and API key in header authorization

Path parameters

idstring required

Unique Luminate ID or ISWC assigned to the Musical Work.

Example:ID

Query parameters

id_type'luminate' | 'iswc' required

Use the id_type parameter to specify the source of the ID. If the id_type is not specified, the endpoint will expect a Luminate ID.

metadata_level'max' | 'min'

Specify the volume of metadata returned in the response.

Headers

Accept'application/vnd.luminate-data.svc-apibff.v1+json'

Response

OK

idstring

Unique Luminate ID assigned to the Musical Work.

iswcstring

International Standard Musical Work Code assigned to the Musical Work.

titlestring

Title of the Musical Work.

statusstring

Registration status of the Musical Work. Returned when metadata_level is max.

registration_datestring

Date the Musical Work was registered. Returned when metadata_level is max.

Example response

{
  "iswc": "T0101545054",
  "creators": [
    {
      "role": "Composer",
      "ipi": "00052210040"
    }
  ],
  "status": "Preferred",
  "registration_date": "2015-03-16"
}

Changes

No recorded changes to this operation across all 1 revision of this API.