Skip to main content
GET
/
accounts
/
{accountId}
/
related-persons
List Related Persons
curl --request GET \
  --url https://api.rolla.xyz/api/v1/external/accounts/{accountId}/related-persons \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "message": "Related persons retrieved 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>"
    }
  ]
}
Lists the beneficial owners and directors registered on a business account’s application.

​
Example Request

curl -X GET "https://api.rolla.xyz/api/v1/external/accounts/eec3cbed-79d8-4370-87a0-b6be9e287337/related-persons" \
  -H "X-API-Key: your_api_key_here"

​
Example Response

{
  "success": true,
  "message": "Related persons retrieved successfully",
  "data": [
    {
      "id": "a3d4f21e-f499-488f-8508-43228dfea485",
      "firstName": "Jane",
      "lastName": "Doe",
      "roles": ["Beneficial Owner", "Director"],
      "email": "jane@betalogistics.com",
      "ownershipPercentage": 60
    }
  ]
}
Use Get Requirements to see each person’s identity verification status alongside the rest of the submission checklist.

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

Response

Related persons retrieved successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Related persons retrieved successfully"

​
data
object[]