v2.0 API Live

Build Utility Integrations in Record Time

The most robust API for electricity vending and access control in Nigeria. Built for developers who value speed, reliability, and precision.

Everything You Need to Build

Comprehensive APIs for utility services, designed for Nigerian developers.

Vending (Venshack)

Purchase prepaid electricity tokens for meters registered to your Venshack organization. Validate meters and track transactions.

Learn more

Vending (Discos)

Purchase prepaid tokens or pay postpaid bills for any supported DISCO meter, with pending-transaction requery. No registration required.

Learn more

Access Codes

Generate and verify visitor access codes for gated communities. Secure, reliable, instant.

Learn more

Meter Management

Manage meters owned by your Venshack organization. Register, import, and track approval status for Venshack meter inventory.

Learn more

Address Verification API

Standalone proof-of-address checks across supported Nigerian DISCOs. No Venshack estate, vending transaction, or registered Venshack meter needed.

Learn more

Webhooks

Receive real-time notifications when events happen. Vending completed, access code used, and more.

Learn more

Pay Only for What You Use

No hidden fees. No complex contracts. Transparent pricing for teams of all sizes.

Vending API

0.5%
₦50 flat below ₦10k
  • Meter validation (Free)
  • Real-time webhooks
  • Sandbox included

Access Control

₦5
per code generated
  • Email, SMS/WhatsApp delivery
  • Verification: ₦5/check
  • Revocation (Free)

Address Verification API

₦200
per live verification
  • Standalone from meter management
  • Supported Nigerian DISCOs
  • Deterministic sandbox included

Enterprise

Custom
for high volume
  • Volume discounts
  • SLA guarantees
  • Dedicated support

Make Your First Call

Get started in seconds with a simple API request.

# Validate a Venshack meter
curl -X POST https://api-developers.venshack.io/v1/vending/validate \
  -H "Authorization: Bearer vk_test_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"meterNumber": "1234567890123"}'
# Validate a DISCO meter (separate collection, no registration required)
curl -X POST https://api-developers.venshack.io/v1/disco-vending/validate \
  -H "Authorization: Bearer vk_test_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"meterNumber": "1234567890123", "disco": "IKEJA", "meterCategory": "PREPAID"}'
# Response
{
  "success": true,
  "data": {
    "success": true,
    "meterNumber": "1234567890123",
    "customerName": "John Doe",
    "customerAddress": "123 Main Street, Lagos",
    "meterType": "SINGLE_PHASE",
    "message": "Meter validated successfully"
  }
}