> ## Documentation Index > Fetch the complete documentation index at: https://docs.musixmatch.com/llms.txt > Use this file to discover all available pages before exploring further. # musicalwork.details.search.post > Up to 25 musical works by ISWC plus the territories to report collection for. The publishing behind each comes back in full, in one response with no paging: every registration we hold, with its publisher and writer lists and what is collectible in each requested territory. The same information as `musicalwork.recording.details.search.post`, starting from an ISWC instead of an ISRC. Each registration also says who sent it (`source`) and when (`transmission_date`), and each rights holder whether it is `controlled`, so registrations that disagree can be told apart. `territory_list` scopes `collection` and nothing else - which registrations a work resolves to does not depend on territory. Registrations whose publishers and writers add up to more than 100% on any right are not returned. Registrations received from TheMLC are returned only for an ISWC with no other registration carrying an active share, and carry a US-only collection with the mechanical share alone. Shares come back as band labels (`0-30`, `30-70`, `70-100`). With `options.exact_ownership` they carry the precise figure instead. That is a separately priced add-on: an apikey without it gets a 403 for the option, not a band. ## OpenAPI ````yaml enterprises/publishing/openapi.json post /ws/1.1/musicalwork.details.search.post openapi: 3.1.0 info: title: Musixmatch Publishing API version: 1.0.0 description: >- Read the publishing side of the Musixmatch catalog: given a recording, who administers and owns its musical works; given a musical work, which recordings exist of it; given a writer, which works are credited to them. Every method answers over HTTP 200. The outcome of the call is `message.header.status_code`, and a 4xx carries a prose `hint` beside a machine-readable `hint_code`. servers: - url: https://api.musixmatch.com security: - apiKey: [] paths: /ws/1.1/musicalwork.details.search.post: post: tags: - Musical work summary: musicalwork.details.search.post description: >- Up to 25 musical works by ISWC plus the territories to report collection for. The publishing behind each comes back in full, in one response with no paging: every registration we hold, with its publisher and writer lists and what is collectible in each requested territory. The same information as `musicalwork.recording.details.search.post`, starting from an ISWC instead of an ISRC. Each registration also says who sent it (`source`) and when (`transmission_date`), and each rights holder whether it is `controlled`, so registrations that disagree can be told apart. `territory_list` scopes `collection` and nothing else - which registrations a work resolves to does not depend on territory. Registrations whose publishers and writers add up to more than 100% on any right are not returned. Registrations received from TheMLC are returned only for an ISWC with no other registration carrying an active share, and carry a US-only collection with the mechanical share alone. Shares come back as band labels (`0-30`, `30-70`, `70-100`). With `options.exact_ownership` they carry the precise figure instead. That is a separately priced add-on: an apikey without it gets a 403 for the option, not a band. operationId: musicalworkDetailsSearchPost requestBody: required: true content: application/json: schema: allOf: - $ref: '#/components/schemas/IswcList' - type: object required: - territory_list properties: territory_list: type: array minItems: 1 description: >- The ISO-2 country codes to report collection shares for, at least one. Accepted in lower case. items: type: string options: type: object additionalProperties: false description: >- `exact_ownership` is the only key accepted. Any other is a 400. properties: exact_ownership: type: boolean description: >- Return the precise share instead of its band label. A separately entitled product. example: iswc_list: - iswc: T9214745718 territory_list: - US - GB options: exact_ownership: true responses: '200': description: One entry per submitted ISWC, in request order. content: application/json: schema: $ref: '#/components/schemas/IswcDetailsEnvelope' example: message: header: status_code: 200 execute_time: 0.411 body: - iswc: T9214745718 musical_work_list: - ownership: publisher_list: - name: Universal Music Publishing Group ipi: '00052210040' role: E mech_ownership_share: 50 perf_ownership_share: 50 sync_ownership_share: 50 controlled: true writer_list: - name: Adele Adkins ipi: '00528181729' role: CA mech_ownership_share: 50 perf_ownership_share: 50 sync_ownership_share: 50 controlled: true - name: Paul Epworth ipi: null role: CA mech_ownership_share: 50 perf_ownership_share: 50 sync_ownership_share: 50 controlled: false collection: - code: US mech_share: 50 perf_share: 50 sync_share: 50 - code: GB mech_share: 25 perf_share: 25 sync_share: null source: name: Universal Music Publishing transmission_date: '2024-03-18' '400': $ref: '#/components/responses/BadRequest' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/ServerError' components: schemas: IswcList: type: object required: - iswc_list properties: iswc_list: type: array minItems: 1 maxItems: 25 description: >- The musical works to look up, 1 to 25. An ISWC is accepted hyphenated and in lower case. A row carries `iswc` and nothing else: any other property is a 400 on the whole request. items: type: object required: - iswc additionalProperties: false properties: iswc: type: string description: >- The musical work's ISWC, e.g. `T9214745718` or `T-921.474.571-8` IswcDetailsEnvelope: type: object properties: message: type: object properties: header: $ref: '#/components/schemas/Header' body: type: array description: >- One entry per submitted ISWC, in request order. A duplicate in the request is a duplicate in the answer. items: type: object properties: iswc: type: string description: The ISWC, as submitted, in its canonical form. musical_work_list: type: array description: >- The registrations we hold for the work. Empty for an ISWC we hold nothing for. items: $ref: '#/components/schemas/IswcRegistration' Header: type: object properties: status_code: type: integer description: The outcome of the call. The HTTP status is always 200. execute_time: type: number description: Server-side execution time in seconds IswcRegistration: type: object description: >- One registration of the musical work. It carries no `iswc` of its own: the entry it sits in has it. properties: ownership: type: object description: >- Ownership of the work itself, carrying no territory: a publisher owning a share owns that share everywhere. properties: publisher_list: type: array items: $ref: '#/components/schemas/ControlledRightsHolder' writer_list: type: array items: $ref: '#/components/schemas/ControlledRightsHolder' collection: type: array description: >- The controlled part collectible in each requested territory. Scoped by `territory_list`; the set of registrations is not. items: $ref: '#/components/schemas/CollectionEntry' source: type: object description: Who sent this registration. properties: name: type: - string - 'null' description: The data sender's name. `null` when the registration has none. transmission_date: type: - string - 'null' description: >- The date the registration was transmitted to us, `YYYY-MM-DD`. `null` when unknown. ErrorResponse: type: object properties: message: type: object properties: header: type: object properties: status_code: type: integer execute_time: type: number hint: type: string description: What is wrong with the request, in prose hint_code: type: string description: >- A stable slug for the same fault. Part of the contract; the prose is not. enum: - invalid_request - unknown_property - too_many_items - invalid_isrc - invalid_iswc - invalid_ipi - page_unreachable body: type: array items: {} ControlledRightsHolder: description: >- A publisher or writer credited on the registration, with whether the registration marks it as controlled. allOf: - $ref: '#/components/schemas/RightsHolder' - type: object properties: controlled: type: - boolean - 'null' description: >- `true` when the registration marks the rights holder as controlled, `false` when it does not, `null` when the data carries no value. Always the last property of the holder. CollectionEntry: type: object description: >- What is collectible in one requested territory, per right. Present only where collection is on file for at least one right above zero: a territory with nothing is omitted rather than reported as zero. properties: code: type: string description: The ISO-2 country code, echoing the one requested mech_share: $ref: '#/components/schemas/Share' perf_share: $ref: '#/components/schemas/Share' sync_share: $ref: '#/components/schemas/Share' RightsHolder: type: object description: A publisher or writer credited on the musical work. properties: name: type: - string - 'null' ipi: type: - string - 'null' role: type: - string - 'null' description: >- The CWR role code the registration carries, e.g. `E` (original publisher), `CA` (composer/author). mech_ownership_share: $ref: '#/components/schemas/Share' perf_ownership_share: $ref: '#/components/schemas/Share' sync_ownership_share: $ref: '#/components/schemas/Share' Share: description: >- A share on a 0-100 scale. By default a band label (`0-30`, `30-70`, `70-100`); the precise number when `options.exact_ownership` is set. `null` where the data carries no share: never a zero standing in for one. oneOf: - type: string enum: - 0-30 - 30-70 - 70-100 - type: number - type: 'null' responses: BadRequest: description: >- The request is not usable. Returned over HTTP 200 with `status_code` 400 in the header, alongside `hint` and `hint_code`. Any fault fails the whole request: there is no per-row invalid state. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Forbidden: description: >- The apikey is not entitled to this method. Returned over HTTP 200 with `status_code` 403 in the header. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ServerError: description: >- A read failed. Returned over HTTP 200 with `status_code` 500 in the header. A failed read is never an empty result. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: apiKey: type: apiKey name: apikey in: query ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.