---
title: "Musical Works Relationships"
method: GET
path: "/musical_works/{id}/relationships"
tags: ["Musical Works"]
---

# Musical Works Relationships

`GET /musical_works/{id}/relationships`

## Request

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

Receive a paginated list of the entities related to a Musical Work, ordered by the strength of the relationship. Currently only Musical Recordings are returned.

## Path parameters

- `id` string, required: Unique Luminate ID or ISWC assigned to the Musical Work.

## Query parameters

- `id_type` 'luminate' | 'iswc', required
- `from` integer: Starting position for the list of results.
- `size` integer: The maximum amount of results the endpoint will return.

## Headers

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

## Response `200`

OK

- MusicalWorkRelationshipsResponse
  - `relationships` object[]: Entities related to the Musical Work, keyed by entity type. Currently only `musical_recording` is returned. Empty when the Musical Work has no relationships.
  - `from` integer: Starting position of the returned results.
  - `size` integer: Maximum number of results returned.
  - `total_results` integer: Total number of relationships available for the Musical Work.

---

[API](https://skmtc.dev/luminatedata/apis/luminate-music-api.md) - [All operations](https://skmtc.dev/luminatedata/apis/luminate-music-api/llms.txt) - [OpenAPI document](https://skmtc.dev/luminatedata/apis/luminate-music-api/revisions/271d2be26e14?raw)
