Skip to main content
The User Verification API provides powerful endpoints for validating user information, including names and email addresses. This API helps you ensure data quality and prevent spam in your applications.
All API endpoints require authentication using an API key in the X-API-Token header.

​
Base URL

https://api.vishodi.com/api/v1

​
Authentication

All API endpoints require an API key for authentication. Include your API key in the request headers: 
{
  "X-API-Token": "your-api-key"
}

Get Your API Key

Sign up and get your API key from the dashboard

​
Rate Limits

25 requests/month

​
Available Endpoints

​
User Verification

First Name Verification

Validate and detect real/fake first names

Last Name Verification

Validate and detect real/fake last names

Email Verification

Detect disposable/temporary email addresses

Complete Verification

Validate complete user information

​
Request Format

All requests should be made using POST method with JSON payload: 
{
  "model": "user_verification",
  "email": "user@example.com",    // optional
  "firstname": "John",            // optional
  "lastname": "Doe"              // optional
}

​
Response Format

Successful responses will have a 200 status code and return JSON: 
{
  "status": "success",
  "received_data": {
    "model": "user_verification",
    "email": "user@example.com",
    "firstname": "John",
    "lastname": "Doe"
  },
  "request_count": 3,
  "email_verification": {
    "emailAddress": "user@example.com",
    "disposable": false,
    "username": "user",
    "domain": "example.com",
    "dnsCheck": "Pass",
    "syntexCheck": "Pass"
  },
  "name_verification": {
    "firstname": {
      "value": "John",
      "prediction": "LABEL_1",
      "confidence": 0.9993
    },
    "lastname": {
      "value": "Doe",
      "prediction": "LABEL_1",
      "confidence": 0.9998
    }
  }
}

Explore the API Playground

Test the API endpoints interactively in our API playground

​
Error Handling

For detailed information about error responses and how to handle them, see our Error Handling Guide.

Error Documentation

Learn about error codes and troubleshooting

API Playground

Test API responses in real-time