Get Customers

The Customers API allows businesses to retrieve customer details saved in Smart Invoice.
This ensures third-party systems can fetch existing customer information such as names, addresses, and contact details.

GetCustomerAsync() method

This method retrieves customer details based on the provided customer TPIN.

Request Parameters

NB: These details are stored in the configuration files

Parameter	Type	Description
TPIN	string	Business TPIN registered in Smart Invoice
Branch Id	string	Identifier for the branch
Customer TPIN	string	The TPIN of the customer being retrieved

Usage Example

Response

{
  "success": true,
  "code": "000",
  "message": "Customer retrieved successfully",
  "timestamp": "2025-09-22 08:26:00",
  "data": {
    "tpin": "1002890781",
    "bhfId": "000",
    "custNo": "0774969385     ",
    "custTpin": "1002890782",
    "custNm": "MJ Morgens",
    "adrs": "60 bargate road, vainona, harare",
    "telNo": "0774969384",
    "email": "mmuchada@axissol.com",
    "faxNo": "",
    "useYn": "Y",
    "remark": "",
    "regrId": "",
    "regrNm": "",
    "modrId": "",
    "modrNm": ""
  },
  "error": null
}