Skip to main content

Lead Distribution API

The Lead Distribution API enables intelligent routing of leads to buyers based on configurable rules, capacity limits, geographic targeting, and performance metrics. Route leads in real-time with sub-50ms decision times.

Base URL
https://api.synaptis.io/v1

Authentication

All API requests require authentication using a Bearer token in the Authorization header.

Header
Authorization: Bearer your_api_key

Route Lead

Submit a lead for intelligent routing to the optimal buyer based on your configured rules.

POST/leads/route

Request Body

JSON
{
  "lead": {
    "email": "john.smith@company.com",
    "phone": "+15551234567",
    "first_name": "John",
    "last_name": "Smith",
    "state": "GA",
    "zip": "30301",
    "lead_type": "auto_insurance",
    "quality_score": 85
  },
  "routing_options": {
    "method": "weighted",
    "exclude_buyers": ["buyer_xyz"],
    "max_buyers": 1,
    "timeout_ms": 5000
  }
}

Response

JSON
{
  "status": "routed",
  "lead_id": "lead_abc123",
  "buyer": {
    "id": "buyer_456",
    "name": "Alpha Insurance",
    "delivery_method": "api"
  },
  "routing": {
    "method": "weighted",
    "eligible_buyers": 4,
    "decision_time_ms": 23
  },
  "delivery": {
    "status": "accepted",
    "response_time_ms": 124,
    "buyer_reference": "ALI-2024-001234"
  }
}

Routing Methods

Available distribution algorithms for routing leads to buyers.

round_robinRound Robin

Distribute leads evenly across all eligible buyers in sequential order.

weightedWeighted Distribution

Assign percentage weights to buyers. Higher-weighted buyers receive more leads.

performancePerformance-Based

Route more leads to buyers with higher acceptance rates and conversions.

priorityPriority/Waterfall

Route to buyers in priority order. Falls through if rejected or timeout.

geographicGeographic

Route based on state, zip code, DMA, or custom geographic zones.

Buyer Management

Endpoints for managing buyers in your distribution network.

GET/buyersList all buyers
POST/buyersCreate new buyer
GET/buyers/:idGet buyer details
PUT/buyers/:idUpdate buyer
PUT/buyers/:id/statusPause/resume buyer

Capacity Caps

Configure lead volume limits for buyers on daily, weekly, and monthly intervals.

Set Capacity - PUT /buyers/:id/caps
{
  "daily_cap": 100,
  "weekly_cap": 500,
  "monthly_cap": 2000,
  "overflow_action": "route_to_backup",
  "backup_buyers": ["buyer_backup1", "buyer_backup2"]
}

Geographic Rules

Configure geographic targeting for buyer eligibility.

Set Geography - PUT /buyers/:id/geography
{
  "type": "include",
  "states": ["GA", "FL", "SC", "NC", "TN"],
  "zip_codes": [],
  "dmas": [],
  "exclusive": false
}

Response Codes

200OKLead successfully routed to buyer
201CreatedResource created successfully
400Bad RequestInvalid request parameters
401UnauthorizedInvalid or missing API key
404Not FoundResource not found
422UnprocessableNo eligible buyers found
429Rate LimitedToo many requests
500Server ErrorInternal server error
Verification APIPing/Post API

Demo Platform: This is a demonstration of our custom development capabilities. We build tailored solutions for your specific needs.

Schedule Demo