Skip to main content
POST
/
customers
/
kyc
/
address-verification
Customer KYC Upgrade - Address Verification
curl --request POST \
  --url https://waas-staging.embedly.ng/api/v1/customers/kyc/address-verification \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "customerId": "<string>",
  "meterNumber": "<string>",
  "houseAddress": "<string>",
  "discoCode": "<string>"
}
'
{
  "data": {
    "status":"successful",
    "message":"Verification successful!",
    "timestamp":"2025-12-10T07:39:14.9402901Z",
    "data": {
    	"verified":true,
        "houseAddress":"1 Abuja street, Nigeria",
        "houseOwner":"Du**\***","confidenceLevel":95,"discoCode":"00"
		}
 	},
	"status":200,
    "message":""
}
​
customerId
string
required
The Embedly unique identifier of the customer whose KYC tier is being upgraded. Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
​
meterNumber
string
required
The utility document of the customer’s address.
​
houseAddress
string
required
The address of the customer whose kyc is to be upgraded.
​
discoCode
string
required
Disco Code must be one of ABUJA, EKO, IKEJA, IBADAN, ENUGU, PH, JOS, KADUNA, KANO, BH, PROTOGY, PHISBOND, ACCESSPOWER, YOLA, ABIA, ADAMAWA, AKWA IBOM, ANAMBRA, BAUCHI, BAYELSA, BENUE, BORNO, CROSS RIVER, DELTA, EBONYI, EDO, EKITI, GOMBE, IMO, JIGAWA, KATSINA, KEBBI, KOGI, KWARA, LAGOS, NASSARAWA, NIGER, OGUN, ONDO, OSUN, OYO, PLATEAU, RIVERS, SOKOTO, TARABA, YOBE, ZAMFARA, FCT
{
  "data": {
    "status":"successful",
    "message":"Verification successful!",
    "timestamp":"2025-12-10T07:39:14.9402901Z",
    "data": {
    	"verified":true,
        "houseAddress":"1 Abuja street, Nigeria",
        "houseOwner":"Du**\***","confidenceLevel":95,"discoCode":"00"
		}
 	},
	"status":200,
    "message":""
}