> ## 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. # Get a recording's publishing in full > Up to 25 recordings by ISRC plus the territories to report collection for, the recordings' musical works out in full: each work's ISWC, its ownership as publisher and writer lists, and what is collectible in each requested territory. `territory_list` scopes `collection` and nothing else - which works a recording resolves to does not depend on territory. Shares come back as band labels. The precise numbers are a separately priced add-on: set `options.exact_ownership` if your key carries it, otherwise the option is a 403. ## OpenAPI ````yaml /enterprises/publishing/openapi.json post /ws/1.1/musicalwork.recording.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.recording.details.search.post: post: tags: - Sound Recording summary: Get a recording's publishing in full description: >- Up to 25 recordings by ISRC plus the territories to report collection for, the recordings' musical works out in full: each work's ISWC, its ownership as publisher and writer lists, and what is collectible in each requested territory. `territory_list` scopes `collection` and nothing else - which works a recording resolves to does not depend on territory. Shares come back as band labels. The precise numbers are a separately priced add-on: set `options.exact_ownership` if your key carries it, otherwise the option is a 403. operationId: musicalworkRecordingDetailsSearchPost requestBody: required: true content: application/json: schema: allOf: - $ref: '#/components/schemas/RecordingList' - 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: recording_list: - isrc: USRC17607839 territory_list: - US - GB options: exact_ownership: true responses: '200': description: One entry per submitted recording, in request order. content: application/json: schema: $ref: '#/components/schemas/RecordingPublishingEnvelope' example: message: header: status_code: 200 execute_time: 0.411 body: - title: Rolling in the Deep isrc: USRC17607839 artist_list: - Adele musical_work_list: - iswc: T9214745718 ownership: publisher_list: - name: Universal Music Publishing Group ipi: '00052210040' role: E mech_ownership_share: 50 writer_list: - name: Adele Adkins ipi: '00528181729' role: CA mech_ownership_share: 50 - name: Paul Epworth ipi: null role: CA mech_ownership_share: 50 collection: - code: US mech_share: 50 - code: GB mech_share: 25 '400': $ref: '#/components/responses/BadRequest' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/ServerError' components: schemas: RecordingList: type: object required: - recording_list properties: recording_list: type: array minItems: 1 maxItems: 25 description: >- The recordings to look up, 1 to 25. An ISRC is accepted hyphenated and in lower case. A row carries `isrc` and nothing else: any other property is a 400 on the whole request. items: type: object required: - isrc additionalProperties: false properties: isrc: type: string description: The recording's ISRC, e.g. `USRC17607839` or `GB-ARL-10-01600` RecordingPublishingEnvelope: type: object properties: message: type: object properties: header: $ref: '#/components/schemas/Header' body: type: array description: One entry per submitted recording, in request order. items: type: object properties: title: type: - string - 'null' isrc: type: string artist_list: type: array items: type: string musical_work_list: type: array description: >- The recording's chosen works. Empty for a recording we hold no publishing for. items: $ref: '#/components/schemas/MusicalWork' 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 MusicalWork: type: object properties: iswc: type: - string - 'null' description: The work's ISWC. `null` for a registration carrying none. 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/RightsHolder' writer_list: type: array items: $ref: '#/components/schemas/RightsHolder' collection: type: array description: >- The controlled part collectible in each requested territory. Scoped by `territory_list`; the set of works is not. items: $ref: '#/components/schemas/CollectionEntry' 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: {} 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' CollectionEntry: type: object description: >- What is collectible in one requested territory. Present only where collection is on file: a territory with nothing, or with nothing above zero, 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' 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 API key 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 ````