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": "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",
    "website": "https://betalogistics.com"
  },
  "business_address": {
    "street": "77 Commerce Ave",
    "city": "Wilmington",
    "state": "DE",
    "postalCode": "19801",
    "country": "US"
  },
  "contact_info": {
    "email": "ops@betalogistics.com",
    "phone": "+13025550123"
  }
}
'

import requests

url = "https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business"

payload = {
    "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",
        "website": "https://betalogistics.com"
    },
    "business_address": {
        "street": "77 Commerce Ave",
        "city": "Wilmington",
        "state": "DE",
        "postalCode": "19801",
        "country": "US"
    },
    "contact_info": {
        "email": "ops@betalogistics.com",
        "phone": "+13025550123"
    }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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',
      website: 'https://betalogistics.com'
    },
    business_address: {
      street: '77 Commerce Ave',
      city: 'Wilmington',
      state: 'DE',
      postalCode: '19801',
      country: 'US'
    },
    contact_info: {email: 'ops@betalogistics.com', phone: '+13025550123'}
  })
};

fetch('https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    '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',
        'website' => 'https://betalogistics.com'
    ],
    'business_address' => [
        'street' => '77 Commerce Ave',
        'city' => 'Wilmington',
        'state' => 'DE',
        'postalCode' => '19801',
        'country' => 'US'
    ],
    'contact_info' => [
        'email' => 'ops@betalogistics.com',
        'phone' => '+13025550123'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business"

	payload := strings.NewReader("{\n  \"business_info\": {\n    \"legalName\": \"Beta Logistics LLC\",\n    \"businessType\": \"Limited Liability Company\",\n    \"incorporationDate\": \"2020-03-01\",\n    \"incorporationCountry\": \"US\",\n    \"registrationNumber\": \"LLC-123987\",\n    \"taxId\": \"98-7654321\",\n    \"description\": \"Freight and logistics services across West Africa\",\n    \"monthlyVolume\": \"100000\",\n    \"annualRevenue\": \"1200000\",\n    \"primaryFundingSource\": \"Business Revenue\",\n    \"website\": \"https://betalogistics.com\"\n  },\n  \"business_address\": {\n    \"street\": \"77 Commerce Ave\",\n    \"city\": \"Wilmington\",\n    \"state\": \"DE\",\n    \"postalCode\": \"19801\",\n    \"country\": \"US\"\n  },\n  \"contact_info\": {\n    \"email\": \"ops@betalogistics.com\",\n    \"phone\": \"+13025550123\"\n  }\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"business_info\": {\n    \"legalName\": \"Beta Logistics LLC\",\n    \"businessType\": \"Limited Liability Company\",\n    \"incorporationDate\": \"2020-03-01\",\n    \"incorporationCountry\": \"US\",\n    \"registrationNumber\": \"LLC-123987\",\n    \"taxId\": \"98-7654321\",\n    \"description\": \"Freight and logistics services across West Africa\",\n    \"monthlyVolume\": \"100000\",\n    \"annualRevenue\": \"1200000\",\n    \"primaryFundingSource\": \"Business Revenue\",\n    \"website\": \"https://betalogistics.com\"\n  },\n  \"business_address\": {\n    \"street\": \"77 Commerce Ave\",\n    \"city\": \"Wilmington\",\n    \"state\": \"DE\",\n    \"postalCode\": \"19801\",\n    \"country\": \"US\"\n  },\n  \"contact_info\": {\n    \"email\": \"ops@betalogistics.com\",\n    \"phone\": \"+13025550123\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"business_info\": {\n    \"legalName\": \"Beta Logistics LLC\",\n    \"businessType\": \"Limited Liability Company\",\n    \"incorporationDate\": \"2020-03-01\",\n    \"incorporationCountry\": \"US\",\n    \"registrationNumber\": \"LLC-123987\",\n    \"taxId\": \"98-7654321\",\n    \"description\": \"Freight and logistics services across West Africa\",\n    \"monthlyVolume\": \"100000\",\n    \"annualRevenue\": \"1200000\",\n    \"primaryFundingSource\": \"Business Revenue\",\n    \"website\": \"https://betalogistics.com\"\n  },\n  \"business_address\": {\n    \"street\": \"77 Commerce Ave\",\n    \"city\": \"Wilmington\",\n    \"state\": \"DE\",\n    \"postalCode\": \"19801\",\n    \"country\": \"US\"\n  },\n  \"contact_info\": {\n    \"email\": \"ops@betalogistics.com\",\n    \"phone\": \"+13025550123\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "status": 200,
  "message": "Application updated successfully",
  "success": true,
  "data": {
    "application": {
      "id": "fbb45236-881a-4c58-8954-22759499eab4",
      "invite_id": "eec3cbed-79d8-4370-87a0-b6be9e287337",
      "entity_type": "business",
      "status": "draft",
      "current_step": 1,
      "is_complete": false,
      "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",
        "website": "https://betalogistics.com"
      },
      "business_address": {
        "street": "77 Commerce Ave",
        "city": "Wilmington",
        "state": "DE",
        "postalCode": "19801",
        "country": "US"
      },
      "contact_info": {
        "email": "ops@betalogistics.com",
        "phone": "+13025550123"
      },
      "banking_info": null,
      "related_persons": [],
      "individual_info": null,
      "change_request_note": null,
      "flagged_fields": [],
      "created_at": "2026-06-12T23:28:05.373Z",
      "updated_at": "2026-06-13T08:41:19.402Z"
    },
    "documents": []
  }
}

