GET /v2/lender-routing/recommend returns the ordered list of ACTIVE lenders most-likely to underwrite a merchant in the given jurisdiction. Used by partner portals, merchant onboarding flows, and MCP agent flows resolving “which lender should this merchant approach.”
This endpoint is public and read-only. It only returns ACTIVE lenders. Calling this does not initiate or imply any financing application — the actual application flow stays gated on LenderRegistry.isActive at mint time.
Query parameters
| Param | Type | Default | Notes |
|---|
jurisdiction | string | GLOBAL | ISO 3166-1 alpha-2 (e.g. AE, US) or GLOBAL |
archetype | enum | (all) | fsra-licensed | defi-vault | generic — filter to one archetype |
limit | int | 10 | Clamped to [1, 50] |
Ranking
- Exact-jurisdiction matches ranked first
GLOBAL fallback lenders ranked after exact matches- Within each group, sorted by
issuedAttestationCount desc (proven track record first)
Example
curl 'https://apiv3.droplinked.com/v2/lender-routing/recommend?jurisdiction=AE&archetype=fsra-licensed&limit=5'
{
"jurisdiction": "AE",
"archetype": "fsra-licensed",
"count": 2,
"recommendations": [
{
"lenderId": "crediblex-uae",
"displayName": "CredibleX (UAE)",
"archetype": "fsra-licensed",
"jurisdiction": "AE",
"matchKind": "exact-jurisdiction",
"rank": 1
},
{
"lenderId": "valinor-vault",
"displayName": "Valinor Vault",
"archetype": "defi-vault",
"jurisdiction": "GLOBAL",
"matchKind": "global-fallback",
"rank": 2
}
]
}
When matchKind matters
A verifier or merchant portal may surface lenders differently based on matchKind:
| matchKind | Suggested UI framing |
|---|
exact-jurisdiction | ”Recommended for your region” |
global-fallback | ”Available globally” |
