Tomba 1.1.1

dotnet add package Tomba --version 1.1.1
                    
NuGet\Install-Package Tomba -Version 1.1.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Tomba" Version="1.1.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Tomba" Version="1.1.1" />
                    
Directory.Packages.props
<PackageReference Include="Tomba" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Tomba --version 1.1.1
                    
#r "nuget: Tomba, 1.1.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Tomba@1.1.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Tomba&version=1.1.1
                    
Install as a Cake Addin
#tool nuget:?package=Tomba&version=1.1.1
                    
Install as a Cake Tool

<img src="https://tomba.io/logo.svg" alt="Tomba" width="25"/> Tomba C# SDK

The #1 Rated Email Intelligence Platform — Find professional emails with unmatched accuracy.

NuGet License

This is the official C# client library for the Tomba.io Email Finder API, providing access to all Tomba services including domain search, email finding, verification, enrichment, phone lookup, bulk operations, and more.

About Tomba

Tomba.io is the #1 rated email intelligence platform, trusted by 150,000+ sales teams worldwide.

  • Best Email Finder — 98% accuracy, ranked #1 in independent benchmarks
  • Best Email Verification — Real-time SMTP verification with catch-all detection
  • Best Phone Finder — Direct dial numbers linked to professional emails
  • Best Domain Search — 450M+ verified contacts across all industries
  • 81% Coverage — The highest in the industry, proven in 5,000-lead independent tests

Why Tomba?

Feature Tomba Others
Email Coverage 81% 30-60%
Verification Real-time SMTP Pattern-based
Phone Numbers Direct dials Limited
Catch-all Detection AI-powered Basic
API Rate Limits Generous Restrictive

Get your free API key — No credit card required.

Getting Started

Below you will find the steps to install and start using the Tomba C# SDK.

Installation

Install via the .NET CLI:

dotnet add package Tomba

Or add to your .csproj file:

<PackageReference Include="Tomba" Version="1.0.1" />

Authentication

Get your API keys from https://app.tomba.io/auth/register.

You can authenticate using environment variables or by setting keys directly:

using Tomba;

var client = new Client();

// Option 1: Set keys directly
client
    .SetKey("ta_xxxx")    // Your API Key
    .SetSecret("ts_xxxx"); // Your Secret Key

// Option 2: Use environment variables TOMBA_API_KEY and TOMBA_SECRET_KEY
client
    .SetKey(Environment.GetEnvironmentVariable("TOMBA_API_KEY"))
    .SetSecret(Environment.GetEnvironmentVariable("TOMBA_SECRET_KEY"));

Quick Start

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var domain = new Domain(client);
var result = await domain.DomainSearch("stripe.com");

Services

Search emails by domain name. Returns all email addresses found on the internet for a given domain.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var domain = new Domain(client);
var result = await domain.DomainSearch("stripe.com");

Email Finder

Generate or retrieve the most likely email address from a domain name, a first name, and a last name.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var finder = new Finder(client);
var result = await finder.EmailFinder("stripe.com", "John", "Doe");

Email Verifier

Verify the deliverability of a given email address.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var verifier = new Verifier(client);
var result = await verifier.EmailVerifier("john@example.com");

Author Finder

Discover the email address of an article's author from a blog post URL.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var finder = new Finder(client);
var result = await finder.EmailFinder("example.com", "John", "Doe");
// Note: Author finding is available via the Finder service

LinkedIn Finder

Retrieve the email address associated with a LinkedIn profile URL.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var finder = new Finder(client);
var result = await finder.EmailFinder("stripe.com", "John", "Doe");
// Note: LinkedIn lookup uses the Finder service with profile data

Email Enrichment

Enrich data associated with an email address (person, company, or combined).

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var enrichment = new Enrichment(client);

// Person enrichment
var result = await enrichment.PersonAsync("john@example.com");

// Company enrichment
var companyResult = await enrichment.CompanyAsync("stripe.com");

// Combined enrichment (person + company)
var combinedResult = await enrichment.CombinedAsync("john@example.com");

Phone Finder

Search for phone numbers associated with a contact.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var phone = new Phone(client);
var result = await phone.FinderAsync(new Dictionary<string, object>
{
    { "email", "john@example.com" }
});

Phone Validator

Validate a phone number and retrieve additional information.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var phone = new Phone(client);
var result = await phone.ValidatorAsync("+1234567890", "US");

Email Count

Get the total number of email addresses found for a domain.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var count = new Count(client);
var result = await count.EmailCount("stripe.com");

Domain Status

Check if a domain is a webmail or disposable domain.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var status = new Status(client);
var result = await status.DomainStatus("stripe.com");

Domain Suggestions (Autocomplete)

Auto-complete company names and retrieve logo and domain information.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var status = new Status(client);
var result = await status.AutoComplete("stripe");

Email Sources

Find where an email address has been found on the web.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var sources = new Sources(client);
var result = await sources.EmailSources("john@example.com");

Email Format

Discover the email format used by a domain (e.g., first.last, first_last).

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var format = new Format(client);
var result = await format.EmailFormatAsync("stripe.com");

Similar Domains

