HTTP Status codes for Requests


What is the HTTP status code for invalid requests, failure or partial success ?
Is there a documentation on that?


My understanding is the only HTTP errors you should get are due to issues at the transport layer (e.g. a 500 because the servers handling your request are down).

All other errors (e.g. invalid request, parsing error, etc.) should be surfaced through the errors property of the JSON body of the response (see for details), which itself should come with a 200 OK (or related status indicating transport success).