SmartScore for developers

Start here: choose your API mode

All integrations call /api/sdk/smartscore. Select mode by commercial use case:

• listing for buyer-facing listing badges and reliability labels
• explain for plain-English support and operations output
• auction for pre-bid risk workflows and salvage screening
• warranty for underwriting and maintenance-risk decisions
• fraud for deterministic listing integrity and trust & safety scoring
• ultra for deepest enterprise intelligence

Ultra accepts useCase or marketVertical with values marketplace, auction, or warranty to tune sensitivity for your vertical.

Current calibration intent: warranty runs roughly 12–18% stricter than auction on repair-likelihood and exposure outputs, while marketplace stays buyer-friendly.

1. Add the SmartScore SDK

Drop a single script tag on your marketplace or OEM site. SmartScore scans your listing cards and injects a buyer-friendly badge.

<script
  src="https://YOURDOMAIN.com/smartscore-sdk.js"
  data-publishable-key="pk_live_partner123">
</script>

2. Mark up your listing cards

Add data attributes to each card. The SDK calls your endpoint at /api/sdk/smartscore and renders the badge.

<div class="vehicle-card"
     data-smartscore-asset="AB12CDE"
     data-smartscore-type="car">
  <span class="price">£7,495</span>
  <span class="smartscore-badge-mount"></span>
</div>

For properties, yachts or jets, set data-smartscore-type="home" | "commercial" | "yacht" | "jet".

3. API flow used by the SDK

The public SDK calls /api/sdk/smartscore, which then routes to internal engines:

• /api/score for SmartScore reliability scoring
• /api/predict for expected yearly maintenance and 12-month repair likelihood
• /api/dvsa/mot for UK inspection history (vehicles only)
• /api/sdk/fraud for standalone fraud and listing integrity signals

Ultra mode adds richer decision signals and buyer-friendly explanations for enterprise partners.

4. Fraud intelligence request example

Use fraud mode when you need explicit listing anomaly checks for trust and safety workflows.

POST /api/sdk/smartscore
{
  "assetType": "car",
  "assetId": "AB12CDE",
  "publishableKey": "pk_live_partner123",
  "mode": "fraud",
  "price": 7995,
  "expected_price_band": { "low": 9200, "high": 10800 },
  "text": "bank transfer only, no viewing"
}

5. Ultra mode request example

Use Ultra for highest-sensitivity decisions. Set either useCase or marketVertical to apply the right calibration profile.

POST /api/sdk/smartscore
{
  "assetType": "car",
  "assetId": "AB12CDE",
  "publishableKey": "pk_live_partner123",
  "mode": "ultra",
  "useCase": "warranty"
}

Accepted profiles: marketplace, auction, warranty.