The Credit API is a separate product from the Investments API. It is for lending against portfolios held on GetEquity, not for distributing investments. You can integrate it on its own.
Who this is for
You are a credit provider — a lender, a BNPL provider, a bank — and you want to extend credit to people who already hold investments on GetEquity. You integrate as the creditor. The borrower is an existing GetEquity user who pledges their portfolio as collateral; you assess them, issue the loan, and collect repayment. GetEquity locks and releases the collateral on your behalf.How it works
1
Agree your terms
Get Loan Configuration returns the configuration set up for your organisation — the loan-to-value ratio, interest and tenor you lend at.
2
Assess the borrower
Get User by ID returns their personal details and verification status. Get User Investments returns the portfolio you would be lending against — equity, SAFE, debt and fixed-interest positions with their current value.
3
Issue the loan
Create Loan issues it. The loan amount is calculated automatically from the collateral value against your configuration, and the collateral is locked at this point.
4
Service it
Get Loans by Creditor lists your whole book; Get Loan by ID fetches one. Repay Loan processes a repayment and releases collateral as the balance clears.
5
Watch your collateral
Set a price alert threshold and receive an email and
token.price_changed when a token you lend against moves by that much. Each alert carries the cover of every loan holding the token. Token responses also carry price_change over 1, 7 and 30 days.6
Liquidate a loan in breach
When a loan is overdue, or its collateral is worth less than 110% of what is owed, Get Liquidation Quote shows the split and Liquidate Loan carries it out. The collateral covering the debt moves to your wallet and is listed for sale, and the rest goes back to the borrower.
7
Reconcile
Listen for the
loan.created, loan.repaid, loan.liquidated and token.price_changed webhook events rather than polling.Key endpoints
- Get Loan Configuration: View the lending configuration for your organisation
- Get User by ID: Retrieve borrower details including personal information and verification status
- Get User Investments: Fetch a borrower’s portfolio — equity, SAFE, debt and fixed-interest positions, with current value
- Create Loan: Issue a new loan against matched configuration
- Get Loans by Creditor: Monitor every loan you have issued
- Get Loan by ID: Fetch a single loan by its id
- Repay Loan: Process a repayment by loan ID and amount
- Get Liquidation Quote: See a loan’s cover and whether it can be liquidated
- Liquidate Loan: Take the collateral covering a loan in breach and list it for sale
-
Get / Update Price Alerts: Set the price move that sends
token.price_changed
Collateral is handled for you
Loan amounts are calculated from collateral value against your configuration, and collateral is locked on issue and released on repayment. You do not manage the pledge yourself.
