Error responses

Use this page to identify API error codes, understand the error response format, and handle batch request failures.

Error response format

When a request fails, the API returns a response with status set to error and an error object that contains the code and message.

JSON example

{
  "status": "error",
  "version": "1.2",
  "error": {
    "code": "1001",
    "message": "Missing ArtistId"
  }
}

XML example

<response status="error" version="1.2">
  <error code="1001">
    <errorMessage>Missing artist ID</errorMessage>
  </error>
</response>

Handle errors

1. Check the HTTP status code.
2. Check the status field in the response body.
3. Read error.code to identify the failure type.
4. Read error.message for the human-readable error.
5. If error.code is 1008, inspect error.errors to review each failed item in a batch request.

If you want to reproduce a request and inspect the full response more easily, use the Postman sample requests guide.

If you want to reproduce a request and inspect the full response more easily, use the Postman sample requests guide.

If you want to reproduce a request and inspect the full response more easily, use the Postman sample requests guide.

If you want to reproduce a request and inspect the full response more easily, use the Postman sample requests guide.

Batch request errors (1008)

If the API returns error code 1008, the response includes an errors array with one entry for each failed item in the batch.

• code — the error code for the specific item
• message — the human-readable error for the specific item
• index — the zero-based position of the failed item in the batch

{
  "error": {
    "code": 1008,
    "message": "One or more errors has occurred.",
    "errors": [
      {
        "code": 1001,
        "message": "Missing TrackID",
        "index": 2
      }
    ]
  }
}

Error code categories

1xxx — Invalid or missing input parameters

2xxx — Invalid resource reference

3xxx — User restrictions

4xx — Authentication errors

7xxx — MassiveMusic API application errors

9xxx — Internal server errors