Referrals

ℹ️
Beta feature: Referrals are currently in beta, and are only enabled for specific customers. Get in touch if you'd like referrals enabled for your Akahu Apply account.

How it works

Akahu Apply referrals allow a snapshot of Application data to be shared with another organisation that also uses Akahu Apply.

Referrals are designed to allow brokers, advisers, and introducers to seamlessly refer an Application to lenders without the need for manual processes or duplicate data collection.

Referring an application

A referral can be created for any active Application in your Akahu Apply account.

When a referral is created, a unique referral code will be generated (e.g. AK_A1B2C3D4E5). You can share this referral code with one or more other recipient organisations. Recipients can redeem your referral code via their own Akahu Apply account to access all data resources included in the Application. Each referral code can be redeemed multiple times by multiple recipient organisations. Referral codes expire 30 days after they're created.

When you create a referral, a snapshot is created containing all data and documents included in the Application at that point in time. If data is added or removed from the Application after creating a referral, these changes won't affect the data included in the referral snapshot. If you want to share newly added data or documents, create a new referral and share the updated code with your recipient.

Referral recipients will not receive a copy of your Report. Instead, a new Report is generated for them based on the specific configuration and customisations that have been set up for their Akahu Apply account.

Creating a referral via API

Create an Application and populate it with data. See our Workflows guide for more details.
Create a referral for the application using the POST /v1/applications/{applicationId}/referrals endpoint.
Save the code returned for the referral and share this code with your intended recipient.

Creating a referral using the Akahu Apply portal

🚧
Coming soon: Referrals are currently an API-only feature, and will be available to portal users soon.

Redeeming a referral

When you receive an Akahu Apply referral code from another organisation, you can redeem it into your own Akahu Apply account. You can easily identify an Akahu Apply referral code due to the AK_ prefix followed by 10 uppercase alphanumeric characters.

When you redeem a referral, a new Application will be created in your Akahu Apply account prepopulated with all data resources that were included in the referring organisation's Application at the time your referral code was generated.

Once a referral code has been redeemed, you can interact with the resulting Application as usual: You can generate and view reports (which will include any customisations configured for your organisation), add and remove documents, or send a Sharing Request to collect additional data from the applicant.

You can redeem the same referral code multiple times. Each time you redeem a referral code, a new, independent Application will be created in your Akahu Apply account.

Don't forget to archive Applications once you've finished working with them to avoid unnecessary data retention.

Redeeming a referral via API

Begin the redemption process by submitting a referral code to the POST /v1/referral-redemptions endpoint.
Wait for the redemption process to complete by polling the GET /v1/referral-redemptions/{redemptionId} endpoint. The redemption process will complete within a few seconds.
Once the redemption process has completed successfully (identified by a status of completed), the response will include an Application ID in the _application parameter. This ID refers to a newly created Application that has been prepopulated with the referral data.
Generate a Report for the Application using the POST /v1/applications/{applicationId}/reports endpoint.

Redeeming a referral using the Akahu Apply portal

🚧
Coming soon: Referrals are currently an API-only feature, and will be available to portal users soon.