Skip to main content
POST
/
accounts
/
{accountId}
/
related-persons
Add Related Person
curl --request POST \
  --url https://api.rolla.xyz/api/v1/external/accounts/{accountId}/related-persons \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "id": "<string>",
  "firstName": "John",
  "lastName": "Doe",
  "roles": [],
  "email": "jsmith@example.com",
  "phone": "<string>",
  "dateOfBirth": "1990-01-15",
  "ownershipPercentage": 50,
  "currentAddress": {
    "street": "123 Main Street",
    "city": "Lagos",
    "state": "Lagos",
    "postalCode": "100001",
    "country": "NG"
  },
  "sourceOfWealthExplanation": "<string>",
  "bvn": "<string>",
  "nin": "<string>"
}
'
{
  "success": true,
  "message": "Related person added successfully",
  "data": {
    "id": "<string>",
    "firstName": "John",
    "lastName": "Doe",
    "roles": [],
    "email": "jsmith@example.com",
    "phone": "<string>",
    "dateOfBirth": "1990-01-15",
    "ownershipPercentage": 50,
    "currentAddress": {
      "street": "123 Main Street",
      "city": "Lagos",
      "state": "Lagos",
      "postalCode": "100001",
      "country": "NG"
    },
    "sourceOfWealthExplanation": "<string>",
    "bvn": "<string>",
    "nin": "<string>"
  }
}
Adds a beneficial owner or director to a business account’s application. Every related person must complete identity verification — via a KYC link — before the application can be submitted.

​
Example Request

curl -X POST "https://api.rolla.xyz/api/v1/external/accounts/eec3cbed-79d8-4370-87a0-b6be9e287337/related-persons" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Jane",
    "lastName": "Doe",
    "roles": ["Beneficial Owner", "Director"],
    "email": "jane@betalogistics.com",
    "phone": "+13025550124",
    "dateOfBirth": "1985-09-21",
    "ownershipPercentage": 60,
    "currentAddress": {
      "street": "5 Oak St",
      "city": "Wilmington",
      "state": "DE",
      "postalCode": "19801",
      "country": "US"
    }
  }'

​
Example Response

{
  "success": true,
  "message": "Related person added successfully",
  "data": {
    "id": "a3d4f21e-f499-488f-8508-43228dfea485",
    "firstName": "Jane",
    "lastName": "Doe",
    "roles": ["Beneficial Owner", "Director"],
    "email": "jane@betalogistics.com",
    "phone": "+13025550124",
    "dateOfBirth": "1985-09-21",
    "ownershipPercentage": 60,
    "currentAddress": {
      "street": "5 Oak St",
      "city": "Wilmington",
      "state": "DE",
      "postalCode": "19801",
      "country": "US"
    }
  }
}

​
Parameters

FieldTypeRequiredDescription
firstNamestringYesFirst name
lastNamestringYesLast name
rolesstring[]NoBeneficial Owner and/or Director (defaults to Beneficial Owner)
emailstringYesEmail address
phonestringYesPhone number
dateOfBirthstringYesDate of birth (YYYY-MM-DD)
ownershipPercentagenumberNoOwnership stake, 0–100
currentAddressobjectYesResidential address (street, city, state, postalCode, country)
sourceOfWealthExplanationstringNoFree-text source of wealth
bvn / ninstringNoNigerian identifiers, if applicable

Authorizations

​
X-API-Key
string
header
required

Your Rolla API key

Path Parameters

​
accountId
string<uuid>
required

Identifier of an account owned by the same user as your API key's business

Body

application/json
​
id
string
​
firstName
string
Example:

"John"

​
lastName
string
Example:

"Doe"

​
roles
enum<string>[]
Available options:
Beneficial Owner,
Director
​
email
string<email>
​
phone
string
​
dateOfBirth
string
Example:

"1990-01-15"

​
ownershipPercentage
number
Required range: 0 <= x <= 100
​
currentAddress
object
​
sourceOfWealthExplanation
string
​
bvn
string

Bank Verification Number

​
nin
string

National Identification Number

Response

Related person added successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Related person added successfully"

​
data
object