Partner Center REST error codes

Applies to:

  • Partner Center
  • Partner Center operated by 21Vianet
  • Partner Center for Microsoft Cloud Germany
  • Partner Center for Microsoft Cloud for US Government

The Partner Center REST APIs return a JSON object that contains a status code. This code that indicates whether your request was successful or why it failed.

Success responses

A 2xx status code indicates that the client's request was successfully received, understood, and accepted.

Error codes

The following 4xx and 5xx status codes indicate an error:

  • 400: Bad request
  • 401: Unauthorized
  • 403: Forbidden
  • 404: Not found
  • 405: Method not allowed
  • 406: Not acceptable
  • 409: Conflict, error code
  • 412: Precondition failed
  • 429: Too many requests
  • 500: Internal server error
  • 501: Not implemented
  • 502: Bad gateway
  • 503: Service unavailable
  • 504: Gateway timeout

Error responses

Any response with a 4xx or 5xx status code includes an error message with additional details about the error condition(s) encountered.

The following table and code sample describes the schema of an error response:

Name Type Description
code string Always returned. Indicates the kind of error that occurred. Non-null.
description string Always returned. Describes the error in detail, and provides additional debugging information. Non-null, non-empty. Maximum length is 1024 characters.
data array Only returned for some error types. A list of error objects.
source string Always returned. The source of the error.
  "code": <string>,
  "description": <string>,
  "data": [

  "source": <string>
## }
WWW-Authenticate: OAuth realm=urn:cpsvc:cpid:{some cid}