Docs

Documentation

Integrate VerifNow into your application in minutes.

Start for free — no credit card required Contact

Quick start

Integrate VerifNow into your application in minutes.

Get an API key and authenticate with the X-API-KEY header.
Send JSON payloads over HTTPS; responses include normalized data.
Use the client dashboard to track validation statistics (usage, errors, latency).

API Reference

Browse the complete API documentation with all endpoints, parameters and response examples.

View API documentation →

Java SDK (Spring)

Use our Java SDK to easily integrate VerifNow into your Spring Boot applications.

View on GitHub →

cURL

curl -X POST https://api.verifnow.io/v1/validate/email \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: sk_test_your_key" \
  -d '{"value":"hello@example.com"}'

Test the API directly with cURL. Authentication is done via the X-API-KEY header.

Java (Spring)

Java SDK (Spring)

Install

<!-- Maven -->
<dependency>
  <groupId>io.verifnow</groupId>
  <artifactId>verifnow-spring-boot-starter</artifactId>
  <version>2.0.1</version>
</dependency>

// Gradle (Kotlin DSL)
dependencies {
  implementation("io.verifnow:verifnow-spring-boot-starter:2.0.1")
}

// Gradle (Groovy)
// implementation 'io.verifnow:verifnow-spring-boot-starter:2.0.1'

Usage example

@Entity
public class User {

   @VerifNowEmail
   private String email;

   @VerifNowPhone
   private String phone;

   // getters and setters
}

Configuration

Set your API key (required) and optional base URL in application.properties (verifnow.api.apiKey, verifnow.api.baseUrl) or via the VERIFNOW_API_KEY environment variable:

# application.properties
verifnow.api.apiKey={VERIFNOW_API_KEY{'}'}
verifnow.api.baseUrl=https://api.verifnow.io

# application.yml
verifnow:
  api:
    apiKey: {VERIFNOW_API_KEY{'}'}
    baseUrl: https://api.verifnow.io

The starter reads the VERIFNOW_API_KEY environment variable or the verifnow.api.apiKey property. Only the apiKey is required; baseUrl is optional. Do not commit secrets to source control.

See full examples and documentation on GitHub.

verifnowio/verifnow-spring →

Usage tracking in the client dashboard

Monitor validations over time, filter by endpoint or environment, and quickly spot integration issues after deployments.

How it works

Use your API key in your backend (never expose it in the browser).
Send validation requests to VerifNow (email, phone, address, custom fields).
Review usage, errors, and latency in your dashboard to keep control of quotas and reliability.

Examples

Client dashboard page to manage API keys. — API keys management
Create, rotate, and revoke API keys from your client dashboard.
Tap to zoomClick to zoom

Client dashboard page showing API usage statistics. — API usage statistics
Track requests, trends, and key metrics to monitor usage over time.
Tap to zoomClick to zoom

Performance & Reliability

99%+

Accuracy

Format checks, normalization, and risk signals designed to reduce false positives.

99.9%

Uptime

Built for production workloads with monitoring, alerts, and safe deploys.

< 50ms

Latency

Typical response time (p50) for most validations.

Metrics are indicative and can vary depending on endpoint, region, and input quality.