curl -X POST "https://api.v2.dealmachine.com/v1/enrichment/email" \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "data": [
      { "email": "john.smith@example.com" },
      { "email": "sarah.johnson@example.com" }
    ],
    "fields": ["full_name", "phones", "emails", "estimated_value"],
    "include_properties": true
  }'

const response = await fetch('https://api.v2.dealmachine.com/v1/enrichment/email', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    data: [{ email: 'john.smith@example.com' }, { email: 'sarah.johnson@example.com' }],
    fields: ['full_name', 'phones', 'emails', 'estimated_value'],
    include_properties: true,
  }),
});

const { data, totals } = await response.json();

console.log(`Matched ${totals.matched} of ${totals.submitted}`);
for (const item of data) {
  if (item.matched) {
    for (const contact of item.contacts) {
      console.log(`${item.input.email} → ${contact.full_name} — ${contact.phones?.[0]?.number}`);
      for (const prop of contact.properties ?? []) {
        console.log(`  Property: ${prop.address}`);
      }
    }
  } else {
    console.log(`No match: ${item.input.email}`);
  }
}

import requests

response = requests.post(
    "https://api.v2.dealmachine.com/v1/enrichment/email",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "data": [
            {"email": "john.smith@example.com"},
            {"email": "sarah.johnson@example.com"},
        ],
        "fields": ["full_name", "phones", "emails", "estimated_value"],
        "include_properties": True,
    },
)

body = response.json()
for item in body["data"]:
    if item["matched"]:
        for contact in item["contacts"]:
            print(f"{item['input']['email']} → {contact['full_name']}")
            for prop in contact.get("properties", []):
                print(f"  Property: {prop['address']}")
    else:
        print(f"No match: {item['input']['email']}")

{
  "data": [
    {
      "input": {
        "email": "john.smith@example.com"
      },
      "matched": true,
      "contacts": [
        {
          "dm_person_id": "per_x1y2z3",
          "full_name": "John Smith",
          "first_name": "John",
          "last_name": "Smith",
          "phones": [
            { "number": "5125551234", "type": "wireless", "do_not_call": false },
            { "number": "5125559999", "type": "wireless", "do_not_call": false }
          ],
          "emails": [{ "address": "john.smith@example.com" }],
          "property_count": 1,
          "properties": [
            {
              "dm_property_id": "prop_a1b2c3",
              "address": "1200 Barton Springs Rd",
              "city": "Austin",
              "state": "TX",
              "zip": "78704",
              "latitude": 30.2598,
              "longitude": -97.7544
            }
          ]
        }
      ]
    },
    {
      "input": {
        "email": "sarah.johnson@example.com"
      },
      "matched": false,
      "match_failure": {
        "code": "not_found",
        "reason": "No person found matching the provided email address"
      }
    }
  ],
  "totals": {
    "submitted": 2,
    "matched": 1,
    "unmatched": 1
  },
  "credits": {
    "used": 2,
    "properties": 1,
    "people": 1,
    "deduplicated": 0
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Validation failed",
    "request_id": "req_abc123def456",
    "details": {
      "issues": [
        {
          "path": "data[0].email",
          "message": "email must be a valid email address"
        }
      ]
    }
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "The provided API key is invalid",
    "request_id": "req_def456ghi789"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please retry after the specified time.",
    "request_id": "req_ghi789jkl012"
  }
}