Base URLs

📘
Quick Reference
LendFoundry uses a microservice architecture where each service has its own base URL. This document provides a complete reference for all available endpoints and how to construct API URLs.

LendFoundry APIs are organized into two main systems: the Loan Origination System (LOS) and the Loan Management System (LMS). Each system consists of multiple microservices, each with its own base URL. Understanding these base URLs is essential for making API requests.

Overview

LendFoundry uses a microservice architecture where functionality is distributed across specialized services. Each microservice:

Has its own base URL
Handles specific business functions
Requires authentication via Bearer tokens
Uses environment-specific URLs (demo vs. production)

URL Structure

All API endpoints follow this pattern:

{base_url}/{microservice}/{endpoint_path}

Example:

https://api.demo.lms.lendfoundry.com/v1/loan-management/loans/LN-2024-001

Where:

https://api.demo.lms.lendfoundry.com/v1 = Base URL
loan-management = Microservice path
loans/LN-2024-001 = Endpoint path

LMS Microservices

The Loan Management System (LMS) provides loan servicing capabilities through the following microservices:

Microservice	Base URL	Purpose
Application Processor	`https://api.demo.lms.lendfoundry.com/v1/lms-application-processor`	Loan onboarding from LOS, related applications
Loan Management	`https://api.demo.lms.lendfoundry.com/v1/loan-management`	Core loan operations, bank details, loan lifecycle
Payment Processor	`https://api.demo.lms.lendfoundry.com/v1/payment-processor`	Payment processing, payment schedules
Loan Filters	`https://api.demo.lms.lendfoundry.com/v1/loan-filters`	Search and filtering operations
Business Applicant Global	`https://api.demo.lms.lendfoundry.com/v1/business-applicant-global`	Business and applicant data management
Call Management	`https://api.demo.lms.lendfoundry.com/v1/call-management`	Communication tracking and call logs
Draw Down Filters	`https://api.demo.lms.lendfoundry.com/v1/business-draw-down-filters`	Line of Credit (LOC) draw validation and filtering
Loan Accounting	`https://api.demo.lms.lendfoundry.com/v1/loan-accounting`	Financial transactions and accounting operations
Draw Processor	`https://api.demo.lms.lendfoundry.com/v1/business-draw-down-processor-global`	LOC draw processing and execution

LMS Base URL

All LMS microservices share a common base URL:

https://api.demo.lms.lendfoundry.com/v1

LOS APIs

The Loan Origination System (LOS) provides three portal APIs, each serving different user types:

API	Base URL	Purpose
Back Office	`https://loc.demo.kendra.lendfoundry.com/v1/darbaan/back-office/rest/api`	Internal operations, application management, verification workflows
Borrower Portal	`https://loc.demo.kendra.lendfoundry.com/v1/darbaan/borrower/rest/api`	Customer-facing operations, borrower self-service
Affiliate	`https://loc.demo.kendra.lendfoundry.com/v1/darbaan/affiliate/rest/api`	Partner integrations, affiliate portal operations

LOS Base URL

All LOS APIs share a common base URL:

https://loc.demo.kendra.lendfoundry.com/v1/darbaan

Portal Selection

Choose the appropriate portal based on your use case:

Back Office: For internal staff operations, application management, and verification workflows
Borrower Portal: For customer-facing applications and borrower self-service features
Affiliate: For partner organizations and affiliate integrations

📘
Note
All three LOS portals use the same endpoint paths, but access different data based on the portal's permissions and context.

Environments

LendFoundry provides different environments for development, testing, and production use:

Demo Environment

The demo environment is available for development and testing purposes:

System	Demo Base URL
LMS	`https://api.demo.lms.lendfoundry.com/v1`
LOS	`https://loc.demo.kendra.lendfoundry.com/v1`

⚠️
Warning
The demo environment is for testing only. Do not use demo URLs in production applications.

Production Environment

For production access, contact your LendFoundry account representative to obtain:

Production base URLs
Production API credentials
Environment-specific configuration details

📘
Note
Production URLs follow a similar pattern but use different domain names. Contact LendFoundry support for your production environment URLs.

URL Construction Examples

LMS Example: Retrieve Loan Information

Full URL:

