Developers

Build on Lodum.

Embed Lodum's financial, utility, and retail capabilities into your own products via a clean, RESTful API.

Base URL

https://api.lodumai.com/v1

Auth

Authorization: Bearer <API_KEY>

Version

v1 — Stable

📖

Introduction to Lodum Platform API — authentication, base URL, versioning, and rate limits.

🏦

Initiate transfers, query balances, manage wallets, and access transaction history programmatically.

⚡

Control and monitor smart meters and water pumps — load tokens, read usage, query grid status.

💳

Issue virtual accounts, process card transactions, and initiate FX conversions at scale.

🔔

Subscribe to real-time events — transaction completions, KYC updates, utility alerts, and more.

📦

Official SDKs for Node.js, Python, and Go. Community SDKs for PHP, Ruby, and Java.

🔒

BVN/NIN verification, document upload, and tiered identity management for your users.

🟢

Real-time and historical uptime data for all Lodum platform components.

Quick Start

Make your first API call

Test your connection with a simple balance check

curl -X GET https://api.lodumai.com/v1/account/balance \
  -H "Authorization: Bearer lod_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json"

All endpoints require HTTPS. Use the test environment for development.