Skip to main content
Follow these steps to authenticate with Superior Van & Mobility and send your first ADF lead.
1

Request your API key

Ask your Superior Van partner contact for an API key. Send it on every request in the x-api-key header.
2

Set your environment

Work in sandbox first:
# Set environment variables for your tooling
export SUPERIORVAN_API_KEY="<your-api-key>"
export SUPERIORVAN_BASE_URL="https://sandbox.superiorvan.com/v1"
Use https://api.superiorvan.com/v1 when you are ready for production.
3

Create your first lead (JSON)

curl -X POST "$SUPERIORVAN_BASE_URL/leads" \
  -H "x-api-key: $SUPERIORVAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Alex",
    "lastName": "Rivers",
    "email": "[email protected]",
    "phone": "502-555-1234",
    "vehicleYear": "2025",
    "vehicleMake": "Toyota",
    "vehicleModel": "Sienna",
    "vehicleMiles": "12000"
  }'
4

Check lead status

Use the returned leadId to check status updates.
curl -X GET "$SUPERIORVAN_BASE_URL/leads/lead_12345" \
  -H "x-api-key: $SUPERIORVAN_API_KEY"

​
Required headers

  • x-api-key: <your-api-key> (required on every request).
  • Content-Type: application/json

​
Status codes to expect

  • 2xx for success.
  • 400 for validation errors.
  • 401 for missing or invalid API keys.
  • 404 when a referenced lead cannot be found.
  • 409 when a lead already exists for the provided identifiers.
Next, review the API Reference for schemas, required fields, and additional examples.