HTTP Status Codes
Reference error codes returned by the Apple Music API.
Overview
An error code indicates the type of error that occurred while executing a request. These are the possible values for the status member in an Error object:
Code | Name | Description |
|---|---|---|
200 | OK | The request was successful; no errors or faults. |
201 | Created | Creation request was successful. |
202 | Accepted | Although the modification request was acceptable, it may not have completed. |
204 | No Content | Modification was successful, but there’s no content in the response. |
301 | Moved Permanently | Content may be available at a different URL. |
302 | Found | Content definitely available at a specific URL. |
400 | Bad Request | The request wasn’t accepted as formed. |
401 | Unauthorized | The request wasn’t accepted because its authorization is missing or invalid due to an issue with the developer token. [Image] (For personal endpoints) Authorization issues may occur because the user wasn’t signed in or didn’t have a valid Apple Music subscription. [Image] (For music user token request) Developer token issues may occur because the token wasn’t received or was invalid. There could also be an error processing the request. |
403 | Forbidden | The request wasn’t accepted due to an issue with the music user token or because it’s using incorrect authentication. [Image] (For personal endpoints) Authentication issues may occur if the account hasn’t accepted the Media and Apple Music privacy setting. |
404 | Not Found | The requested resource doesn’t exist. |
405 | Method Not Allowed | Can’t use specified method for the request. |
409 | Conflict | Couldn’t process modification or creation request because there’s a conflict with the current state of the resource. |
413 | Payload Too Large | The body of the request is too large. |
414 | URI Too Long | Won’t process the request because the URI is too long. |
429 | Too Many Requests | The user has made too many requests. See Generating Developer Tokens. |
500 | Internal Server Error | There’s an error processing the request. |
501 | Not Implemeneted | Endpoint is currently unavailable and reserved for future use. |
503 | Service Unavailable | The service is currently unavailable to process requests. |