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 or job not finished
• 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