POST
/
ws
/
1.1
/
work.post
curl --request POST \
  --url https://api.musixmatch.com/ws/1.1/work.post \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "collection": {
      "territories": [
        {
          "code": "IT",
          "mech_share": 10000,
          "sync_share": 10000
        }
      ],
      "validity_begin": "2023-07-17"
    },
    "identifier": "00001100196005",
    "owners": {
      "publisher": [
        {
          "controlled": "Y",
          "name": "Sony/Atv Tunes Llc"
        }
      ],
      "writer": [
        {
          "controlled": "Y",
          "mech_ownership_share": 5000,
          "name": "John Lennon",
          "role": "CA",
          "sync_ownership_share": 5000
        },
        {
          "controlled": "Y",
          "mech_ownership_share": 5000,
          "name": "Paul McCartney",
          "role": "CA",
          "sync_ownership_share": 5000
        }
      ]
    }
  }
}'
{
  "message": {
    "body": {
      "alternate_titles": [
        {
          "title": "Yellow Submarine"
        }
      ],
      "collections": {
        "2023-07-17": {
          "territories": [
            {
              "code": "IT",
              "countries": [
                "IT"
              ],
              "mech_share": 10000,
              "perf_share": 0,
              "publisher": null,
              "sync_share": 10000
            }
          ],
          "validity_begin": "2023-07-17",
          "validity_end": null
        }
      },
      "identifier": "00001100196005",
      "is_disabled": 0,
      "isrc": [],
      "iswc": "",
      "last_trasmission": "2023-07-17",
      "owners": {
        "publisher": [
          {
            "controlled": "Y",
            "id": 211,
            "identifier": "",
            "ipi": "00000000000",
            "mech_ownership_share": 0,
            "mech_society": null,
            "name": "Sony/Atv Tunes Llc",
            "perf_ownership_share": 0,
            "perf_society": null,
            "role": null,
            "sync_ownership_share": 0,
            "sync_society": null,
            "type": "publisher",
            "validity_begin": "2023-07-17"
          }
        ],
        "writer": [
          {
            "controlled": "Y",
            "id": 11353,
            "identifier": "",
            "ipi": "00000000000",
            "mech_ownership_share": 5000,
            "mech_society": null,
            "name": "John Lennon",
            "perf_ownership_share": 0,
            "perf_society": null,
            "role": "CA",
            "sync_ownership_share": 5000,
            "sync_society": null,
            "type": "writer",
            "validity_begin": null
          },
          {
            "controlled": "Y",
            "id": 11354,
            "identifier": "",
            "ipi": "00000000000",
            "mech_ownership_share": 5000,
            "mech_society": null,
            "name": "Paul McCartney",
            "perf_ownership_share": 0,
            "perf_society": null,
            "role": "CA",
            "sync_ownership_share": 5000,
            "sync_society": null,
            "type": "writer",
            "validity_begin": null
          }
        ]
      },
      "ownership": [],
      "performers": [],
      "publisher_short_name": "Sony",
      "source": {
        "affiliation": null,
        "control": false,
        "created": "2011-12-09",
        "credits_priority": "15",
        "description": "SonyATV / EMI",
        "id": 1,
        "last_updated": "2024-10-22 16:47:38",
        "report": "create",
        "sender_id": "00269021863",
        "sender_name": "SONY/ATV MUSIC PUBLISHING LLC",
        "short_name": "Sony",
        "type_of_right": "SYN",
        "validity_begin": "2010-11-04",
        "validity_end": null
      },
      "submissions": [
        {
          "creation_date": "2023-07-17",
          "disabled": "N",
          "filename": "api-works-2023-07-17.json",
          "id": 3401968,
          "source": 1,
          "transmission_date": "2023-07-17"
        }
      ],
      "tablespace": "works",
      "title": "Yellow Submarine",
      "type_of_right": "SYN",
      "validity_begin": null,
      "validity_end": "2024-10-20",
      "wgid": "works:191813604",
      "work_id": 191813604
    },
    "header": {
      "execute_time": 0.63219499588013,
      "status_code": 200
    }
  }
}

Use this api to submit new or updates of your publishing data.

This API is designed for and dedicated to publishers for posting royalties associated to a musical production (track). If you are a label and you’d like to send us lyrics in bulk, please refer to our commercial department.

Such details include licenses and their respective ownership quotas, collected royalties on a per-territory basis, plus some additional metadata that helps us match your Work with other Works submitted by other sources that partecipate in the royalties collection, and with the songs in our catalog — e.g. ISRCs, Performers, alternate titles.

Please note that you are responsible for transmitting only trustworthy and verified data.

Authorizations

​
apikey
string
query
required

Body

application/json

The data schema for submitting data of a musical work.

​
value
object

Response

200 - application/json
200 OK / 401 Unauthorized / 400 Bad Request
​
message
object
Checklist before going livework.validity.post