Advanced email verification, enrichment, and score

Fido's API endpoints are quite flexible and you can request a range of services from a single endpoint

One of the possible use cases is Fido Email

What is Fido Email?

Request

following an example of a Fido Email

curl --request POST \
     --url https://api.fido.id/1.0/email \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'x-api-key: [your_app_key]' \
     --data '
{
     "customer_id": "c426ad68-8987-11ec-a8a3-0242ac120002",
     "webhook_url": "https://...",
     "claims": [
          "email"
     ],
     "email": "[email protected]",
}'

Response

Following an example of the response:

{
  "resolution_id": "...",
  "customer_id":"...",  
  "device_request_time":"...",  
  "webhook_url": "...",
  "claims": [
    "email", 
  ],  
  "email": {
    "value" : "[email protected]",
    "status": "deliverable",
    "is_free": true,
    "domain": "gmail.com",
    "has_twitter": true,
    "has_amazon":true,
    "has_linkedin": true,
    "has_airbnb": true,
    "has_instagram": true,
    "found_on_serp": true,
    "first_name": "Tony",
    "last_name": "Stark",
    "education": "...",
    "avatar": "https://avatarfiles.alphacoders.com/185/185358.jpg",
    "score": 200,
    "score_cluster" :"very_low"
  },
}

The following fields can be found under the "email" object

RESPONSE

name

type

value

string

The email of the user provided during the API call

ex: [email protected]

status

string

ex:

deliverable: verified as a real address
invalid: verified as invalid
undetermined: the server cannot be reached
syntax: invalid due to possible spelling error
role: valid, possible role, such as ([email protected] [email protected])
accept-all: not bouncing but cannot verify if the account is active
disposable: verified as a temporary email address
spam-trap: verified as an inactive email address

is_valid

?boolean

The email will not bounce

ex: true, false, null

is_free

?boolean

Indicates the email account belongs to a free service provider. If false, the email account belongs to a company or paying individual

ex: true, false, null

domain

string

The domain name associated with the email address of the user.

ex: Gmail, Yahoo, Libero

has_twitter

?boolean only via webhook

ex: true, false, null

has_amazon

?boolean only via webhook

Equal to true if the user has an Amazon shopping account.

ex: true, false, null

has_linkedin

?boolean only via webhook

ex: true, false, null

has_airbnb

?boolean only via webhook

ex: true, false, null

has_instagram

?boolean only via webhook

Equal to true if the user has an Instagram account

ex: true, false, null

found_on_serp

?boolean only via webhook

ex: true, false, null

first_name

?string

The first name of the user comes from a social network (Linkedin, Twitter)

last_name

?string

The last name of the user comes from a social network (Linkedin, Twitter)

company_name

?string

The name of the company the user works for

ex: Apple, null

company_description

?string

The description of the company the user works for

ex: "Apple Inc. is an American multinational technology company that...", null

company_industry

?string

Indicates the industry/sector of the company

ex: Internet Software & Services, null

company_employees

?number

Indicates the number of employees of the company

ex: 1750, null

company_job_title

?string

Indicates the job title of the user

ex: Sales Manager, null

company_founded

?number

Indicates the year when the company was founded

2014, null

company_keywords

?string

A list of keywords used in the company description

ex: smartphone, null

company_annual_revenue

?number

Indicates our proprietary estimated annual revenue range for company

365000000, null

company_logo

?string

Provides the logo of the company

ex: http://..., null

company_country

?string

Indicates the country name of the company headquarter

ex: US, null

company_twitter_url

?string

Provides the Twitter url of the company

ex: https://twitter.com/company, null

company_facebook_url

?string

Provides the Facebook url of the company

ex: https://www.facebook.com/company, null

company_linkedin_url

?string

Provides the LinkedIn url of the company

ex: https://www.linkedin.com/company, null

company_total_funding

?number

Provides the total amount of funding raised by company

ex: 185000000, null

company_tech_stack

?string

Indicates the set of technologies uses by the company

ex: JavaScript

domain_age

number

Indicates how old is the company domain associated with the email address (in days)

ex: 365

education

?string

The name of the school the user declared to have attended on social networks

ex: Cambridge University, null

employment

?string

The profession the user declared on social networks

Teacher

avatar

?string

The avatar associated with the email address

ex: http://..., null

score

number

A number ranging from 0 to 1000 represents the quality of the email

ex: 649

score_cluster

string

A cluster summarizing the quality of the email (poor, bad, moderate, good, high)

ex: high

FAQ

📘

Is the webhook url mandatory? What happen if i dont pass the webook url

Not all signals are available during the first call and are only available in the webhook response. Check the docs to see those fields.

Language
Authentication
Header
Click Try It! to start a request and see the response here!