Status codes

Bloc uses standard REST status codes to indicate success or failed requests on our API.

In general, codes like 2xx indicate success; 4xx means an error based on the information provided (e.g. wrong API keys or missing customer credentials); 5xx indicates an error with our servers (and these are very rare).

Let’s clarify them further.

Status CodeMeaning
200, 201, 202Everything is alright.
400Bad Request. check your request body to ensure all required data is passed.
401Unauthorized. Ensure you are passing the correct API keys.
404Not found. The resource you are looking for does not exist.
403Not enough permission to perform this operation
429Too many requests are being sent in a short period of time.
500, 502, 503, 504Definitely our fault. Rarely happens.