{
  "status": 400,
  "message": "Application is submitted and can no longer be edited"
}

{
  "status": 400,
  "message": "Validation failed",
  "code": "ACCOUNT_RESTRICTED",
  "errors": [
    {
      "path": [
        "amount"
      ],
      "message": "amount must be a whole number of smallest currency units (e.g. cents)"
    }
  ]
}

{
  "status": 404,
  "message": "Account not found"
}

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": "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",
    "website": "https://betalogistics.com"
  },
  "business_address": {
    "street": "77 Commerce Ave",
    "city": "Wilmington",
    "state": "DE",
    "postalCode": "19801",
    "country": "US"
  },
  "contact_info": {
    "email": "ops@betalogistics.com",
    "phone": "+13025550123"
  }
}
'

import requests

url = "https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business"

payload = {
    "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",
        "website": "https://betalogistics.com"
    },
    "business_address": {
        "street": "77 Commerce Ave",
        "city": "Wilmington",
        "state": "DE",
        "postalCode": "19801",
        "country": "US"
    },
    "contact_info": {
        "email": "ops@betalogistics.com",
        "phone": "+13025550123"
    }
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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',
      website: 'https://betalogistics.com'
    },
    business_address: {
      street: '77 Commerce Ave',
      city: 'Wilmington',
      state: 'DE',
      postalCode: '19801',
      country: 'US'
    },
    contact_info: {email: 'ops@betalogistics.com', phone: '+13025550123'}
  })
};