https://api.demo.lms.lendfoundry.com/v1/loan-management/loans/LN-2024-001

Breakdown:

Base URL: https://api.demo.lms.lendfoundry.com/v1
Microservice: loan-management
Endpoint: loans/LN-2024-001

LOS Example: Get Application Status

Full URL:

https://loc.demo.kendra.lendfoundry.com/v1/darbaan/back-office/rest/api/applications/APP-2024-001/status

Breakdown:

Base URL: https://loc.demo.kendra.lendfoundry.com/v1
Portal Path: darbaan/back-office/rest/api
Endpoint: applications/APP-2024-001/status

Configuration Examples

The following examples show how to configure base URLs in your application using environment variables and configuration files.

Environment Variables (Bash/Shell)

# LMS Base URLs
export LF_LMS_BASE_URL="https://api.demo.lms.lendfoundry.com/v1"
export LF_LMS_APP_PROCESSOR="${LF_LMS_BASE_URL}/lms-application-processor"
export LF_LMS_LOAN_MGMT="${LF_LMS_BASE_URL}/loan-management"
export LF_LMS_PAYMENT="${LF_LMS_BASE_URL}/payment-processor"
export LF_LMS_LOAN_FILTERS="${LF_LMS_BASE_URL}/loan-filters"
export LF_LMS_BUSINESS_APPLICANT="${LF_LMS_BASE_URL}/business-applicant-global"
export LF_LMS_CALL_MGMT="${LF_LMS_BASE_URL}/call-management"
export LF_LMS_DRAW_FILTERS="${LF_LMS_BASE_URL}/business-draw-down-filters"
export LF_LMS_LOAN_ACCOUNTING="${LF_LMS_BASE_URL}/loan-accounting"
export LF_LMS_DRAW_PROCESSOR="${LF_LMS_BASE_URL}/business-draw-down-processor-global"

# LOS Base URLs
export LF_LOS_BASE_URL="https://loc.demo.kendra.lendfoundry.com/v1/darbaan"
export LF_LOS_BACKOFFICE="${LF_LOS_BASE_URL}/back-office/rest/api"
export LF_LOS_BORROWER="${LF_LOS_BASE_URL}/borrower/rest/api"
export LF_LOS_AFFILIATE="${LF_LOS_BASE_URL}/affiliate/rest/api"

// config.js
const config = {
  lms: {
    baseUrl: 'https://api.demo.lms.lendfoundry.com/v1',
    services: {
      applicationProcessor: '/lms-application-processor',
      loanManagement: '/loan-management',
      paymentProcessor: '/payment-processor',
      loanFilters: '/loan-filters',
      businessApplicant: '/business-applicant-global',
      callManagement: '/call-management',
      drawFilters: '/business-draw-down-filters',
      loanAccounting: '/loan-accounting',
      drawProcessor: '/business-draw-down-processor-global'
    }
  },
  los: {
    baseUrl: 'https://loc.demo.kendra.lendfoundry.com/v1/darbaan',
    apis: {
      backOffice: '/back-office/rest/api',
      borrower: '/borrower/rest/api',
      affiliate: '/affiliate/rest/api'
    }
  }
};

// Usage example
const loanManagementUrl = `${config.lms.baseUrl}${config.lms.services.loanManagement}/loans/LN-2024-001`;

# config.py
class LendFoundryConfig:
    # LMS Base URL
    LMS_BASE_URL = "https://api.demo.lms.lendfoundry.com/v1"
    
    # LMS Microservices
    LMS_APP_PROCESSOR = f"{LMS_BASE_URL}/lms-application-processor"
    LMS_LOAN_MANAGEMENT = f"{LMS_BASE_URL}/loan-management"
    LMS_PAYMENT_PROCESSOR = f"{LMS_BASE_URL}/payment-processor"
    LMS_LOAN_FILTERS = f"{LMS_BASE_URL}/loan-filters"
    LMS_BUSINESS_APPLICANT = f"{LMS_BASE_URL}/business-applicant-global"
    LMS_CALL_MANAGEMENT = f"{LMS_BASE_URL}/call-management"
    LMS_DRAW_FILTERS = f"{LMS_BASE_URL}/business-draw-down-filters"
    LMS_LOAN_ACCOUNTING = f"{LMS_BASE_URL}/loan-accounting"
    LMS_DRAW_PROCESSOR = f"{LMS_BASE_URL}/business-draw-down-processor-global"
    
    # LOS Base URL
    LOS_BASE_URL = "https://loc.demo.kendra.lendfoundry.com/v1/darbaan"
    
    # LOS APIs
    LOS_BACK_OFFICE = f"{LOS_BASE_URL}/back-office/rest/api"
    LOS_BORROWER = f"{LOS_BASE_URL}/borrower/rest/api"
    LOS_AFFILIATE = f"{LOS_BASE_URL}/affiliate/rest/api"

