smtpRS Email Validation API Documentation

Email validation and risk scoring API documentation.

smtpRS is Paravane's email validation and email risk scoring API. It analyzes email addresses and returns compact risk intelligence for onboarding, trust, review, and operations workflows.

At a glance

One endpoint, one API key, predictable JSON.

Send an email address to POST /v1/analyse, authenticate with X-API-Key, and use the returned score, decision, credit usage, and response profile in your application.

POST https://api.paravane.io/v1/analyse

Minimal curl request

curl -X POST https://api.paravane.io/v1/analyse \
  -H "Content-Type: application/json" \
  -H "X-API-Key: pvn_live_your_key_here" \
  -d '{"email":"alice@example.com"}'

Documentation map.

01 Quickstart

Get a key, call the API, and read the first response.

02 Authentication

Use API keys safely and understand one-time key display.

03 Analyse endpoint

Request body, query parameters, and scoring profiles.

04 Responses

Decision fields, usage fields, summary and full responses.

05 Errors

Authentication, validation, quota, and service errors.

06 Plans and limits

Credit costs, rate limits, API key limits, and feature gates.

07 Decision guide

Understand validation signals, risk scores, confidence, evidence, and decisions.