Status Codes

An example API guitar catalog website

Category Description
Informational, 1xx Informational status codes are interim codes that precede regular status codes and offer additional information.
Success, 2xx Success status codes indicate that your request was successfully received, understood, and accepted.
Redirection, 3xx Redirection status codes indicate that further action is required by you before your request is fulfilled.
Client Error, 4xx Client error status codes indicate you may have made an error. The status code indicates if the error is permanent or temporary.
Server Error, 5xx Server error codes indicate the server is aware that it has erred or is incapable of performing the request. The status code indicates if the error is permanent or temporary.

Status and Error Code Examples

You may encounter some of the status or error codes described below when making an API request to Groovy Guitars. Examples of messages are shown.

Status Code Description
100 Continue: Continue with your request. This interim response informs you that the initial part of your request was received. Your request is neither accepted or rejected at this stage.
Example: Continue
200 OK: Your request was successfully received, understood, and accepted. Information returned depends on the type of API request made.
Example: Successful operation
201 Created: Your request was fulfilled and a new resource was created as a result.
Example: Successful creation (via POST or PUT operation)
204 No Content: The server fulfilled your request but did not return content. Metainformation might be returned in the form of entity-headers, which if present should be associated with the requested variant.
Example: no content
304 Not Modified: You must take further action before your request is fulfilled. The server did not detect any modifications in your request.
Example: Further action required
400 Bad Request: The server did not understand your request’s syntax. Modify your request and try again.
Example: Invalid ID supplied
401 Unauthorized: Your request requires user authentication, including a WWW-Authenticate header.
Example: Invalid authentication token
403 Forbidden: You are not authorized to perform the request.
Example: You are not authorized to perform the operation
404 Not Found: The server did not find any information matching your request. You may try your request again at a later time.
Example: Guitar not found
405 Method Not Allowed: Your request contained a resource using a request method not supported by that resource.
Example: Validation exception
500 Internal Server Error: The server cannot fulfill your request due to an unexpected internal error. You may try your request again at a later time.
Example: Internal server error
503 Service Unavailable: The server cannot fulfill your request because it is temporarily overloaded or down for maintenance. You may try your request again at a later time.
Example: Server unavailable