Would you like to check the status of a file you submitted for email validation via the ZeroBounce API? You can do that at any time – please see our instructions below.

The filestatus API returns the file processing status for the file that has been submitted using the sendfile API. Please refer to the C# example for details.



URL Parameters

  • Parameter
  • api_key
    Your API Key, found in your account.
  • file_id
    The returned file ID when calling sendfile API.

If you want to call the API from your browser to test it, all you have to do is to replace the API KEY with your unique API key and the FILE ID with the returned file ID from sendfile API:[replacewithyours]&file_id=[replacewithyours]


Below you can find samples of both successful and error responses.


Successful Response

    "success": true,
    "file_id": "aaaaaaaa-zzzz-xxxx-yyyy-5003727fffff",
    "file_name": "Your file name.csv",
    "upload_date": "2023-04-28T15:25:41Z",
    "file_status": "Complete",
    "complete_percentage": "100%",
    "return_url": "Your return URL if provided when calling sendfile API"
Error Response

    "success": false,
    "message": "Error messages"

Using the email validation API is an effective way to prevent erroneous and poor-quality data from entering your email lists. You can use the API in either bulk or real time. For each email address it verifies, the API consumes one credit from your ZeroBounce account. If you use the API on a consistent basis, please make sure your account is replenished periodically with credits.

Need help determining the status of your email validation API files? Please reach out to our Customer Support team. We are available around the clock to answer any questions and assist you.