Overview

Error Handling

Whenever an API call is not successful, we will return the following response codes:

401 Invalid API key
429 : Rate limit exceeded
400 : Other error
404 : Invalid request

{
  "errors": {
    "type": "unknown_route",
    "message": "Invalid request, please make sure you follow the documentation for proper syntax",
    "code": 404
  }
}

json

Error Codes

Tomba API uses the following error codes:

Error Code	Meaning
400	Bad Request – Your request is invalid.
401	Unauthorized – Your API key is wrong.
402	The Email Verification failed due to an unexpected response from the remote SMTP server. This failure is outside our control; we advise you to retry later.
403	Forbidden – The resource requested is hidden for administrators only.
404	Not Found – The specified resource could not be found.
405	Method Not Allowed – You tried to access a resource with an invalid method.
406	Not Acceptable – You requested a format that isn’t JSON.
410	Gone – The resource requested has been removed from our servers.
418	I’m a teapot.
429	Too Many Requests – You're requesting too many resources! Slow down!
500	Internal Server Error – We encountered a problem with our server. Try again later.
503	Service Unavailable – We’re temporarily offline for maintenance. Please try again later.

API Key and Authentication Usage Limits and Quotas

​Error Codes

Error Codes