Create Loan Application for Entity

Loans can be issued to business entities — companies, sole traders, partnerships and trusts — as well as to individuals. Entity end users use the same endpoints and workflow as personal end users; the differences are in the data you provide and in the loan agreement generated.

This walkthrough covers the two steps that differ for entities:

Creating the entity sub-account.
Submitting the loan application.

For the general application workflow (calculators, agreements, consent), see the Loan Application Overview.

Step 1 — Create the Entity Sub-Account

Use Create new sub-account with accountType: BUSINESS. For business sub-accounts, the businessDetails object becomes mandatory:

Field	Required	Description
`businessDetails.entityName`	Yes	Legal name of the business entity.
`businessDetails.entityType`	Yes	Type of the entity — see the table below.
`businessDetails.abn`	Yes	Australian Business Number. Must be a valid 11-digit ABN — the checksum is validated and invalid ABNs are rejected.

The personal fields (firstName, lastName, dateOfBirth, gender, email, etc.) are still required and must contain the account owner's details.

{
  "accountType": "BUSINESS",
  "firstName": "Jane",
  "lastName": "Citizen",
  "dateOfBirth": "1980-01-31",
  "gender": "FEMALE",
  "countryCode": "AU",
  "email": "[email protected]",
  "externalId": "123e4567-e89b-12d3-a456-426614174000",
  "businessDetails": {
    "entityName": "Acme Trading Pty Ltd",
    "entityType": "PRIVATE",
    "abn": "51824753556"
  }
}

📘
For accountType: PERSONAL, omit businessDetails entirely.

Entity Types

`entityType`	Meaning
`PRIVATE`	Private company
`TRADER`	Sole trader
`PARTNERSHIP`	Partnership
`UNREGULATED`	Unregulated trust
`TRUST`	Regulated trust
`TRUST_REGISTERED`	Registered managed investment scheme
`TRUST_UNREGISTERED`	Unregistered managed investment scheme
`TRUST_REGULATED`	Trust regulated under a Commonwealth statutory regulator
`TRUST_GOVERNMENT`	Government superannuation fund
`TRUST_FAMILY`	Family trust
`TRUST_CHARITABLE`	Charitable trust
`TRUST_TESTAMENTARY`	Testamentary trust
`TRUST_UNIT`	Unit trust
`TRUST_OTHER`	Other trust types not covered by specific categories

Step 2 — Submit the Loan Application

First retrieve the available offers for the sub-account with Get all loan offers. Loan offers can be configured per account type, so always fetch offers for the specific sub-account to get the correct set for business end users.

Then submit the application with Create a loan application — the same endpoint used for personal applications.

For business applications, the following applicantInfo fields are required:

Field	Description
`loanPurpose`	The intended purpose of the loan funds.
`companyDirectorName`	Name of the company director.
`estimatedTurnover`	Estimated annual turnover of the business.
`totalAssetsOfTheBusiness`	Total assets of the business.
`numberOfStaff`	Number of staff employed by the business.

All other applicantInfo fields are optional for business applications — including repaymentSources and applicantKyc, which apply to PERSONAL applications only.

{
  "externalLoanId": "LOAN-000123",
  "loanOfferId": "0b8bd813-b2f6-4b60-b1b9-0e2b4a1f9c11",
  "applyFor": "FULL_APPROVAL",
  "fundsSupplyStatus": "NOT_SUPPLIED",
  "securityCryptoAmount": 0.5,
  "fiatPrincipalAmount": 20000,
  "fiatWithdrawalBankAccount": {
    "accountName": "Acme Trading Pty Ltd",
    "accountNumber": "12345678",
    "bsb": "062000",
    "country": "AU",
    "fiatCurrency": "AUD"
  },
  "applicantInfo": {
    "loanPurpose": "INVESTMENT",
    "companyDirectorName": "Jane Citizen",
    "estimatedTurnover": 1500000,
    "totalAssetsOfTheBusiness": 800000,
    "numberOfStaff": 12,
    "monthlyIncome": 45000,
    "monthlyExpenses": 30000,
    "address": {
      "buildingNumber": "10",
      "street": "Pitt Street",
      "suburb": "Sydney",
      "state": "NSW",
      "postalCode": "2000",
      "country": "AU"
    }
  }
}

Upload Supporting Documents

Business loan applications require an income statement or Company BAS (Business Activity Statement) to be uploaded for the credit assessment. Use Get Upload Link to obtain a link and POST the document to it. Currently only PDF format is supported.

📘
No credit check for business account
Note that there is no credit check for business account. All credit assessment are Block Earner's internal credit assessment process

Loan Agreement

For business sub-accounts, the generated loan agreement is a commercial loan contract issued to the entity — it references the entity name and ABN provided at sub-account creation — instead of the personal loan contract used for individual borrowers. Use Preview Loan Agreement to display it to the end user before submission, as for personal applications.

After Approval

Loan servicing is identical for both account types: security top-up and withdrawal, cash and security repayments, redraw, rollover, loan closure, reckoning reports and webhook notifications all behave the same way for business and personal sub-accounts.

Step 1 — Create the Entity Sub-Account

For accountType: PERSONAL, omit businessDetails entirely.

Entity Types

Step 2 — Submit the Loan Application

Upload Supporting Documents

No credit check for business account

Loan Agreement

After Approval

For `accountType: PERSONAL`, omit `businessDetails` entirely.