Skip to main content
POST
https://api.fossapay.com
/
v1
/
customers
/
kyc
/
address
Verify Address
curl --request POST \
  --url https://api.fossapay.com/v1/customers/kyc/address \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "customerId": "<string>",
  "meterNumber": "<string>",
  "houseAddress": "<string>",
  "state": "<string>"
}
'
{
  "success": true,
  "message": "Address verification completed successfully"
}

​
Headers

​
x-api-key
string
required
API Key for authentication

​
Request Body

​
customerId
string
required
Customer ID
​
meterNumber
string
required
Electricity meter number
​
houseAddress
string
required
Full house address
​
state
string
required
State for the address (must be one of the DISCO codes)

​
Valid DISCO Codes

The state field must be one of the following DISCO codes:
  • 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

​
Request Example

curl -X POST https://api.fossapay.com/v1/customers/kyc/address \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust_123456789",
    "meterNumber": "1234567890",
    "houseAddress": "123 Main Street, Victoria Island",
    "state": "LAGOS"
  }'

const response = await fetch('https://api.fossapay.com/v1/customers/kyc/address', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customerId: 'cust_123456789',
    meterNumber: '1234567890',
    houseAddress: '123 Main Street, Victoria Island',
    state: 'LAGOS'
  })
});

​
Response

{
  "success": true,
  "message": "Address verification completed successfully"
}

​
Error Responses

​
Notes

  • The meter number is used to verify the address with the electricity distribution company
  • The state must match one of the valid DISCO codes exactly (case-sensitive)
  • Address verification may take 10-30 seconds to complete
  • This endpoint triggers KYC level upgrade for the customer upon successful verification
  • The verification process connects to the Nigerian electricity distribution system