Skip to main content
PUT
/
accounts
/
{accountId}
/
individual
Update Individual Details
curl --request PUT \
  --url https://api.rolla.xyz/api/v1/external/accounts/{accountId}/individual \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "individualInfo": {
    "firstName": "<string>",
    "lastName": "<string>",
    "email": "jsmith@example.com",
    "phone": "+2348012345678",
    "dateOfBirth": "1990-05-14",
    "citizenship": "NG",
    "countryOfResidence": "<string>",
    "taxId": "<string>",
    "nin": "<string>",
    "bvn": "<string>",
    "ssn": "<string>",
    "sin": "<string>",
    "nationalId": "<string>",
    "address": {
      "street": "123 Main Street",
      "city": "Lagos",
      "state": "Lagos",
      "postalCode": "100001",
      "country": "NG"
    },
    "employment": {
      "employerName": "<string>",
      "sourceOfWealthDescription": "<string>"
    }
  }
}
'
{
  "success": true,
  "message": "Application updated successfully",
  "data": {
    "application": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "current_step": 123,
      "is_complete": true,
      "business_info": {
        "legalName": "Acme Corp Ltd",
        "tradingName": "<string>",
        "businessType": "Limited Company",
        "incorporationDate": "2020-01-15",
        "incorporationCountry": "NG",
        "registrationNumber": "RC-1234567",
        "taxId": "12345678-0001",
        "website": "<string>",
        "description": "<string>",
        "monthlyVolume": "<string>",
        "annualRevenue": "<string>",
        "primaryFundingSource": "<string>"
      },
      "business_address": {
        "street": "123 Main Street",
        "city": "Lagos",
        "state": "Lagos",
        "postalCode": "100001",
        "country": "NG"
      },
      "contact_info": {
        "email": "contact@acmecorp.com",
        "phone": "+2341234567890"
      },
      "related_persons": [
        {
          "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>"
        }
      ],
      "banking_info": {
        "bankName": "<string>",
        "accountNumber": "<string>",
        "routingNumber": "<string>",
        "currency": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    },
    "documents": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "applicationId": "<string>",
        "fileName": "<string>",
        "fileUrl": "<string>",
        "relatedPersonKey": "<string>",
        "created_at": "2023-11-07T05:31:56Z"
      }
    ]
  }
}
Updates the KYC application of an individual account. Fields inside individualInfo are merged into the stored application, so you can collect personal details, address and employment information across multiple calls.

​
Example Request

curl -X PUT "https://api.rolla.xyz/api/v1/external/accounts/b6075be0-f1d0-451f-a468-3e94563101d2/individual" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "individualInfo": {
      "phone": "+2348012345678",
      "dateOfBirth": "1990-05-14",
      "citizenship": "NG",
      "nin": "12345678901",
      "bvn": "22212345678",
      "address": {
        "street": "12 Marina Rd",
        "city": "Lagos",
        "state": "Lagos",
        "postalCode": "101241",
        "country": "NG"
      },
      "employment": {
        "status": "self-employed",
        "employerName": "Acme Trading Ltd",
        "sourceOfWealth": "business_income",
        "annualIncome": "50k-100k"
      }
    }
  }'

​
Example Response

{
  "success": true,
  "message": "Application updated successfully",
  "data": {
    "application": {
      "id": "f436daf8-146b-4949-bf28-9b36440085a4",
      "status": "draft",
      "entity_type": "individual",
      "individual_info": {
        "firstName": "Jane",
        "lastName": "Doe",
        "phone": "+2348012345678",
        "citizenship": "NG"
      }
    },
    "documents": []
  }
}

​
Country-Specific Identifiers

CountryFields
Nigerianin (11 digits), bvn (11 digits)
United Statesssn
Canadasin
OthernationalId
Applications can no longer be edited once their status is submitted or approved.

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
​
individualInfo
object
required

Personal, address and employment details for an individual account. All fields are optional per request; provided fields are merged into the stored application.

Response

Application updated successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Application updated successfully"

​
data
object