> ## Documentation Index
> Fetch the complete documentation index at: https://developer.embedly.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer KYC Upgrade - Address Verification (V2)

> This endpoint enables you to complete address verification for customer in order to upgrade the customer's KYC to Tier 3

<ParamField body="customerId" type="string" required>
  The Embedly unique identifier of the customer whose KYC tier is being
  upgraded. **Example:** `3fa85f64-5717-4562-b3fc-2c963f66afa6`
</ParamField>

<ParamField body="flatNumber" type="string" optional>
  Flat/Unit number. **Example:** `12B`
</ParamField>

<ParamField body="buildingNumber" type="string" optional>
  Building number. **Example:** `8`
</ParamField>

<ParamField body="street" type="string" required>
  Street address. **Example:** `Professor Gabriel Olusanya St`
</ParamField>

<ParamField body="state" type="string" required>
  State. **Example:** `Lagos`
</ParamField>

<ParamField body="city" type="string" required>
  City. **Example:** `Lekki`
</ParamField>

<ParamField body="country" type="string" required>
  Country. **Example:** `Nigeria`
</ParamField>

<ParamField body="landmark" type="string" optional>
  Nearest landmark. **Example:** `Lekki Phase 1 Gate`
</ParamField>

<ParamField body="image" type="string" required>
  Use [https://waas-staging.embedly.ng/api/v1/utilities/upload](https://waas-staging.embedly.ng/api/v1/utilities/upload) to generate a url
  string. The image should be a clear photograph of a valid proof of address
  document, such as a utility bill, bank statement, or government-issued
  document that clearly shows the customer's name and address. The image must be
  in JPEG or PNG format and should not exceed 5MB in size. **Example:**
  `https://waas-staging.embedly.ng/uploads/kyc/addr_verification/1234567890.jpg`
</ParamField>

<ParamField body="imageContentType" type="string" required>
  Image MIME type. **Example:** `image/jpeg`
</ParamField>

<ParamField body="customerNumber" type="string" optional>
  Customer number. **Example:** `CUST_000123`
</ParamField>

<ParamField body="ledgerCode" type="string" optional>
  Ledger code. **Example:** `LEDGER_001`
</ParamField>

<ParamField body="nuban" type="string" optional>
  Customer NUBAN. **Example:** `1234567890`
</ParamField>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "data": {
      "message": "Address verification completed successfully",
      "referenceNumber": "ADDR_20260409112339_6c6ffb63",
      "result": "Success"
    },
    "status": 200,
    "message": ""
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "data": {
      "message": "Address verification failed",
      "referenceNumber": "ADDR_20260409110211_12b106fa",
      "error": "nnnodename nor servnameprovided or not known (hq-qa3-test.sterlingbank.com:9292)"
    },
    "status": 400,
    "message": ""
  }
  ```
</ResponseExample>

```
```