Application enrichment

Application enrichment in Prime's platform allows an existing Application to be updated with additional business information, applicant-related data and people linked to the business. The Partner can chose when this enrichment occurs and in what order, for optimal user experience needs. The Partner may use this process after creating an Application to add or update the required information before the Application moves to underwriting.

Prime API handles enrichment through a single endpoint that accepts new Application data while preserving system-generated information like banking connections and document statuses. The enrichment process validates all updates against the Application's current state to ensure data integrity, and performs background tasks as more data is being added, all done with transparency to the Partner. The Application is enriched from both a Partner and Prime.

Each Application update creates a new version of the Application data, while maintaining the Application history in an immutable log. Partners may track the Application's progress through various stages by checking the status and metadata checklist in Prime API after each enrichment operation.

Important to know : Some fields become read-only after certain stages (e.g. business information after underwriting). the Application record may also be locked entirely after or during a certain stage (e.g. KYC/KYB screening, or after Loan Issuing).

Code sample

import requests
import json

def enrich_application(auth_token, application_id, business_data):
    """
    Updates an existing application with new business information
    """
    headers = {
        "Authorization": f"Bearer {auth_token}",
        "Content-Type": "application/json"
    }

    payload = {
        "business_info": {
            "legal_name": business_data["legal_name"],
            "ein": business_data["tax_id"],
            "addresses": business_data["address"],
            "website": business_data["website"],
          	"people": business_data["business_persons"]
        }
    }

    # update the latest version of the Application with the new data
    response = requests.put(
        f"https://api.primeft.com/v1/applications/{application_id}",
        headers=headers,
        json=payload
    )  

    if response.status_code == 200:
        return response.json()