Specified below is a list of HTTP Status codes an API implementer can expect to encounter when using the Public API.

Anchor
_Toc367189071 _Toc367189071

200 "OK"

Conditions for use:

1. The request was successful.
   1. Example: [GET] /api/v1/car/1
   2. Example: [PUT] /api/v1/car/1?name=Mazda323
   3. Example: [DELETE] /api/v1car/1 "Delete with a response"

Anchor
_Toc367189072 _Toc367189072

201 "Created"

Conditions for use:

1. The request to create was successful.
   1. Example [POST] /api/v1/car/?name=Mazda2

Anchor
_Toc367189073 _Toc367189073

204 "No Content"

Conditions for use:

1. The request to delete was successful and no further response will be return by server.
   1. Example: [DELETE] /api/v1/car/1 "Delete no response" This http status has been deprecated in favour of returning 404 if the identifier not longer exists.

Anchor
_Toc367189074 _Toc367189074

404 "Not found"

Conditions for use:

1. The resource does not exist. Example: /api/v1/doesNotExists
2. The member does not exist. Example: /api/v1/car/999999
3. A delete request of a resource that no longer exists: Example DELTE /api/v1/car/1

Anchor
_Toc367189075 _Toc367189075

403 "Forbidden"

Conditions for use:

1. The request is not authorised to use the method.

Anchor
_Toc367189076 _Toc367189076

400 "Bad Request"

Conditions for use:

1. The request did not pass input validation.

Anchor
_Toc367189077 _Toc367189077

418 "I'm a teapot (RFC 2324)"

Conditions for use:

1. IE Point 6 or IE Point 7 is used to make the request.
   

...

...

429 "Too Many Requests"

Conditions for use: 

1. The request has exceeded the allowed limits of requests for a given time period.

Anchor
_Toc367189078 _Toc367189078

500 "Internal Server Error"

Conditions for use:

1. The request experienced an internal server error.

Anchor
_Toc367189079 _Toc367189079

503 "Service Unviable"

Conditions for use:

1. The server is not currently accepting requests.