Skip to main content
VerifyDest
API v1

API Documentation

Complete reference for VerifyDest REST APIs

IBAN Validation API
Validate International Bank Account Numbers (IBAN) with bank lookup and risk assessment
POST /api/v1/iban
Wallet Validation API
Validate cryptocurrency wallet addresses with chain detection and risk scoring
POST /api/v1/wallet
Authentication
All API endpoints require authentication using an API key. You can create and manage your API keys in the dashboard.

Authentication Methods

1. Bearer Token (Recommended)
Authorization: Bearer vd_xxx...
2. X-API-Key Header
X-API-Key: vd_xxx...
Get your API key
Base URL
https://verifydest.io/api/v1
Examples
curl -X POST https://verifydest.io/api/v1/iban \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"iban": "IT60X0542811101000000123456"}'
Rate Limits
API rate limits are based on your subscription plan. Limits reset daily or monthly depending on your tier.
TierAPI AccessLimit
Free
No
-
Basic
Yes
100/day
Pro
Yes
500/day
Business
Yes
2,500/day
Enterprise
Yes
Unlimited

Response Headers

X-RateLimit-Limit: Your rate limit ceiling
X-RateLimit-Remaining: Remaining requests in current window
X-RateLimit-Reset: Unix timestamp when the rate limit resets
Error Codes
Error CodeHTTP StatusDescription
MISSING_KEY
401
No API key provided
INVALID_KEY
401
Invalid or revoked API key
EXPIRED_KEY
401
API key has expired
BLOCKED_KEY
403
Too many failed attempts
IP_NOT_ALLOWED
403
IP not in whitelist
RATE_LIMITED
429
Rate limit exceeded
NO_API_ACCESS
403
Plan doesn't include API
PERMISSION_DENIED
403
Key lacks permission