Verify Email

curl -X POST https://api.reversecontact.com/v2/contact/email/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4f1c2a9e-3b7d-4c55-9a8e-1d2f3a4b5c6d" \
  -d '{"email":"jane@acme.com"}'

import ReverseContact from "@reverse-contact/sdk";

const client = new ReverseContact({ apiKey: process.env.RC_API_KEY });

// The SDK sends a new Idempotency-Key on each call and reuses it on its own retries.
// To retry after a restart, store your own key with the request and pass it again.
const job = await client.contact.verifyEmail(
  { email: "jane@acme.com" },
  { idempotencyKey: "4f1c2a9e-3b7d-4c55-9a8e-1d2f3a4b5c6d" }
);
console.log(job.id, job.replayed); // replayed: true when the first response came back

import os

from reversecontact import ReverseContact

with ReverseContact(api_key=os.environ["RC_API_KEY"]) as client:
    # The SDK sends a new Idempotency-Key on each call and reuses it on its own retries.
    # To retry after a restart, store your own key with the request and pass it again.
    job = client.contact.verify_email(
        email="jane@acme.com",
        idempotency_key="4f1c2a9e-3b7d-4c55-9a8e-1d2f3a4b5c6d",
    )
    print(job.id, job.replayed)  # replayed: True when the first response came back

import ReverseContact, { JobFailedError } from "@reverse-contact/sdk";

const client = new ReverseContact({ apiKey: process.env.RC_API_KEY });

const job = await client.contact.verifyEmail({ email: "jane@acme.com" });
console.log("Save this job id:", job.id); // resume after a restart with client.jobs.wait(id)

try {
  // Long polls until the job ends, 30 minutes at most by default.
  const done = await job.wait();
  console.log(done.data.result?.email, done.data.result?.status);
} catch (error) {
  if (error instanceof JobFailedError) console.log("Ended without a verdict:", error.errorCode, "credits:", error.creditsConsumed);
  else throw error;
}

import ReverseContact, { parseWebhookDelivery } from "@reverse-contact/sdk";

const client = new ReverseContact({ apiKey: process.env.RC_API_KEY });

const job = await client.contact.verifyEmail({
  email: "jane@acme.com",
  webhookUrl: "https://your-app.com/webhooks/reversecontact"
});
console.log(job.status, job.id);

// The route behind webhookUrl receives { webhookId, data }: answer within 10 seconds.
async function handleWebhook(request: Request): Promise<Response> {
  const delivery = parseWebhookDelivery(await request.json());
  console.log(delivery.webhookId, delivery.isError ? "failed" : "succeeded", delivery.data);
  return new Response(null, { status: 200 });
}

KEY="YOUR_API_KEY"
ID=$(curl -sX POST https://api.reversecontact.com/v2/contact/email/verify \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"email":"jane@acme.com"}' | jq -r .data.webhookId)

while :; do
  S=$(curl -s https://api.reversecontact.com/v2/webhooks/$ID \
    -H "Authorization: Bearer $KEY" | jq -r .data.status)
  [ "$S" = "succeeded" ] && break
  [ "$S" = "errored" ] && echo "job failed" && exit 1
  sleep 2
done

curl -s https://api.reversecontact.com/v2/webhooks/$ID \
  -H "Authorization: Bearer $KEY" | jq .data.result

curl -X POST https://api.reversecontact.com/v2/contact/email/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane@acme.com",
    "webhookUrl": "https://your-app.com/webhooks/reversecontact"
  }'

import os

from reversecontact import JobFailedError, ReverseContact

with ReverseContact(api_key=os.environ["RC_API_KEY"]) as client:
    job = client.contact.verify_email(email="jane@acme.com")
    print("Save this job id:", job.id)  # resume after a restart with client.jobs.wait(id)

    try:
        # Long polls until the job ends, 30 minutes at most by default.
        done = job.wait()
        if done.data and done.data.result:
            print(done.data.result.email, done.data.result.status)
    except JobFailedError as error:
        print("Ended without a verdict:", error.error_code)

import os

from reversecontact import ReverseContact, parse_webhook_delivery

with ReverseContact(api_key=os.environ["RC_API_KEY"]) as client:
    job = client.contact.verify_email(
        email="jane@acme.com",
        webhook_url="https://your-app.com/webhooks/reversecontact",
    )
    print(job.status, job.id)


# The route behind webhook_url receives {webhookId, data}: answer within 10 seconds.
def handle_webhook(body: bytes) -> None:
    delivery = parse_webhook_delivery(body)
    print(delivery.webhook_id, "failed" if delivery.is_error else "succeeded", delivery.data)

{
  "success": true,
  "data": {
    "status": "created",
    "webhookId": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
    "pollUrl": "/v2/webhooks/c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f"
  },
  "error": null,
  "metadata": {
    "requestId": "req_v1e2r3i4f5y6",
    "executionTimeMs": 95
  },
  "quotas": {
    "creditsConsumed": 1,
    "workspace": {
      "id": "ws_abc123",
      "credits": {
        "total": 10000,
        "used": 4537,
        "left": 5463
      },
      "dailyLimit": null,
      "minuteRateLimit": {
        "limit": 60,
        "used": 10,
        "left": 50,
        "nextReset": "2025-01-20T14:16:00.000Z"
      },
      "hasUnlimitedCredits": false,
      "allowDailyOvercost": false
    },
    "key": {
      "id": "key_abc123",
      "dailyLimit": null,
      "minuteRateLimit": {
        "limit": 60,
        "used": 10,
        "left": 50,
        "nextReset": "2025-01-20T14:16:00.000Z"
      }
    }
  }
}

{
  "success": true,
  "data": {
    "webhookId": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
    "status": "succeeded",
    "eventType": "FETCH_CONTACT_DATA",
    "errorCode": null,
    "createdAt": "2026-11-03T12:43:02.017Z",
    "result": {
      "email": "jane@acme.com",
      "status": "valid"
    },
    "creditsConsumed": 1
  }
}

{
  "webhookId": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
  "data": {
    "email": "jane@acme.com",
    "status": "valid"
  }
}