Developer platform

ArdhiTrust Registry API

Banks, conveyancers and county systems can verify search certificates and confirm the status of a title without handling personal data. Access is by scoped API key, issued by the ministry registry administrator.

Authentication

Send your key in the x-api-key header (or as a Bearer token). Keys are shown once at issue time, are scoped, rate limited to 120 requests per minute, and every call is logged and attributable. Rotate or revoke instantly by contacting the registry administrator.

curl -H "x-api-key: ardhi_live_xxxxxxxxxxxxxxxx" \
  "https://ardhitrust.galaxydynamics.ai/api/public/v1/verify?serial=ARD-2026-0001"

GET/api/public/v1/verifyscope: verify

Confirm that a search certificate serial was issued by the registry and has not been revoked.

Request

GET /api/public/v1/verify?serial=ARD-2026-0001
x-api-key: ardhi_live_...

Response

{
  "valid": true,
  "serial": "ARD-2026-0001",
  "issued_at": "2026-07-14T09:12:03Z",
  "revoked": false,
  "integrity_hash": "9f2c...",
  "parcel": {
    "title_no": "NRB/BLK-12/4589",
    "county": "Nairobi",
    "tenure": "leasehold",
    "use_class": "residential",
    "status": "active"
  }
}

GET/api/public/v1/parcelsscope: registry.read

Look up the public status of a title. Owner identity and valuation are never returned.

Request

GET /api/public/v1/parcels?title_no=NRB/BLK-12/4589
x-api-key: ardhi_live_...

Response

{
  "found": true,
  "parcel": {
    "title_no": "NRB/BLK-12/4589",
    "county": "Nairobi",
    "sub_county": "Westlands",
    "area_ha": 0.045,
    "tenure": "leasehold",
    "use_class": "residential",
    "status": "active",
    "protected": false,
    "encumbered": true,
    "last_updated": "2026-06-02T11:40:00Z"
  }
}

Status codes

200 — request succeeded
400 — missing or malformed query parameter
401 — missing, unknown or revoked key
403 — key lacks the required scope
404 — certificate or title not found
429 — rate limit exceeded

Request access

Registry administrators issue keys from the Admin portal under System → Partner API. Institutions should apply through the ministry with the intended use case and the systems that will consume the API.