# Quick Start

This quick start verifies one email address with the VeriMails API.

## 1. Create an API Key

Create an API key in your VeriMails dashboard.

## 2. Send a Verification Request

```bash
curl -X POST https://verimails.com/api/verify/single \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"person@example.com"}'
```

## 3. Read the Result

```json
{
  "email": "person@example.com",
  "status": "valid",
  "safe_to_send": true,
  "confidence_score": 0.95,
  "reason": "Verification completed",
  "domain": "example.com",
  "is_disposable": false,
  "is_role_based": false,
  "is_free": false,
  "is_catch_all": false,
  "mx_records": ["mx1.example.com"],
  "smtp_response": null,
  "verification_time_ms": 642,
  "api_version": "1.0"
}
```

Use `safe_to_send: true` as the primary filter for sendable records. When `safe_to_send` is false, review the `status` and supporting fields before sending.

## Next Steps
- [Single Verification](https://verimails.com/docs/single-verification)
- [Bulk Verification](https://verimails.com/docs/bulk-verification)
- [Result Codes](https://verimails.com/docs/result-codes)
