Techinnoverz logoTechinnoverzVERIFICATION
Open Panel
Browse documentation
Contact Verification APIs

Email Verification API

Check that an email address is valid and reachable, and optionally that it belongs to a named person or organisation.

What it verifies

Checks that an email address is real, active and reachable by testing its format, its domain and the mail server's own reply, and reports what is known about the domain. Send a person's name or an organisation's name as well and the answer says whether the address belongs to them. An address that does not pass is still a complete answer: the response says so and which check failed. An address that is not a valid email at all is rejected as invalid input.

Who uses it

  • Lenders and fintechs checking the email given at onboarding or on a loan application
  • Fraud and risk teams screening for fake, disposable or generic addresses
  • Platforms that want to confirm an address belongs to the person or company who gave it

Request and response

POSThttps://verification.techinnoverz.com/api/v1/contactability/email

Check that an email address is valid and reachable, and optionally who it belongs to. This call is billed when it returns a successful result.

Request body

emailstringrequired

The email address to check.

individualNamestringoptional

Optional. A person's name to compare with the name in the address.

establishmentNamestringoptional

Optional. An organisation's name to compare with the address's domain.

consentstringrequired

Must be "Y". Records that the end customer consented to this check; logged against the transaction.

referenceIdstringoptional

Your own id, echoed back in the response for reconciliation.

Example requests

curl -X POST "https://verification.techinnoverz.com/api/v1/contactability/email" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "asha.sample@example.com",
  "individualName": "Asha Sample",
  "establishmentName": "Sample Enterprise Solutions",
  "consent": "Y",
  "referenceId": "app_20915"
}'

200 response — status "found"

Response
{
  "status": "found",
  "data": {
    "email": "asha.sample@example.com",
    "isVerified": true,
    "isEmailValid": true,
    "isEstablishmentMatched": true,
    "isIndividualMatched": true,
    "establishmentMatches": [
      {
        "establishmentName": "SAMPLE ENTERPRISE SOLUTIONS PRIVATE LIMITED",
        "establishmentId": "PYKRP2460100000",
        "matchedDomain": "example.com",
        "source": "epfo",
        "matchedEmailId": "hr@example.com",
        "individuallyMatched": true,
        "score": 1
      }
    ],
    "nameInEmail": "asha.sample",
    "individualMatchScore": 1,
    "domain": {
      "name": "example.com",
      "ageInYears": 6,
      "createdAt": "2019-11-06 08:57:28+00:00",
      "updatedAt": "2025-10-18 09:14:20+00:00",
      "expiresAt": "2029-11-06 08:57:28+00:00",
      "isExpired": false
    },
    "isWebmail": false,
    "hasMxRecords": true,
    "isSmtpServerValid": true,
    "isSmtpEmailValid": true,
    "isGenericEmail": false
  },
  "source": "provider",
  "dataAsOf": "2026-11-03T09:30:00.000Z",
  "referenceId": "app_20915",
  "billing": {
    "charged": true,
    "walletBalance": "12450.00"
  },
  "txnId": "txn_8c31ba90",
  "livemode": true
}

Fields returned in data

emailstringoptional

The address that was checked.

isVerifiedbooleanoptional

Overall result: true when all the major checks passed (the address is valid and reachable, and any name or organisation you sent matched).

isEmailValidbooleanoptional

Whether the address exists and can receive mail (the domain's mail records and the mail server's own reply both agree).

isEstablishmentMatchedbooleanoptional

Whether the organisation you sent matches the address's domain. null when you sent no organisation.

isIndividualMatchedbooleanoptional

Whether the person you sent matches the name in the address. null when you sent no name.

establishmentMatchesarrayoptional

Organisations the domain is linked to in official records, each with establishmentName, establishmentId, matchedDomain, source, matchedEmailId, individuallyMatched and a score from 0 to 1. Empty when none were looked up.

nameInEmailstringoptional

The name part of the address, before the @.

individualMatchScorenumberoptional

How closely the person you sent matches the name in the address, 0 to 1. null when you sent no name.

domainobjectoptional

What is known about the address's domain: name, ageInYears, createdAt, updatedAt, expiresAt and isExpired.

isWebmailbooleanoptional

Whether the domain is a public webmail service such as Gmail or Outlook.

hasMxRecordsbooleanoptional

Whether the domain has mail (MX) records.

isSmtpServerValidbooleanoptional

Whether the domain's mail server could be reached.

isSmtpEmailValidbooleanoptional

Whether the mail server says the mailbox exists.

isGenericEmailbooleanoptional

Whether the address looks generic, such as info@, hr@ or support@.

Error codes

Errors return a non-200 HTTP status and the same envelope, so your retry logic and your reconciliation agree.

400 INVALID_INPUT

A field is missing or malformed. The details list each problem. Not charged.

401 INVALID_KEY

The key is missing, revoked, or not a key we issued.

402 WALLET_EMPTY

Your available balance is below the price of this call. Top up and retry. Not charged.

403 PRODUCTION_NOT_ENABLED

A live key was used before live access was enabled for your account. Use a test key, or ask us to enable live access.

403 TEST_NOT_ENABLED

A test key was used before test (UAT) access was enabled for your account. Ask us to enable it.

403 API_NOT_ENABLED

This check is switched off for your account, or is not available for live use yet.

403 IP_NOT_ALLOWED

The key is restricted to certain IP addresses and this call came from another.

403 ACCOUNT_SUSPENDED

The account is suspended. Contact support.

404 NO_DATA

A valid request, but no record was found. Not charged.

404 ROUTE_NOT_FOUND

There is no endpoint at that path.

405 METHOD_NOT_ALLOWED

Use the method shown in the Allow header.

409 IDEMPOTENCY_IN_PROGRESS

A call with the same Idempotency-Key is still being processed. Retry after the delay in Retry-After.

413 PAYLOAD_TOO_LARGE

The request body is too large. Not charged.

415 UNSUPPORTED_MEDIA_TYPE

Send the request with Content-Type: application/json.

422 IDEMPOTENCY_KEY_REUSED

This Idempotency-Key was already used with a different request body. Use a new key for a new request.

429 RATE_LIMITED

Too many requests or too many at once. Wait for the Retry-After delay.

500 INTERNAL_ERROR

Something went wrong on our side. Not charged. Quote the txnId if you contact support.

502 SOURCE_ERROR

The data source returned an error. Not charged.

503 SOURCE_DOWN

The data source is unavailable right now. Not charged. Retry after the delay in Retry-After.

504 SOURCE_TIMEOUT

The data source did not answer in time. Not charged.

Error response
{
  "status": "error",
  "error": {
    "code": "NO_DATA",
    "message": "No record found for the given input. Not charged."
  },
  "billing": {
    "charged": false
  },
  "txnId": "txn_8c31ba91",
  "livemode": true
}

Billing

You are charged only on successful hits. Failed, no-data and error calls are free.

Every response carries billing.charged and your remaining billing.walletBalance. Per-hit pricing is set on your rate card; book a demo to get yours.

All API documentation · OpenAPI specification · Docs as plain text