Error Codes

The TenantVerify API uses standard HTTP status codes and returns structured error responses.

HTTP Status Codes

StatusErrorDescription
400Validation failedInvalid request parameters
401Invalid API keyAPI key is missing, invalid, or revoked
403API access requires Pro or Business planUpgrade your plan to access the API
403Verification limit reachedYou've used all verifications for this period
404Verification not foundThe verification ID doesn't exist
429Rate limit exceededToo many requests, wait before retrying
500Internal server errorSomething went wrong on our end

Error Response Format

All error responses follow a consistent JSON structure with an error message and optional details array for validation errors.

{
  "error": "Validation failed",
  "details": [
    {
      "code": "invalid_type",
      "path": ["tenant_email"],
      "message": "Invalid tenant email"
    }
  ]
}

Handling Errors

  • Always check the HTTP status code before parsing the response body
  • For 429 errors, wait and retry using exponential backoff
  • For 500 errors, retry the request after a short delay
  • For 400 errors, check the details array for specific field-level issues
  • For 401 errors, verify your API key is correct and not revoked
← WebhooksRate Limits →