Back to Docs

API Reference

Base URL: https://api.leadmagic.io/v1

Enrich Email

POST/enrich/email

Request

{
  "firstName": "John",
  "lastName": "Doe",
  "company": "Acme Inc"
}

Response

{
  "success": true,
  "data": {
    "email": "john.doe@acme.com",
    "confidence": 0.95,
    "provider": "leadmagic"
  },
  "metadata": {
    "requestId": "req_abc123",
    "latencyMs": 245,
    "cost": 0.01
  }
}

Error Codes

CodeStatusDescription
unauthorized401Invalid or missing API key
forbidden403Insufficient permissions
rate_limit_exceeded429Too many requests
provider_error502Upstream provider error