A buyer asked you to check leads with LeadVettr.

Before you deliver a lead to them, send it to LeadVettr. You get a verdict in about 150 ms. Deliver leads marked accept; hold back the rest. Fewer returns for you, fewer bad leads for them.

1. Your key

The buyer sent you a seller key (it starts with lv_live_). It only lets you submit leads for that buyer and always tags them with your company name. Keep it private. If you work with several LeadVettr buyers, you'll have one key per buyer.

2. Send each lead

POST https://leadvettr.com/_api/v1/score with the header Authorization: Bearer YOUR_SELLER_KEY (or ?api_key=YOUR_SELLER_KEY on the URL). JSON or form-encoded bodies both work, and common field names (FirstName, phone_home, zipcode, xxTrustedFormCertUrl…) are recognised.

Example request

curl -X POST "https://leadvettr.com/_api/v1/score" \
  -H "Authorization: Bearer YOUR_SELLER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_id": "A-1009",
    "first_name": "Maria",
    "last_name": "Lopez",
    "phone": "5125550199",
    "email": "maria@example.com",
    "state": "TX",
    "zip": "73301",
    "ip_address": "73.12.44.201",
    "form_duration_seconds": 94,
    "consent_cert_id": "https://cert.trustedform.com/abc123",
    "date_of_birth": "1961-04-12"
  }'

phone	10-digit US phone. Strongly recommended.
first_name, last_name, email	Consumer details.
state, zip	Two-letter state and 5-digit ZIP.
ip_address, form_duration_seconds	From your form — they help show the lead is real.
consent_cert_id	TrustedForm certificate URL or Jornaya LeadiD. Missing consent lowers the score.
date_of_birth	YYYY-MM-DD. Required for Medicare and legal buyers' age and claimant checks.
lead_id	Your own ID, echoed back so you can match responses.
case_type, incident_date, has_attorney, injury_description	Legal leads only.

3. Read the verdict

Response

{
  "check_id": "lv_48213",
  "lead_id": "A-1009",
  "verdict": "accept",
  "score": 0,
  "reasons": [],
  "thresholds": { "review": 30, "reject": 60 },
  "scored_at": "2026-09-25T14:03:11.402Z",
  "saved": true
}

verdict is accept, review or reject. reasons explains any points. If your platform can only match text, add ?format=text to the URL and the whole response is just the verdict word.

Errors

401 key missing or revoked · 400 invalid fields · 429 too many requests (see Retry-After) · 402/403 the buyer's account can't accept more leads right now. If LeadVettr doesn't answer within 5 seconds, follow your agreement with the buyer.

Stuck? The chat in the corner of this page knows this guide and can walk you through it. You can also contact LeadVettr.