Skip to main content
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

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
business_info
object
business_address
object
contact_info
object
banking_info
object

Response

Application updated successfully

success
boolean
Example:

true

message
string
Example:

"Application updated successfully"

data
object