Skip to main content
PUT
/
accounts
/
{accountId}
/
related-persons
/
{personId}
Update Related Person
curl --request PUT \
  --url https://api.rolla.xyz/api/v1/external/accounts/{accountId}/related-persons/{personId} \
  --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 updated 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>"
  }
}
Updates a related person on a business account’s application. Provided fields are merged into the existing record.

​
Example Request

curl -X PUT "https://api.rolla.xyz/api/v1/external/accounts/eec3cbed-79d8-4370-87a0-b6be9e287337/related-persons/a3d4f21e-f499-488f-8508-43228dfea485" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "ownershipPercentage": 75
  }'

​
Example Response

{
  "success": true,
  "message": "Related person updated successfully",
  "data": {
    "id": "a3d4f21e-f499-488f-8508-43228dfea485",
    "firstName": "Jane",
    "lastName": "Doe",
    "ownershipPercentage": 75
  }
}

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

​
personId
string<uuid>
required

Related person identifier

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 updated successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Related person updated successfully"

​
data
object