Response Codes

The API makes use of standard HTTP response codes to indicate the success or failure of a request. The 2xx series of response codes indicate success, 4xx indicates an error from the client-side, and a 5xx error indicates a server-side error. Here are the HTTP response codes the mailfloss API utilizes:

  • 200 - Success
  • 400 - Email address or Id not supplied
  • 401 - Invalid API key
  • 402 - Insufficient credits
  • 403 - No API key provided
  • 404 - Job not found
  • 413 - Payload too large. Too many email addresses
  • 415 - Invalid Content Type. Must be application/json
  • 429 - Rate limit exceeded

  • 500 - Timeout
  • 503 - Failed to create job