LivePay API Documentation

Overview

The Validate Number API allows you to check if a phone number is registered on MTN or Airtel mobile money and retrieve the customer's name.

Endpoint

https://livepay.me/api/validate-number

Method: POST

Quick Start

Request Example

Terminal

curl -X POST https://livepay.me/api/validate-number \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <Your API Key>" \
  -d '{"phoneNumber": "07XXXXXXXXX"}'

Authentication

All API requests require Bearer token authentication using your API key in the Authorization header.

Headers

Authorization

Bearer <Your API Key>

Content-Type

application/json

API Key Format

Your API key is provided in your dashboard. Use it directly in the Authorization header as shown above.

Request Body Parameters

Parameter	Type	Required	Description
`phoneNumber`	String	Yes	Phone number

Response Format

Success Response (200 OK) - Registered Number

success.json

{
  "success": true,
  "message": "Msisdn +2567XXXXXXXX successfully validated.",
  "customer_name": "CUSTOMER NAME"
}

Success Response (200 OK) - Unregistered Number

unregistered.json

{
  "success": false,
  "message": "Msisdn +2567XXXXXXXX not validated."
}

Error Responses

Status Code	Error Message	Description
400	`Missing phoneNumber`	Phone number is required
400	`Unsupported phone number. Use MTN or Airtel`	Invalid network provider
401	`Authorization required`	Missing Authorization header
401	`Invalid API key`	Invalid API key format or value
403	`Account not authorized`	Business account not verified