HTTP Status Codes

Created by Danny Chu, Modified on Tue, 26 Jul, 2022 at 2:39 PM by Danny Chu

Sheet.Best provides a RESTful API that indicates the success or failure of the API request using HTTP response codes.

Codes in the 4xx range indicate an error that failed given the information provided.

Codes in the 5xx range indicate an error with sheet.best's server (these are rare).

Status Codes	Description
200 - OK	Everything worked as expected.
400 - Bad Request	The request was unacceptable, often due to missing a required parameter or permission to the spreadsheet.
401 - Authentication Failed	Incorrect authentication credentials
402 - Payment Required	This operation is not allowed in your current plan.
403 - Forbidden	You do not have permission to perform this action.
404 - Not Found	The requested resource doesn't exist.
405 - Method Not Allowed	When calling an endpoint using a not registered method. Ex: POST for the search endpoint
402 - Payment required	You already used all of your plan's requests this month.
500, 502, 503, 504 - Server Errors	Something went wrong on Sheet.Best's end, we will fix it.

Some errors will also come with a textual error codes, in this case, you can check them in the table below:

Error Codes	Description
throttle	You already used all of your plan's requests this month.
write_error	sheet.best could not update your sheet, you should verify its permissions.
authentication_failed	You passed incorrect authentication credentials.
not_authenticated	You did not pass the authentication credentials.
permission_denied	You do not have permission to perform this actions.