Imagin8 API Specification
Integration for Real time Intelligence

Contact Details Enquiry

API Specification


Unless specified as Optional, all parameters are mandatory
API Suite: Contact Details
Purpose: Returns details about the owner and previous owners of a contact number. This can be a landline or mobile number. The API will return up to the last 5 owners details.
Web Service: avs_bulkCheckJobId.php
Root URL: Live https://www.imagin8.co.za/webservices/valid8/AVS
Root URL: Sandbox https://www.imagin8.co.za/webservices/valid8/Sandbox/AVS
Parameters Parameter Name Parameter Description
uname The Imagin8 Username
password The Imagin8 Password
appName The application name, verified by Imagin8
clientRef The Customer ID provided by Imagin8
contact The Contact Number to be checked
Call Example .../ces_doEnquiry.php?appName=CES&clientRef=9999&uname=MyUserName&password=MyPassword&contact=0821234567
Return Values Up to the last 5 recorded owners of this contact number will be returned
Return Values Example {"result":1,"Response":[{"TransactionCompleted":true,"IDNumber":"8001011234080","Name":"SMITH","MiddleName":"","LastName":"JOHN","TransactionID":"00033"},{"TransactionCompleted":true,"IDNumber":"8912124321080","Name":"FRED","MiddleName":"","LastName":"JACKSON","TransactionID":"00033"}]}