# VerifyPulse — Autonomous Email Deliverability & Verification Engine
> Real-time email verification API optimized for AI agents, scrapers, cold outreach tools, and developer workflows.

Base URL: https://verifypulse-seven.vercel.app
OpenAPI Specification: https://verifypulse-seven.vercel.app/openapi.json

## Overview
VerifyPulse verifies whether an email address is valid, deliverable, disposable, or risky before sending.
- Sub-200ms latency.
- Full RFC 5322 syntax validation.
- Live DNS MX record resolution and typo suggestion.
- 3,800+ disposable / burner domain blacklist.
- Zero-send SMTP handshake emulation.
- Dedicated autonomous agent provisioning and Base USDC micropayments (no human KYC required).

## Authentication
Pass your API key in either of the following HTTP headers:
- `X-API-Key: vp_live_...`
- `Authorization: Bearer vp_live_...`

## Free Autonomous Agent Provisioning (Zero Friction)
Agents can self-provision without a human web browser or CAPTCHA:

POST https://verifypulse-seven.vercel.app/v1/agent/provision
Content-Type: application/json

{"agent_id": "outreach-worker-1"}

Response:
{
  "success": true,
  "api_key": "vp_live_abc123...",
  "credits": 100,
  "endpoints": { ... },
  "autonomous_topup": { ... }
}

## Core Endpoints

### 1. Single Email Verification
Endpoint: POST /v1/verify
Headers:
  X-API-Key: <your_key>
  Content-Type: application/json
Body:
  {"email": "alex@company.com", "check_smtp": false}

Response:
{
  "success": true,
  "credits_remaining": 99,
  "data": {
    "email": "alex@company.com",
    "status": "valid",
    "score": 95,
    "reason": "Domain has active MX records and valid syntax.",
    "suggestion": null,
    "details": {
      "is_syntax_valid": true,
      "has_mx": true,
      "is_disposable": false,
      "is_role_account": false,
      "is_free_provider": false,
      "mx_records": ["aspmx.l.google.com"]
    }
  }
}

### 2. Free Demo Inspection (No Auth Required)
Endpoint: POST /api/demo-verify
Body: {"email": "alex@company.com"}

### 3. Check Account & Credit Balance
Endpoint: GET /v1/account
Headers: X-API-Key: <your_key>

### 4. Bulk CSV List Cleaning
Endpoint: POST /v1/verify-batch
Form-Data: file=<csv_file>
Headers: X-API-Key: <your_key>

## Autonomous Micropayment Top-up (Base USDC)
When an agent exhausts its credits, it can autonomously replenish credits by sending USDC on Base:
- Network: Base (Chain ID 8453)
- Token Contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC)
- Recipient Wallet: 0x42871B99A3AA942D3B8EC7E43D37979886E856cA
- Rates:
  - micro: $3.00 USDC -> 3,000 credits ($0.001 / check)
  - starter: $7.00 USDC -> 10,000 credits ($0.0007 / check)
  - pro: $19.00 USDC -> 35,000 credits ($0.00054 / check)
  - agency: $49.00 USDC -> 120,000 credits ($0.0004 / check)

After sending the on-chain transfer, the agent calls:
POST https://verifypulse-seven.vercel.app/api/checkout/crypto-verify
Body:
{
  "tx_hash": "0xYourTxHashOnBase",
  "pack": "micro",
  "user_email": "agent_xxx@autonomous.agent"
}
Credits are verified on-chain via Base RPC and credited immediately.