Skip to main content
PUT
/
kyb
Update KYB Application
curl --request PUT \
  --url https://api.rolla.xyz/api/v1/external/kyb \
  --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"
  },
  "related_persons": [
    {
      "id": "<string>",
      "firstName": "John",
      "lastName": "Doe",
      "roles": [
        "Beneficial Owner"
      ],
      "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>",
    "accountType": "checking",
    "currency": "<string>"
  },
  "current_step": 2,
  "is_complete": true,
  "status": "draft"
}
'
{
  "success": true,
  "message": "Application updated successfully",
  "data": {
    "application": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "draft",
      "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": [
            "Beneficial Owner"
          ],
          "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>",
        "accountType": "checking",
        "currency": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  }
}
Update an existing KYB application with new information. Use this to complete a draft application step by step or make corrections before submission.

​
Example Request

curl -X PUT "https://api.rolla.xyz/api/v1/external/kyb" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "related_persons": [
      {
        "firstName": "John",
        "lastName": "Doe",
        "roles": ["Director", "Beneficial Owner"],
        "email": "john@acmecorp.com",
        "phone": "+2341234567890",
        "dateOfBirth": "1990-01-15",
        "ownershipPercentage": 60,
        "currentAddress": {
          "street": "456 Oak Avenue",
          "city": "Lagos",
          "state": "Lagos",
          "postalCode": "100001",
          "country": "NG"
        }
      }
    ],
    "banking_info": {
      "bankName": "Access Bank",
      "accountNumber": "0123456789",
      "routingNumber": "000014",
      "accountType": "checking",
      "currency": "NGN"
    },
    "current_step": 4,
    "is_complete": true,
    "status": "submitted"
  }'

​
Example Response

{
  "success": true,
  "message": "Application updated successfully",
  "data": {
    "application": {
      "id": "f6a7b8c9-d0e1-2345-fghi-678901234567",
      "status": "submitted",
      "current_step": 4,
      "is_complete": true,
      "created_at": "2024-01-10T08:00:00.000Z",
      "updated_at": "2024-01-15T14:00:00.000Z"
    }
  }
}
Set status to submitted and is_complete to true when the application is ready for review. Ensure all required sections (business info, address, contact info, related persons, and banking info) are complete before submitting.

Authorizations

​
X-API-Key
string
header
required

Your Rolla API key

Body

application/json
​
business_info
object
​
business_address
object
​
contact_info
object
​
related_persons
object[]
​
banking_info
object
​
current_step
integer
Required range: x >= 1
​
is_complete
boolean
​
status
enum<string>
Available options:
draft,
submitted,
approved,
rejected,
changes_requested

Response

Application updated successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Application updated successfully"

​
data
object