fetch('https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    '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',
        'website' => 'https://betalogistics.com'
    ],
    'business_address' => [
        'street' => '77 Commerce Ave',
        'city' => 'Wilmington',
        'state' => 'DE',
        'postalCode' => '19801',
        'country' => 'US'
    ],
    'contact_info' => [
        'email' => 'ops@betalogistics.com',
        'phone' => '+13025550123'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business"

	payload := strings.NewReader("{\n  \"business_info\": {\n    \"legalName\": \"Beta Logistics LLC\",\n    \"businessType\": \"Limited Liability Company\",\n    \"incorporationDate\": \"2020-03-01\",\n    \"incorporationCountry\": \"US\",\n    \"registrationNumber\": \"LLC-123987\",\n    \"taxId\": \"98-7654321\",\n    \"description\": \"Freight and logistics services across West Africa\",\n    \"monthlyVolume\": \"100000\",\n    \"annualRevenue\": \"1200000\",\n    \"primaryFundingSource\": \"Business Revenue\",\n    \"website\": \"https://betalogistics.com\"\n  },\n  \"business_address\": {\n    \"street\": \"77 Commerce Ave\",\n    \"city\": \"Wilmington\",\n    \"state\": \"DE\",\n    \"postalCode\": \"19801\",\n    \"country\": \"US\"\n  },\n  \"contact_info\": {\n    \"email\": \"ops@betalogistics.com\",\n    \"phone\": \"+13025550123\"\n  }\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"business_info\": {\n    \"legalName\": \"Beta Logistics LLC\",\n    \"businessType\": \"Limited Liability Company\",\n    \"incorporationDate\": \"2020-03-01\",\n    \"incorporationCountry\": \"US\",\n    \"registrationNumber\": \"LLC-123987\",\n    \"taxId\": \"98-7654321\",\n    \"description\": \"Freight and logistics services across West Africa\",\n    \"monthlyVolume\": \"100000\",\n    \"annualRevenue\": \"1200000\",\n    \"primaryFundingSource\": \"Business Revenue\",\n    \"website\": \"https://betalogistics.com\"\n  },\n  \"business_address\": {\n    \"street\": \"77 Commerce Ave\",\n    \"city\": \"Wilmington\",\n    \"state\": \"DE\",\n    \"postalCode\": \"19801\",\n    \"country\": \"US\"\n  },\n  \"contact_info\": {\n    \"email\": \"ops@betalogistics.com\",\n    \"phone\": \"+13025550123\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.rolla.xyz/api/v1/external/accounts/{accountId}/business")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"business_info\": {\n    \"legalName\": \"Beta Logistics LLC\",\n    \"businessType\": \"Limited Liability Company\",\n    \"incorporationDate\": \"2020-03-01\",\n    \"incorporationCountry\": \"US\",\n    \"registrationNumber\": \"LLC-123987\",\n    \"taxId\": \"98-7654321\",\n    \"description\": \"Freight and logistics services across West Africa\",\n    \"monthlyVolume\": \"100000\",\n    \"annualRevenue\": \"1200000\",\n    \"primaryFundingSource\": \"Business Revenue\",\n    \"website\": \"https://betalogistics.com\"\n  },\n  \"business_address\": {\n    \"street\": \"77 Commerce Ave\",\n    \"city\": \"Wilmington\",\n    \"state\": \"DE\",\n    \"postalCode\": \"19801\",\n    \"country\": \"US\"\n  },\n  \"contact_info\": {\n    \"email\": \"ops@betalogistics.com\",\n    \"phone\": \"+13025550123\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "status": 200,
  "message": "Application updated successfully",
  "success": true,
  "data": {
    "application": {
      "id": "fbb45236-881a-4c58-8954-22759499eab4",
      "invite_id": "eec3cbed-79d8-4370-87a0-b6be9e287337",
      "entity_type": "business",
      "status": "draft",
      "current_step": 1,
      "is_complete": false,
      "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",
        "website": "https://betalogistics.com"
      },
      "business_address": {
        "street": "77 Commerce Ave",
        "city": "Wilmington",
        "state": "DE",
        "postalCode": "19801",
        "country": "US"
      },
      "contact_info": {
        "email": "ops@betalogistics.com",
        "phone": "+13025550123"
      },
      "banking_info": null,
      "related_persons": [],
      "individual_info": null,
      "change_request_note": null,
      "flagged_fields": [],
      "created_at": "2026-06-12T23:28:05.373Z",
      "updated_at": "2026-06-13T08:41:19.402Z"
    },
    "documents": []
  }
}

{
  "status": 400,
  "message": "Application is submitted and can no longer be edited"
}

{
  "status": 400,
  "message": "Validation failed",
  "code": "ACCOUNT_RESTRICTED",
  "errors": [
    {
      "path": [
        "amount"
      ],
      "message": "amount must be a whole number of smallest currency units (e.g. cents)"
    }
  ]
}

{
  "status": 404,
  "message": "Account not found"
}

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.

Mandatory and optional fields

No individual field is mandatory in this request. Every section is merged into the stored application, so a call carrying one field is as valid as a call carrying all of them — that is what lets you save progress as your customer fills your form. The only rule is that at least one section must be present.Mandatory below means required before the application can be submitted. Nothing here is enforced until you call Submit Application.

`business_info`

Field		Notes
`legalName`	Mandatory	The registered legal name
`businessType`	Mandatory	e.g. `Limited Liability Company`
`incorporationDate`	Mandatory	`YYYY-MM-DD`
`incorporationCountry`	Mandatory	Accepts an ISO-2 code, a country name or a demonym; stored as the ISO-2 code
`registrationNumber`	Mandatory	Company registration number
`taxId`	Mandatory	Tax identification or business-licence number
`description`	Mandatory	10–1000 characters
`monthlyVolume`	Mandatory	Numeric string greater than 0, decimals allowed, e.g. `"100000"`
`annualRevenue`	Mandatory	Numeric string greater than 0, decimals allowed, e.g. `"1200000"`
`primaryFundingSource`	Mandatory	e.g. `Business Revenue`
`website`	Mandatory	Valid URL, including the scheme
`tradingName`	Optional	The name the business trades under, when it differs from the legal name. We use the legal name when it is absent

