Documentation
Errors & Status Codes

Errors and status codes

You can tell if your request was successful by checking the status code when receiving an API response. If a response comes back unsuccessful, you can use the error type and error message to figure out what has gone wrong and do some rudimentary debugging.

Categories

Here is a list of the different categories of status codes returned by SheetDB. Use these to understand if a request was successful.

  • 2xx A 2xx status code indicates a successful response.
  • 4xx A 4xx status code indicates a client error — this means it's a problem with the request.
  • 5xx A 5xx status code indicates a server error — we will closely monitor them but please feel free to write to us at [email protected].

Status codes

200 OK The request has succeeded.

400 Bad Request The API could not understand the request.

401 Unauthorized An error with Google account authentication or you have entered an incorrect Barer token / Basic Auth credentials.

402 Payment Required Payment is required to process the request. Occurs when you try to make a request that requires a higher plan.

403 Forbidden Permissions are missing.

404 Not Found The server did not find anything matching the request.

429 Too Many Requests You have exceeded the request limit.

500 Internal Server Error We had a problem. Try again later.

1015 Rate Limit Too many request from the same IP address. The limit is 10 requests per 10 seconds.