Article

HTTP Status Codes

Reference error codes returned by the Apple Music API.

Overview

An error code indicates the type of error that occurred while a request was being executed. 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

Modification request was accepted but 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.

(For personal endpoints) Authorization issues may occur because the user wasn’t signed in or didn’t have a valid Apple Music subscription.

(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.

(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

The method can’t be used for the request.

409

Conflict

A modification or creation request couldn’t be processed 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

The URI of the request is too long and won’t be processed.

429

Too Many Requests

The user has made too many requests. See Simulate the Too Many Requests Error.

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.

See Also

Handling Errors

object Error

Information about an error that occurred while processing a request.