Lender Directory

Overview

The lender directory is a global resource, not scoped to your account. It works like the directory search in the Lev web app: you get the lenders that best match your search, not the whole directory.

How directory search works:

• Top matches only. When fewer than 25 lenders match, you get every match. When 25 or more match, you get the top 20. The limit parameter (1 to 25, default 25) can only lower that count, and values outside that range are clamped.
• No paging or sorting. A non-empty cursor or sort, or an offset greater than 0, returns 400. If the lender you want isn't in the results, narrow the search with name, filter[state], or filter[lender_type].
• Ranking. With name, results come back best match first. Matching is case-insensitive and catches partial names and close spellings. Without name, results are alphabetical.
• Filters. Only filter[state] and filter[lender_type] are supported, and only with eq. Any other filter field returns 400. See Lender Types for the values filter[lender_type] accepts.
• Actively lending lenders only. Both endpoints leave out lenders that aren't currently lending, so Get Lender returns 404 for them.
• Pagination block. List responses always use the offset shape. total is the full match count, offset is always 0, and has_more is true when more lenders match than were returned.

Both endpoints also have a daily request cap per account, 30 directory requests and 100 lender detail requests by default. Every request counts, including ones rejected with 400, 404, or 422. Past the cap they return 429. See Rate Limits.

Lender program data is not available from the lender directory endpoints. To match lenders to a deal and see their relevant programs, use Lev's AI lender match through the MCP tools or in the product (Add Lenders to a Deal).

List Lenders

curl -X GET "https://api.lev.com/api/external/v2/lenders/directory?name=JPMorgan&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "request_id": "f2a3b4c5-d6e7-8901-5678-012345678901",
  "timestamp": "2026-03-20T15:30:45Z",
  "data": [
    {
      "id": 3200,
      "name": "JPMorgan Chase",
      "logo_url": "https://cdn.lev.com/logos/jpmorgan-chase.png",
      "city": "New York",
      "state": "NY",
      "lender_type": ["national_bank"]
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 10,
    "offset": 0,
    "has_more": false
  }
}

Get Lender

{
  "request_id": "a3b4c5d6-e7f8-9012-6789-123456789012",
  "timestamp": "2026-03-20T15:30:45Z",
  "data": {
    "id": 3200,
    "name": "JPMorgan Chase",
    "website": "https://jpmorgan.com",
    "logo_url": "https://cdn.lev.com/logos/jpmorgan-chase.png",
    "square_logo_url": "https://cdn.lev.com/logos/jpmorgan-chase-square.png",
    "address": "383 Madison Avenue",
    "city": "New York",
    "state": "NY",
    "zip": "10179",
    "about": "Leading global financial services firm providing commercial real estate lending across all asset classes.",
    "lender_type": ["national_bank"]
  }
}

Directory Result Object

Each row that List Lenders returns.

Lender Object

The profile that Get Lender returns.

Lender Types

lender_type values, as they appear in responses and as filter[lender_type] accepts them:

Two values are grouped when you filter. debt_fund also matches its small balance, middle market, and large loan subtypes, and credit_union also matches credit union service organizations. Every other value matches only itself, so filtering by bank doesn't return lenders typed only as national_bank.