API v1StableLast updated Oct 2026Changelog →
Core concepts

Batch analysis

Score many leads at once with a pipeline summary.

POST /api/v1/leads/recovery/batch takes a leads array of up to 1,000 entries, using the same fields as Lead Recovery.

curl -X POST https://messyapi.com/api/v1/leads/recovery/batch \
  -H "Authorization: Bearer $MESSYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "leads": [
    {
      "lead_id": "l_1",
      "industry": "roofing",
      "status": "estimate_sent",
      "lead_age_days": 28,
      "estimate_value": 12000
    },
    {
      "lead_id": "l_2",
      "industry": "hvac",
      "status": "no_response",
      "lead_age_days": 190,
      "estimate_value": 5200
    }
  ]
}'

Summary fields

total_leads, high/medium/low_priority_count, total_pipeline_value, high_priority_pipeline_value, processing_time_ms.

If the batch would exceed your remaining allowance, the whole request returns 429 and nothing is charged.