Skip to main content
POST
/
customer
/
profile
/
individual
Profile Individual
curl --request POST \
  --url https://devapi.withedge.co/gateway/api/v1/customer/profile/individual \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'requestId: <requestid>' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "otherName": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "salutation": "<string>",
  "gender": "<string>",
  "dateOfBirth": "<string>",
  "bvn": "<string>",
  "nin": "<string>",
  "nationality": "<string>",
  "address": {
    "address": "<string>",
    "street": "<string>",
    "localGovernment": "<string>",
    "city": "<string>",
    "country": "<string>"
  },
  "nextOfKin": {
    "firstName": "<string>",
    "lastName": "<string>",
    "gender": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "relationship": "<string>",
    "address": "<string>",
    "street": "<string>",
    "city": "<string>",
    "country": "<string>",
    "localGovernment": "<string>"
  }
}
'
{
    "statuscode": "00",
    "message": "Customer successfully profiled",
    "data": {
      "customerId": "7100987614",
    }
    "errors": [],
}

Documentation Index

Fetch the complete documentation index at: https://doc.withedge.co/llms.txt

Use this file to discover all available pages before exploring further.

​
Profile Individual

Use this endpoint to create a profile for an individual on the Edge platform. Providing the customer’s BVN is mandatory to ensure they are immediately KYCed for Tier 1 account creation. Optionally, including the NIN will enable KYC for Tier 2.

​
Additional Information

  • To successfully create a customer profile on Edge, the customer’s BVN (Bank Verification Number) must be provided. This ensures the customer is KYCed for Tier 1 account creation.
  • Optionally, you can provide the customer’s NIN (National Identification Number) along with the BVN. Supplying both identifiers enables KYC up to Tier 2.

​
Request Parameters

​
requestId
string
required
A unique identifier for the request, used for idempotency.
Example: e0b9f8d0-7a57-4a67-a8b2-4d7c7b5a37c9
​
firstName
string
required
The first name of the individual.
Example: John
​
lastName
string
required
The last name of the individual.
Example: Doe
​
otherName
string
required
The other names of the individual.
Example: Michael
​
email
string
required
The individual’s email address.
Example: john.doe@example.com
​
phone
string
required
The individual’s phone number.
Example: 08012345678
​
salutation
string
required
The salutation of the individual.
Example: Mr
​
gender
string
required
The gender of the individual.
Example: Male
​
dateOfBirth
string
required
The individual’s date of birth in YYYY-MM-DD format.
Example: 1980-01-01
​
bvn
string
required
The individual’s Bank Verification Number (BVN).
Example: 12345678901
​
nin
string
The individual’s National Identification Number (NIN).
Example: 987654321
​
nationality
string
required
The nationality of the individual.
Example: NGA
​
address
object
required
The address of the individual.
​
address
string
required
The complete address.
Example: 123 Main Street
​
street
string
required
The street of the address.
Example: Main Street
​
localGovernment
string
required
The local government area.
Example: Ikeja
​
city
string
required
The city of the address.
Example: Lagos
​
country
string
required
The country of the address.
Example: NGA
​
nextOfKin
object
required
Details of the individual’s next of kin.
​
firstName
string
required
The first name of the next of kin.
Example: Jane
​
lastName
string
required
The last name of the next of kin.
Example: Doe
​
gender
string
required
The gender of the next of kin.
Example: Female
​
email
string
required
The email address of the next of kin.
Example: jane.doe@example.com
​
phone
string
required
The phone number of the next of kin.
Example: 07012345678
​
relationship
string
required
The relationship between the individual and the next of kin.
Example: Sister
​
address
string
required
The address of the next of kin.
Example: 456 Elm Street
​
street
string
required
The street of the address.
Example: Elm Street
​
city
string
required
The city of the address.
Example: Abuja
​
country
string
required
The country of the address.
Example: NGA
​
localGovernment
string
required
The local government area.
Example: Garki
{
    "statuscode": "00",
    "message": "Customer successfully profiled",
    "data": {
      "customerId": "7100987614",
    }
    "errors": [],
}