Update Business Details
curl --request PUT \
--url https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"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"
},
"banking_info": {
"bankName": "<string>",
"accountNumber": "<string>",
"routingNumber": "<string>",
"currency": "<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"
}
]
}
}Account Onboarding
Update Business Details
Updates the business application of a business account. Each provided section is merged into the stored data, so you can save progress incrementally. Applications can no longer be edited once submitted or approved.
PUT
/
accounts
/
{accountId}
/
business
Update Business Details
curl --request PUT \
--url https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"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"
},
"banking_info": {
"bankName": "<string>",
"accountNumber": "<string>",
"routingNumber": "<string>",
"currency": "<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 application of a business account. Each section you send (
business_info, business_address, contact_info, banking_info) is merged into the stored application, so you can save progress incrementally — one section per call or everything at once.
Example Request
curl -X PUT "https://api.rolla.xyz/api/v1/external/accounts/eec3cbed-79d8-4370-87a0-b6be9e287337/business" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"business_info": {
"legalName": "Beta Logistics LLC",
"businessType": "Limited Liability Company",
"incorporationDate": "2020-03-01",
"incorporationCountry": "US",
"registrationNumber": "LLC-123987",
"taxId": "98-7654321",
"description": "Freight and logistics services across West Africa",
"monthlyVolume": "100000",
"annualRevenue": "1200000",
"primaryFundingSource": "Business Revenue"
},
"business_address": {
"street": "77 Commerce Ave",
"city": "Wilmington",
"state": "DE",
"postalCode": "19801",
"country": "US"
},
"contact_info": {
"email": "ops@betalogistics.com",
"phone": "+13025550123"
}
}'
Example Response
{
"success": true,
"message": "Application updated successfully",
"data": {
"application": {
"id": "fbb45236-881a-4c58-8954-22759499eab4",
"status": "draft",
"entity_type": "business",
"business_info": {
"legalName": "Beta Logistics LLC",
"businessType": "Limited Liability Company"
}
},
"documents": []
}
}
Key Behaviours
Sections are merged, not replaced: fields you omit keep their stored values.
Applications can no longer be edited once their status is
submitted or approved. If the review team requests changes, the application becomes editable again.Authorizations
Your Rolla API key
Path Parameters
Identifier of an account owned by the same user as your API key's business
Body
application/json
⌘I