`business_address`

Field		Notes
`street`	Mandatory
`city`	Mandatory
`state`	Mandatory	State, province or region
`postalCode`	Mandatory
`country`	Mandatory	Accepts an ISO-2 code (`US`), a country name (`United States`) or a demonym; stored as the ISO-2 code

`contact_info`

Field		Notes
`email`	Mandatory
`phone`	Mandatory	International format, e.g. `+13025550123`

`banking_info`

Optional in full. Send it only if you hold the customer’s existing bank details; it is not part of the submit gate. bankName, accountNumber, routingNumber, accountType (checking or savings), currency.

Documents

All six are mandatory before submission, uploaded via Upload Document: certificate_of_incorporation, articles_of_association, proof_of_address, director_register, shareholder_register, bank_statement.

Get Requirements is the live answer to “what is still outstanding” — its missingFields and missingDocuments arrays name exactly what is blocking submission, so you never have to reconcile this table by hand.

Every beneficial owner / director must complete identity verification (Sumsub GREEN) before the application can be submitted. Add them via Add Related Person and send each their KYC link.

taxId — for a business, use the company’s tax identification / business-license (registration) number.

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",
      "website": "https://betalogistics.com"
    },
    "business_address": {
      "street": "77 Commerce Ave",
      "city": "Wilmington",
      "state": "DE",
      "postalCode": "19801",
      "country": "US"
    },
    "contact_info": {
      "email": "ops@betalogistics.com",
      "phone": "+13025550123"
    }
  }'

Example Response

{
  "status": 200,
  "message": "Application updated successfully",
  "success": true,
  "data": {
    "application": {
      "id": "fbb45236-881a-4c58-8954-22759499eab4",
      "invite_id": "eec3cbed-79d8-4370-87a0-b6be9e287337",
      "entity_type": "business",
      "status": "draft",
      "current_step": 1,
      "is_complete": false,
      "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",
        "website": "https://betalogistics.com"
      },
      "business_address": {
        "street": "77 Commerce Ave",
        "city": "Wilmington",
        "state": "DE",
        "postalCode": "19801",
        "country": "US"
      },
      "contact_info": {
        "email": "ops@betalogistics.com",
        "phone": "+13025550123"
      },
      "banking_info": null,
      "related_persons": [],
      "individual_info": null,
      "change_request_note": null,
      "flagged_fields": [],
      "created_at": "2026-06-12T23:28:05.373Z",
      "updated_at": "2026-06-13T08:41:19.402Z"
    },
    "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

At least one section must be present. Every section you send is merged into the stored application, field by field, so you can save progress across calls.

business_info

object

Business details of a KYB application. No field is required by the request itself — the section is merged into the stored application — but every field except tradingName must be present before the application can be submitted.

Show child attributes

business_address

object

Registered address. All five fields are required before the application can be submitted.

Show child attributes

contact_info

object

Contact details for the application. Both fields are required before submission.

Show child attributes

banking_info

object

The customer's existing bank details. Entirely optional — it is not part of the submit gate.

Show child attributes

Response

Application updated successfully

status

integer

required

Example:

200

message

string

required

Example:

"Application updated successfully"

success

boolean

required

Example:

true

data

object

required

Show child attributes

Getting Started

Wallets

Deposits & Virtual Accounts

Banks & Account Lookup

Beneficiaries

Payouts & Transfers

Payer Names (Named Payouts)

FX & Swaps

Transactions & Statements

Webhooks

Account Onboarding (Platform)

Teams

Update Business Details

Mandatory and optional fields

`business_info`

`business_address`

`contact_info`

`banking_info`

Documents

Example Request

Example Response

Key Behaviours

Authorizations

Path Parameters

Body

Response

​Mandatory and optional fields

​business_info

​business_address

​contact_info

​banking_info

​Documents

​Example Request

​Example Response

​Key Behaviours

Authorizations

Path Parameters

Body

Response

Mandatory and optional fields

`business_info`

`business_address`

`contact_info`

`banking_info`

Documents

Example Request

Example Response

Key Behaviours