# Usage example
from config import LendFoundryConfig
loan_url = f"{LendFoundryConfig.LMS_LOAN_MANAGEMENT}/loans/LN-2024-001"

// LendFoundryConfig.java
public class LendFoundryConfig {
    // LMS Base URL
    private static final String LMS_BASE_URL = "https://api.demo.lms.lendfoundry.com/v1";
    
    // LMS Microservices
    public static final String LMS_APP_PROCESSOR = LMS_BASE_URL + "/lms-application-processor";
    public static final String LMS_LOAN_MANAGEMENT = LMS_BASE_URL + "/loan-management";
    public static final String LMS_PAYMENT_PROCESSOR = LMS_BASE_URL + "/payment-processor";
    public static final String LMS_LOAN_FILTERS = LMS_BASE_URL + "/loan-filters";
    public static final String LMS_BUSINESS_APPLICANT = LMS_BASE_URL + "/business-applicant-global";
    public static final String LMS_CALL_MANAGEMENT = LMS_BASE_URL + "/call-management";
    public static final String LMS_DRAW_FILTERS = LMS_BASE_URL + "/business-draw-down-filters";
    public static final String LMS_LOAN_ACCOUNTING = LMS_BASE_URL + "/loan-accounting";
    public static final String LMS_DRAW_PROCESSOR = LMS_BASE_URL + "/business-draw-down-processor-global";
    
    // LOS Base URL
    private static final String LOS_BASE_URL = "https://loc.demo.kendra.lendfoundry.com/v1/darbaan";
    
    // LOS APIs
    public static final String LOS_BACK_OFFICE = LOS_BASE_URL + "/back-office/rest/api";
    public static final String LOS_BORROWER = LOS_BASE_URL + "/borrower/rest/api";
    public static final String LOS_AFFILIATE = LOS_BASE_URL + "/affiliate/rest/api";
}

// Usage example
String loanUrl = LendFoundryConfig.LMS_LOAN_MANAGEMENT + "/loans/LN-2024-001";

Quick Reference

LMS Microservices Summary

Microservice	Path	Common Use Cases
Application Processor	`/lms-application-processor`	Onboard loans from LOS, retrieve loan by application number
Loan Management	`/loan-management`	Get loan details, update loan information, manage bank details
Payment Processor	`/payment-processor`	Process payments, view payment schedules, payment history
Loan Filters	`/loan-filters`	Search loans, filter by criteria, advanced queries
Business Applicant	`/business-applicant-global`	Manage borrower and business information
Call Management	`/call-management`	Track communications, log calls, manage interactions
Draw Filters	`/business-draw-down-filters`	Validate LOC draws, filter draw requests
Loan Accounting	`/loan-accounting`	Financial transactions, accounting entries, balances
Draw Processor	`/business-draw-down-processor-global`	Process LOC draws, execute draw requests

LOS Portal APIs Summary

Portal	Path	Common Use Cases
Back Office	`/back-office/rest/api`	Submit applications, manage verifications, internal workflows
Borrower	`/borrower/rest/api`	Borrower self-service, application submission, document upload
Affiliate	`/affiliate/rest/api`	Partner integrations, affiliate portal operations

Next Steps

Resource	Description
Authentication Guide	Learn how to authenticate API requests
Quickstart Guide	Get started with your first API calls
Response Codes	Understand API response codes and error handling
API Reference	Complete API endpoint reference

✅
Ready to Make API Calls?
Now that you understand the base URLs, head to the Quickstart Guide to make your first authenticated API request.