<!--
{
  "documentType" : "article",
  "framework" : "AppleMusicAPI",
  "identifier" : "/documentation/AppleMusicAPI/http-status-codes",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "HTTP Status Codes"
}
-->

# HTTP Status Codes

Reference error codes returned by the Apple Music API.

## Discussion

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`](/documentation/AppleMusicAPI/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. ![](spacer) (For personal endpoints) Authorization issues may occur because the user wasn’t signed in or didn’t have a valid Apple Music subscription. ![](spacer) (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. ![](spacer) (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 <doc://com.apple.applemusicapi/documentation/AppleMusicAPI/generating-developer-tokens#Request-Rate-Limiting>.                                                                                                                                                                                                                                                                                                        |
|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.                                                                                                                                                                                                                                                                                                                                                                                                      |

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)