When you use our API, you will get various HTTP response codes. Here you will find the standard HTTP responses and their descriptions. If you receive a response that is not on this list, it is a non-standard response and you should contact customer care for more information. The most frequently encountered response codes will be listed under the Client-Error Responses.
These responses mean that the request was received and the server is continuing to process the request.
HTTP Status Code
Description
100
Continue
This response indicates the client should continue the request.
101
Switching Protocol
The client has asked the server to switch protocols and the server has agreed to do so.
103
Early Hints
This status code is used to return some response headers before the final HTTP message.
These responses mean that the request was successfully received, understood, and accepted.
HTTP Status Code
Description
200
OK
The request succeeded.
201
Created
The request succeeded and a new resource was created as a result.
202
Accepted
The request has been received but the processing has not been completed.
203
Non-Authoritative Information
This response code means the returned metadata is not the same as is available from the original server but is collected from a local or third-party copy.
204
No Content
There is no content to send for this request, but the request succeeded.
205
Reset Content
This tells the user to reset the document which sent this request.
206
Partial Content
This response code is used when the client requests only part of the resource.
These responses mean that further action needs to be taken in order to complete the request.
HTTP Status Code
Description
300
Multiple Choice
This request has more than one possible request. The user should pick one of them. (There is no standardized way to choose one of the responses.) For example, this could be used to present multiple video format options.
301
Moved Permanently
The URL of the requested resource has been changed permanently.
302
Found
This response code means that the URL of the requested resource has been changed temporarily.
303
See Other
The server sent this response to direct the client to get the requested resource at another URI with a GET request.
304
Not Modified
This is used for caching purposes. It tells the client that the response has not been modified.
305
Use Proxy
This response indicates that a requested response must be accessed by a proxy.
307
Temporary Redirect
The server sends this response to direct the client to get the requested resource at another URI.
308
Permanent Redirect
This means that the resource is now permanently located at another URI, specified by the Location: HTTP Response header.
These responses mean that the request contains bad syntax or the request cannot be fulfilled. These are the most frequently occurring responses.
HTTP Status Code
Description
400
Bad Request
The server could not understand the request due to an apparent client error. (For example: invalid syntax, size too large, invalid request message framing.)
401
Unauthorized
The client must authenticate itself to get the requested response.
403
Forbidden
The client does not have access rights to the content.
404
Not Found
The server cannot find the requested resource.
405
Method Not Allowed
The request method is known by the server, but it is not supported by the target resource.
406
Not Acceptable
This response is sent when the web server doesn't find any content that conforms to the criteria given by the user.
407
Proxy Authentication Required
This is like the 401 Unauthorized status code but authentication is needed to be done by a proxy.
408
Request Timeout
The server has timed out waiting for the request.
409
Conflict
This response is sent when a request conflicts with the current state of the server.
410
Gone
This response indicates that the resource requested is no longer available and will not be available again.
411
Length Required
The request did not specify the length of its content, which is required by the requested resource.
412
Precondition Failed
The client has indicated preconditions in its headers which the server does not meet.
413
Payload Too Large
The request is larger than the server is willing or able to process.
414
URI Too Long
The URI requested by the client is longer than the server is willing to interpret.
415
Unsupported Media Type
The media format of the requested data is not supported by the server.
416
Range Not Satifisable
The client has asked for a portion of the file, but the server cannot supply that portion.
417
Expectation Failed
The server cannot meet the requirements of the Expect request header field.
421
Misdirected Request
This request was directed at a server that is not able to produce a response.
422
Unprocessable Entry
The request was well-formed but was unable to be followed due to semantic errors.
423
Locked
The resource that is being accessed is locked.
424
Failed Dependency
The request failed due to failure of a previous request.
425
Too Early
This response indicates that the server is unwilling to risk processing a request that might be displayed.
426
Upgrade Required
The server refuses to perform the request using the current protocol but might be willing to do so after the client upgrades to a different protocol.
428
Precondition Required
The origin server requires the request to be conditional.
429
Too Many Requests
The user has sent too many requests in the given amount of time ("rate limiting").
431
Request Header Fields Too Large
The server is unwilling to process the request because its header fields are too large.
451
Unavailable for Legal Reasons
The user requested a resource that cannot be legally provided, such as a web page censored by a government.
These responses mean that the server failed to fulfill a request.
HTTP Status Code
Description
500
Internal Server Error
The server has encountered a situation it does not know how to handle.
501
Not Implemented
The request method is not supported by the server and cannot be handled.
502
Bad Gateway
This error response means that the server, while working as a gateway to get a response needed to handle the request, got an invalid request.
503
Service Unavailable
The server is not ready to handle the request. This is usually a temporary state.
504
Gateway Timeout
This error response is given when the server is acting as a gateway and cannot get a response in time.
505
HTTP Version Not Supported
The HTTP version used in the request is not supported by the server.
506
Variant Also Negotiaties
The server has an internal configuration error.
507
Insufficient Storage
The method could not be performed on the resource because the server is unable to store the representation needed to successfully complete the request.
508
Loop Detected
The server detected an infinite loop while processing the request.
510
Not Extended
Further extensions to the request are required for the server to fulfill it.
511
Network Authentication Required
This response indicates that the client needs authentication to gain network access.
Powered by Azure API Management.