Authorizations
Body
application/json
The data schema for submitting data of a musical work.
Response
200 - application/json
200 OK / 400 Bad Request / 401 Unauthorized
curl --request POST \
--url https://api.musixmatch.com/ws/1.1/work.post \
--header 'Content-Type: application/json' \
--data '{
"data": {
"identifier": "<string>",
"title": "<string>",
"alternate_titles": [
"<string>"
],
"iswc": "<string>",
"isrc": [
"<string>"
],
"performers": [
{
"name": "<string>",
"identifier": "<string>"
}
],
"owners": {
"publisher": [
{
"identifier": "<string>",
"name": "<string>",
"ipi": "<string>",
"role": "AQ",
"controlled": "Y",
"mech_ownership_share": 5003,
"perf_ownership_share": 5003,
"sync_ownership_share": 5003
}
],
"writer": [
{
"identifier": "<string>",
"name": "<string>",
"ipi": "<string>",
"role": "AD",
"controlled": "Y",
"mech_ownership_share": 5003,
"perf_ownership_share": 5003,
"sync_ownership_share": 5003
}
]
},
"collection": {
"validity_begin": "<string>",
"validity_end": "<string>",
"territories": [
{
"code": "<string>",
"mech_share": 5003,
"perf_share": 5003,
"sync_share": 5003
}
]
},
"lyrics": {
"duration": 123,
"lyrics": "<string>",
"lrc": "<string>"
}
}
}'
{
"message": {
"body": {
"alternate_titles": [
{
"title": "<string>"
}
],
"collections": {
"2023-07-17": {
"territories": [
{
"code": "<string>",
"countries": [
"<string>"
],
"mech_share": 123,
"perf_share": 123,
"publisher": "<any>",
"sync_share": 123
}
],
"validity_begin": "<string>",
"validity_end": "<any>"
}
},
"identifier": "<string>",
"is_disabled": 123,
"isrc": [
"<any>"
],
"iswc": "<string>",
"last_trasmission": "<string>",
"owners": {
"publisher": [
{
"controlled": "<string>",
"id": 123,
"identifier": "<string>",
"ipi": "<string>",
"mech_ownership_share": 123,
"mech_society": "<any>",
"name": "<string>",
"perf_ownership_share": 123,
"perf_society": "<any>",
"role": "<any>",
"sync_ownership_share": 123,
"sync_society": "<any>",
"type": "<string>",
"validity_begin": "<string>"
}
],
"writer": [
{
"controlled": "<string>",
"id": 123,
"identifier": "<string>",
"ipi": "<string>",
"mech_ownership_share": 123,
"mech_society": "<any>",
"name": "<string>",
"perf_ownership_share": 123,
"perf_society": "<any>",
"role": "<string>",
"sync_ownership_share": 123,
"sync_society": "<any>",
"type": "<string>",
"validity_begin": "<any>"
}
]
},
"ownership": [
"<any>"
],
"performers": [
"<any>"
],
"publisher_short_name": "<string>",
"source": {
"affiliation": "<any>",
"control": true,
"created": "<string>",
"credits_priority": "<string>",
"description": "<string>",
"id": 123,
"last_updated": "<string>",
"report": "<string>",
"sender_id": "<string>",
"sender_name": "<string>",
"short_name": "<string>",
"type_of_right": "<string>",
"validity_begin": "<string>",
"validity_end": "<any>"
},
"submissions": [
{
"creation_date": "<string>",
"disabled": "<string>",
"filename": "<string>",
"id": 123,
"source": 123,
"transmission_date": "<string>"
}
],
"tablespace": "<string>",
"title": "<string>",
"type_of_right": "<string>",
"validity_begin": "<any>",
"validity_end": "<string>",
"wgid": "<string>",
"work_id": 123
},
"header": {
"execute_time": 123,
"hint": "<string>",
"status_code": 123
}
}
}
Submit a musical work’s details.
curl --request POST \
--url https://api.musixmatch.com/ws/1.1/work.post \
--header 'Content-Type: application/json' \
--data '{
"data": {
"identifier": "<string>",
"title": "<string>",
"alternate_titles": [
"<string>"
],
"iswc": "<string>",
"isrc": [
"<string>"
],
"performers": [
{
"name": "<string>",
"identifier": "<string>"
}
],
"owners": {
"publisher": [
{
"identifier": "<string>",
"name": "<string>",
"ipi": "<string>",
"role": "AQ",
"controlled": "Y",
"mech_ownership_share": 5003,
"perf_ownership_share": 5003,
"sync_ownership_share": 5003
}
],
"writer": [
{
"identifier": "<string>",
"name": "<string>",
"ipi": "<string>",
"role": "AD",
"controlled": "Y",
"mech_ownership_share": 5003,
"perf_ownership_share": 5003,
"sync_ownership_share": 5003
}
]
},
"collection": {
"validity_begin": "<string>",
"validity_end": "<string>",
"territories": [
{
"code": "<string>",
"mech_share": 5003,
"perf_share": 5003,
"sync_share": 5003
}
]
},
"lyrics": {
"duration": 123,
"lyrics": "<string>",
"lrc": "<string>"
}
}
}'
{
"message": {
"body": {
"alternate_titles": [
{
"title": "<string>"
}
],
"collections": {
"2023-07-17": {
"territories": [
{
"code": "<string>",
"countries": [
"<string>"
],
"mech_share": 123,
"perf_share": 123,
"publisher": "<any>",
"sync_share": 123
}
],
"validity_begin": "<string>",
"validity_end": "<any>"
}
},
"identifier": "<string>",
"is_disabled": 123,
"isrc": [
"<any>"
],
"iswc": "<string>",
"last_trasmission": "<string>",
"owners": {
"publisher": [
{
"controlled": "<string>",
"id": 123,
"identifier": "<string>",
"ipi": "<string>",
"mech_ownership_share": 123,
"mech_society": "<any>",
"name": "<string>",
"perf_ownership_share": 123,
"perf_society": "<any>",
"role": "<any>",
"sync_ownership_share": 123,
"sync_society": "<any>",
"type": "<string>",
"validity_begin": "<string>"
}
],
"writer": [
{
"controlled": "<string>",
"id": 123,
"identifier": "<string>",
"ipi": "<string>",
"mech_ownership_share": 123,
"mech_society": "<any>",
"name": "<string>",
"perf_ownership_share": 123,
"perf_society": "<any>",
"role": "<string>",
"sync_ownership_share": 123,
"sync_society": "<any>",
"type": "<string>",
"validity_begin": "<any>"
}
]
},
"ownership": [
"<any>"
],
"performers": [
"<any>"
],
"publisher_short_name": "<string>",
"source": {
"affiliation": "<any>",
"control": true,
"created": "<string>",
"credits_priority": "<string>",
"description": "<string>",
"id": 123,
"last_updated": "<string>",
"report": "<string>",
"sender_id": "<string>",
"sender_name": "<string>",
"short_name": "<string>",
"type_of_right": "<string>",
"validity_begin": "<string>",
"validity_end": "<any>"
},
"submissions": [
{
"creation_date": "<string>",
"disabled": "<string>",
"filename": "<string>",
"id": 123,
"source": 123,
"transmission_date": "<string>"
}
],
"tablespace": "<string>",
"title": "<string>",
"type_of_right": "<string>",
"validity_begin": "<any>",
"validity_end": "<string>",
"wgid": "<string>",
"work_id": 123
},
"header": {
"execute_time": 123,
"hint": "<string>",
"status_code": 123
}
}
}
The data schema for submitting data of a musical work.
Show child attributes
200 OK / 400 Bad Request / 401 Unauthorized
Show child attributes