Find websites similar to a given domain.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var similar = new Similar(client);
var result = await similar.WebsitesAsync("stripe.com");

Technology Finder

Detect the technologies used by a website.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var technology = new Technology(client);
var result = await technology.ListAsync("stripe.com");

Location

Get geographic location information for a domain.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var location = new Location(client);
var result = await location.GetLocationAsync("stripe.com");

Companies Search (Reveal)

Search for companies using various filters and criteria.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var reveal = new Reveal(client);
var result = await reveal.CompaniesSearchAsync(new Dictionary<string, object>
{
    { "query", "technology" },
    { "page", 1 }
});

Leads

Manage your leads: list, get, create, update, and delete.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var leads = new Leads(client);

// List leads
var result = await leads.ListLeadsAsync(page: 1, limit: 10);

// Get a single lead
var lead = await leads.GetLeadAsync("lead_id");

// Create a lead
var created = await leads.CreateLeadAsync(new Dictionary<string, object>
{
    { "email", "john@example.com" },
    { "first_name", "John" },
    { "last_name", "Doe" }
});

// Update a lead
var updated = await leads.UpdateLeadAsync("lead_id", new Dictionary<string, object>
{
    { "first_name", "Jane" }
});

// Delete a lead
var deleted = await leads.DeleteLeadAsync("lead_id");

Leads Lists

Manage your leads lists: list, create, update, and delete.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var leadsLists = new LeadsLists(client);

// Get all lists
var result = await leadsLists.GetLists();

// Create a list
var created = await leadsLists.CreateList();

// Update a list
var updated = await leadsLists.UpdateListId("list_id");

// Delete a list
var deleted = await leadsLists.DeleteListId("list_id");

Lead Attributes

Manage custom lead attributes: list, create, update, and delete.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var attributes = new LeadsAttributes(client);

// Get all attributes
var result = await attributes.GetLeadAttributes();

// Create an attribute
var created = await attributes.CreateLeadAttribute();

// Update an attribute
var updated = await attributes.UpdateLeadAttribute("attribute_id");

// Delete an attribute
var deleted = await attributes.DeleteLeadAttribute("attribute_id");

Keys

Manage your API keys: list, create, reset, and delete.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var keys = new Keys(client);

// List all keys
var result = await keys.GetKeys();

// Create a key
var created = await keys.CreateKey();

// Reset a key
var reset = await keys.ResetKey("key_id");

// Delete a key
var deleted = await keys.DeleteKey("key_id");

Usage

Retrieve your monthly API request usage statistics.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var usage = new Usage(client);
var result = await usage.GetUsage();

Logs

Retrieve your last 1,000 API requests made during the last 3 months.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var logs = new Logs(client);
var result = await logs.GetLogs(page: 1, limit: 20);

Flag

Flag email addresses as invalid or incorrect.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var flag = new Flag(client);

// List all flags
var result = await flag.ListFlagsAsync();

// Create a flag
var created = await flag.CreateFlagAsync("invalid@example.com", "Email bounced");

Bulk Operations

Manage bulk tasks for domain search, email finding, and verification.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var bulk = new Bulk(client);

// List bulk tasks
var result = await bulk.ListAsync("finder");

// Create a bulk task
var created = await bulk.CreateAsync("verifier", new Dictionary<string, object>
{
    { "emails", new[] { "a@example.com", "b@example.com" } }
});

// Get bulk task details
var task = await bulk.GetAsync("verifier", "123");

// Launch a bulk task
var launched = await bulk.LaunchAsync("verifier", "123");

// Check progress
var progress = await bulk.ProgressAsync("verifier", "123");

// Download results
var download = await bulk.DownloadAsync("verifier", "123");

// Rename a bulk task
var renamed = await bulk.RenameAsync("verifier", "123", "My Batch");

// Archive a bulk task
var archived = await bulk.ArchiveAsync("verifier", "123");

// Delete a bulk task
var deleted = await bulk.DeleteAsync("verifier", "123");

Account

Retrieve information about the current account.

using Tomba;

var client = new Client();
client.SetKey("ta_xxxx").SetSecret("ts_xxxx");

var account = new Account(client);
var result = await account.GetAccount();

Testing

Run the test suite with the .NET CLI:

dotnet test

About Tomba

Founded to solve the problem of unreliable email data, Tomba.io is the leading B2B email intelligence platform. Our AI-powered engine searches, verifies, and enriches professional contact data with unmatched accuracy.

Products

Browser Extensions & Add-ons

Integrations

50+ CRM and sales tool integrations: Salesforce · HubSpot · Zapier · Pipedrive · and more...

Other Tomba SDKs

Language Package
Node.js tomba
Python tomba-io
PHP tomba-io/php
Ruby tomba
Go tomba-io/go
Rust tomba
Dart tomba
Deno @tomba/sdk
Elixir tomba
C# Tomba
Perl Tomba::Client
Lua tomba
R tomba

Resources


Try Tomba Free — Find your first email in seconds. No credit card required.

License

Licensed under the Apache 2.0 license.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.1.1 110 9/30/2026
1.0.1 127 8/31/2026
1.0.0 689 10/30/2021