Quickstart

Send lead data to one endpoint and get a Recovery Score, priority, and next-best action. You can be live in under a minute.

1. Get an API key

Create a free account and generate a key from the dashboard. Keys look like zap_live_... or zap_test_... and are shown only once.

2. Make your first request

Send a single lead as JSON. Only status and lead_age_days are required — the score adapts to whatever additional fields you provide. The API is plain HTTPS + JSON, so any language works; switch tabs for your stack.

curl https://api.zapitra.com/api/v1/leads/recovery \
  -H "Authorization: Bearer zap_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "industry": "roofing",
    "status": "estimate_sent",
    "lead_age_days": 28,
    "last_contact_days": 19,
    "estimate_value": 12000,
    "explicit_rejection": false
  }'

3. Read the response

Every response is structured JSON with an explainable breakdown:

{
  "request_id": "req_a1b2c3d4",
  "lead_id": null,
  "recovery_score": 88,
  "priority": "high",
  "recommended_action": "follow_up",
  "recommended_channel": "phone",
  "recommended_timing": "today",
  "reason": "Driven by a high-value estimate and an open high-value estimate. This is a strong recovery opportunity.",
  "suggested_message": "Call script: Reference the estimate sent to {{first_name}}...",
  "confidence": 0.84,
  "factors": [
    { "factor": "estimate_value", "impact": "positive", "score_effect": 18 }
  ],
  "scoring_version": "1.0.0"
}

• recovery_score — an explainable 0–100 heuristic
• priority — high, medium, or low
• recommended_action, recommended_channel, and recommended_timing
• factors — the exact contributions behind the score