Lenders

List and retrieve lenders in your network with contacts and performance metrics.

Lenders represent the funding sources in your network. Each lender includes contact information, product counts, and performance metrics.

List Lenders

GET /v1/lenders

Returns a paginated list of lenders in your organization's network.

Query Parameters

Parameter	Type	Default	Description
`page`	integer	`1`	Page number
`limit`	integer	`20`	Items per page (max 100)

Example Request

curl -H "Authorization: Bearer lw_live_xxxx" \
     "https://api.lend.works/v1/lenders?limit=10"

Example Response

{
  "data": [
    {
      "id": "c3d4e5f6-1234-5678-9abc-def012345678",
      "type": "lender",
      "attributes": {
        "name": "First Capital Finance",
        "status": "active",
        "contacts": [
          {
            "name": "Sarah Chen",
            "email": "sarah@firstcapital.com",
            "phone": "555-0200",
            "role": "Account Manager"
          }
        ],
        "productCount": 5,
        "performance": {
          "totalSubmissions": 48,
          "approvalRate": 0.65,
          "avgResponseTime": "2.3 days",
          "totalFunded": "3200000"
        },
        "createdAt": "2024-06-15T08:00:00Z",
        "updatedAt": "2025-01-10T14:30:00Z"
      }
    }
  ],
  "meta": {
    "total": 24,
    "page": 1,
    "limit": 10,
    "hasMore": true,
    "requestId": "f21a31b4-c5d6-4e78-9012-345678901567"
  }
}

Get a Lender

GET /v1/lenders/{id}

Retrieve a single lender with full details including contacts, commission agreements, and master lender association.

Path Parameters

Parameter	Type	Description
`id`	UUID	Lender ID

Example Request

curl -H "Authorization: Bearer lw_live_xxxx" \
     https://api.lend.works/v1/lenders/c3d4e5f6-1234-5678-9abc-def012345678

Example Response

{
  "data": {
    "id": "c3d4e5f6-1234-5678-9abc-def012345678",
    "type": "lender",
    "attributes": {
      "name": "First Capital Finance",
      "status": "active",
      "contacts": [
        {
          "name": "Sarah Chen",
          "email": "sarah@firstcapital.com",
          "phone": "555-0200",
          "role": "Account Manager"
        }
      ],
      "productCount": 5,
      "commissionAgreements": [
        {
          "productType": "Term Loan",
          "rate": "0.02",
          "type": "percentage"
        }
      ],
      "performance": {
        "totalSubmissions": 48,
        "approvalRate": 0.65,
        "avgResponseTime": "2.3 days",
        "totalFunded": "3200000"
      },
      "createdAt": "2024-06-15T08:00:00Z",
      "updatedAt": "2025-01-10T14:30:00Z"
    }
  },
  "meta": {
    "requestId": "a32b42c5-d6e7-4f89-0123-456789012678"
  }
}

Errors

Status	Code	Description
`403`	`FORBIDDEN`	API key lacks read permission
`404`	`NOT_FOUND`	Lender not found

Lenders

On this page