Skip to content
Zero Bounce C Sharp SDK Setup
C#
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
ZeroBounceSDK
ZeroBounceSample
.gitignore
README.md
ZeroBounceCSharpSDKSetup.sln

README.md

Zero Bounce C# SDK

This SDK contains methods for interacting easily with ZeroBounce API. More information about ZeroBounce you can find in the official documentation.

INSTALLATION

You can install by searching for ZeroBounceSDK in NuGet package manager browser or just use the this command:

Install-Package ZeroBounceSDK

USAGE

Import the sdk in your file:

using ZeroBounceSDK;

Initialize the sdk with your api key:

ZeroBounce.Instance.Initialize("<YOUR_API_KEY>");

Examples

Then you can use any of the SDK methods, for example:

  • Validate an email address
var email = "<EMAIL_ADDRESS>"   // The email address you want to validate
var ipAddress = "127.0.0.1"     // The IP Address the email signed up from (Optional)

ZeroBounce.Instance.Validate(email, ipAddress,
    response =>
    {
        Debug.WriteLine("Validate success response " + response);
        // ... your implementation
    },
    error =>
    {
        Debug.WriteLine("Validate failure error " + error);
        // ... your implementation
    });
  • Check how many credits you have left on your account
ZeroBounce.Instance.GetCredits(
    response =>
    {
        Debug.WriteLine("GetCredits success response " + response);
        // your implementation
    },
    error =>
    {
        Debug.WriteLine("GetCredits failure error " + error);
        // your implementation
    });
  • Check your API usage for a given period of time
var startDate = new DateTime();    // The start date of when you want to view API usage
var endDate = new DateTime();      // The end date of when you want to view API usage

ZeroBounce.Instance.GetApiUsage(startDate, endDate,
    response =>
    {
        Debug.WriteLine("GetApiUsage success response " + response);
        // ... your implementation
    },
    error =>
    {
        Debug.WriteLine("GetApiUsage failure error " + error);
        // ... your implementation
    });
  • The sendfile API allows user to send a file for bulk email validation
var filePath = File("<FILE_PATH>"); // The csv or txt file
var emailAddressColumn = 3;         // The index of "email" column in the file. Index starts at 1
var options = new SendFileOptions();

options.ReturnUrl = "https://domain.com/called/after/processing/request";
options.FirstNameColumn = 4;            // The index of "first name" column in the file
options.LastNameColumn = 5;             // The index of "last name" column in the file
options.GenderColumn = 6;               // The index of "gender" column in the file
options.IpAddressColumn = 7;            // The index of "IP address" column in the file
options.HasHeaderRow = true;            // If this is `true` the first row is considered as table headers

ZeroBounce.Instance.SendFile(
    filePath,
    emailAddressColumn,
    options,
    response =>
    {
        Debug.WriteLine("SendFile success response " + response);
        // ... your implementation
    },
    error =>
    {
        Debug.WriteLine("SendFile failure error " + error);
        // ... your implementation
    });
  • The getfile API allows users to get the validation results file for the file been submitted using sendfile API
var fileId = "<FILE_ID>";                       // The returned file ID when calling sendfile API
var localDownloadPath = "<FILE_DOWNLOAD_PATH>"; // The location where the downloaded file will be saved

ZeroBounce.Instance.GetFile(fileId, localDownloadPath,
    response =>
    {
        Debug.WriteLine("GetFile success response " + response);
        // ... your implementation
    },
    error =>
    {
        Debug.WriteLine("GetFile failure error " + error);
        // ... your implementation
    });
  • Check the status of a file uploaded via "sendFile" method
var fileId = "<FILE_ID>";                       // The returned file ID when calling sendfile API

ZeroBounce.Instance.FileStatus(fileId,
    response =>
    {
        Debug.WriteLine("FileStatus success response " + response);
        // ... your implementation
    },
    error =>
    {
        Debug.WriteLine("FileStatus failure error " + error);
        // ... your implementation
    });
  • Deletes the file that was submitted using scoring sendfile API. File can be deleted only when its status is Complete
var fileId = "<FILE_ID>";                       // The returned file ID when calling sendfile API

ZeroBounce.Instance.DeleteFile(fileId,
    response =>
    {
        Debug.WriteLine("DeleteFile success response " + response);
        // ... your implementation
    },
    error =>
    {
        Debug.WriteLine("DeleteFile failure error " + error);
        // ... your implementation
    });
You can’t perform that action at this time.