# Vimehi — Comprehensive Machine & LLM Technical Protocol (llms-full.txt)
Version: 1.0.0
Base URL: https://vimehi.com
Contact: support@vimehi.com

---

## 1. System Overview & Architecture
Vimehi is an email deliverability, verification, and automated marketing suite. It combines proprietary algorithmic heuristics with high-performance upstream verification relays to deliver sub-second validation results.

### Core Guarantees:
- 99.8% verification accuracy rate.
- Non-intrusive SMTP handshake (verifies recipient mailbox existence without dispatching messages).
- Zero data training on uploaded customer lists (SOC2 and GDPR privacy principles).
- Single source of truth across customer UI, APIs, and administrative controllers.

---

## 2. API Specification for Autonomous AI Agents

### 2.1 Single Email Verification
- **Endpoint**: `POST https://vimehi.com/api/verify/single`
- **Authentication**: Session cookie or Bearer API token in headers.
- **Request Headers**:
  - `Content-Type: application/json`
- **Request Body (JSON)**:
```json
{
  "email": "user@example.com"
}
```
- **Response Format (JSON)**:
```json
{
  "success": true,
  "result": {
    "email": "user@example.com",
    "status": "ok",
    "sub_status": "mailbox_exists",
    "deliverability": "deliverable",
    "is_disposable": false,
    "is_free": false,
    "is_role_based": false,
    "mx_found": true,
    "mx_record": "mail.example.com",
    "did_you_mean": null,
    "score": 100,
    "credits_deducted": 1,
    "verified_at": "2026-09-04T05:00:00.000Z"
  }
}
```

### 2.2 Status Field Enumerations
- `status`:
  - `"ok"` / `"deliverable"`: Mailbox is valid, recipient exists, safe to send.
  - `"invalid"`: Mailbox does not exist, host unreachable, or syntax error.
  - `"risky"` / `"catch_all"`: Server accepts all incoming mail regardless of local part; deliverability cannot be guaranteed.
  - `"unknown"`: Mailbox timed out or upstream server throttled the check.

---

## 3. Dynamic Pricing Tiers (Single Source of Truth)
Active packages from live database:
- ID: "tier_10k" | Name: "Starter" | Credits: 10000 | Price: $39.00 USD
- ID: "tier_50k" | Name: "Growth" | Credits: 50000 | Price: $149.00 USD
- ID: "tier_100k" | Name: "Pro" | Credits: 100000 | Price: $249.00 USD
- ID: "tier_500k" | Name: "Enterprise" | Credits: 500000 | Price: $799.00 USD

---

## 4. Autonomous Agent Tools Manifest
See /agent.json or /.well-known/agent.json for OpenAPI 3.1 tool schemas usable by LangChain, AutoGen, OpenAI Assistants API, and Gemini tools.