API v1

API Documentation

Integrate Ardhi's land verification engine into your loan management system, CRM, or underwriting platform.

Request API Key View Endpoints

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer sk_live_your_api_key_here

API keys are issued per institution. Contact us at enterprise@ardhiverified.com to get started.

Base URL

https://api.ardhiverified.com

Endpoints

POST/api/v1/verify-title

Submit a title for verification. Returns a Trust Score, risk classification, and detailed check results within 48 hours via webhook.

Parameters

Name	Type	Required	Description
title_number	string	required	Land registry title number (e.g. LR.NO.12807/214)
county	string	required	County where the title is registered
owner_name	string	optional	Expected registered owner name (for mismatch detection)
callback_url	string	required	Webhook URL for async result delivery
priority	string	optional	'standard' (48hrs) or 'urgent' (24hrs, 2x price)

Response

{
  "verification_id": "ver_8f3k2j1m",
  "status": "processing",
  "estimated_completion": "2026-04-03T14:00:00Z",
  "callback_url": "https://your-bank.co.ke/webhook"
}

GET/api/v1/verifications/{id}

Retrieve the result of a completed verification. Includes Trust Score, all check results, and a downloadable certificate URL.

Parameters

Name	Type	Required	Description
id	string	required	Verification ID returned from the verify-title endpoint

Response

{
  "verification_id": "ver_8f3k2j1m",
  "status": "completed",
  "trust_score": 92,
  "outcome": "proceed",
  "risk_level": "safe",
  "checks": {
    "title_deed_confirmed": true,
    "nlims_registry_match": true,
    "no_encumbrances": true,
    "no_active_disputes": true,
    "seller_identity_verified": true,
    "agent_lsk_registered": true
  },
  "fraud_risk_score": 0.03,
  "certificate_url": "https://api.ardhiverified.com/certificates/ver_8f3k2j1m.pdf",
  "completed_at": "2026-04-03T11:22:00Z"
}

POST/api/v1/bulk-verify

Submit multiple titles for batch verification. Accepts up to 10,000 titles per request. Results delivered via webhook as each completes.

Parameters

Name	Type	Required	Description
titles	array	required	Array of { title_number, county, owner_name? } objects
callback_url	string	required	Webhook URL — called once per completed verification
batch_label	string	optional	Label for this batch (e.g. 'Q1 2026 Audit')

Response

{
  "batch_id": "bat_9x7m2k4p",
  "total_titles": 2500,
  "status": "queued",
  "estimated_completion": "2026-04-10T18:00:00Z"
}

POST/api/v1/monitor

Enrol a title in continuous monitoring (Land Guardian Enterprise). Nightly NLIMS checks with instant webhook alerts on any changes.

Parameters

Name	Type	Required	Description
title_number	string	required	Title to monitor
county	string	required	County of registration
alert_url	string	required	Webhook URL for change alerts
alert_email	string	optional	Email for critical alerts

Response

{
  "monitor_id": "mon_3p8q1r5t",
  "title_number": "LR.NO.12807/214",
  "status": "active",
  "next_check": "2026-04-02T02:00:00+03:00"
}

GET/api/v1/portfolio/{id}/status

Get the current status of all monitored titles in a portfolio. Includes health summary, at-risk titles, and last check timestamps.

Parameters

Name	Type	Required	Description
id	string	required	Portfolio ID

Response

{
  "portfolio_id": "prt_5k2m8n1q",
  "total_titles": 1250,
  "healthy": 1189,
  "at_risk": 42,
  "critical": 3,
  "pending_check": 16,
  "last_full_scan": "2026-04-01T02:14:00+03:00",
  "next_scan": "2026-04-02T02:00:00+03:00"
}

Webhooks

Ardhi sends POST requests to your callback URLs when verifications complete or monitored titles change. All webhooks include an HMAC-SHA256 signature in the X-Ardhi-Signature header for verification.

verification.completed

Sent when a title verification finishes. Includes the full verification result.

monitor.alert

Sent when a monitored title has a registry change. Includes severity and plain-English explanation.

batch.completed

Sent when all titles in a bulk verification batch have been processed.

monitor.status

Daily summary of portfolio health — total titles, at-risk count, critical alerts.

Ready to integrate?

Contact our enterprise team to get your API key and start verifying titles programmatically.

Request API Key