Skip to main content
Hero Light

​
Introduction

This API is designed to help you protect your site’s signup, contact forms, or any other forms from fake names and disposable emails. By validating user details, you can ensure the authenticity of the data being submitted and improve the quality of your user interactions. Request Limits:
  • Free Plan: 25 requests/month
  • Basic Plan: 30,000 requests/month
  • Pro Plan: 65,000 requests/month

Access Your Dashboard

Replace <api-key> with your API key from the dashboard.

​
First Name + Last Name + Disposable Email Verification:

Response when all data is provided. 
curl -X POST "https://api.vishodi.com/api/v1" \
  -H "X-API-Token: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "user_verification",
    "email": "email@disposable.com",
    "firstname": "Donald",
    "lastname": "Trump"
  }'
Response (200)
{
  "status": "success",
  "received_data": {
    "model": "user_verification",
    "email": "test@example.com",
    "firstname": "Donald",
    "lastname": "Trump"
  },
  "request_count": 3,
  "email_verification": {
    "emailAddress": "test@example.com",
    "disposable": false,
    "username": "test",
    "domain": "example.com",
    "dnsCheck": "Pass",
    "syntexCheck": "Pass"
  },
  "name_verification": {
    "firstname": {
      "value": "Donald",
      "prediction": "LABEL_1",
      "confidence": 0.9993
    },
    "lastname": {
      "value": "Trump",
      "prediction": "LABEL_1",
      "confidence": 0.9998
    }
  }
}
Model: user_verification
  • “disposable”: false Indicates a valid Email
  • “disposable”: true Indicates a disposable/temporary Email
  • LABEL_1: Indicates a valid name
  • LABEL_0: Indicates an invalid name
Request Count Explanation:
request_count represents the number of fields included in a request, and these many requests will be deducted from your plan. For example:
  • First name + Last name + Disposable email = 3
  • First name + Last name = 2

​
Partial Data - Email and FirstName Only:

Simply remove the attributes you don’t want in the response. For example, include only firstname and email.
cURL
curl -X POST "https://api.vishodi.com/api/v1" \
  -H "X-API-Token: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "user_verification",
    "email": "email@disposable.com",
    "firstname": "Donald"
  }'
Response (200)
{
  "status": "success",
  "received_data": {
    "model": "user_verification",
    "email": "test@example.com",
    "firstname": "John",
    "lastname": null
  },
  "request_count": 2,
  "email_verification": {
    "emailAddress": "test@example.com",
    "disposable": false,
    "username": "test",
    "domain": "example.com",
    "dnsCheck": "Pass",
    "syntexCheck": "Pass"
  },
  "name_verification": {
    "firstname": {
      "value": "John",
      "prediction": "LABEL_1",
      "confidence": 0.9993
    }
  }
}

​
Empty string provided:

Response when an empty string is provided.
cURL
curl -X POST "https://api.vishodi.com/api/v1" \
  -H "X-API-Token: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "user_verification",
    "email": "email@disposable.com",
    "firstname": "Donald",
    "lastname": ""
  }'
Response (200)
{
  "status": "success",
  "received_data": {
    "model": "user_verification",
    "email": "10min@disposable.site",
    "firstname": "Donald",
    "lastname": ""
  },
  "request_count": 2,
  "email_verification": {
    "emailAddress": "10min@disposable.site",
    "disposable": true,
    "username": "10min",
    "domain": "disposable.site",
    "dnsCheck": "Pass",
    "syntexCheck": "Pass"
  },
  "name_verification": {
    "firstname": {
      "value": "Donald",
      "prediction": "LABEL_1",
      "confidence": 0.9993
    }
  }
}

​
Permutations of Requests:

You can make requests using the following combinations:
  1. All three fields: Email, First name, Last name
  2. Email and First name only
  3. Email and Last name only
  4. First name and Last name only
  5. Email only
  6. First name only
  7. Last name only

API Playground

Explore the API Playground to test and interact with the endpoints.
⌘I