---
title: "Get Lender Search"
method: GET
path: "/api/external/v2/deals/{deal_id}/lender-search"
tags: ["external-v2-deals"]
---

# Get Lender Search

`GET /api/external/v2/deals/{deal_id}/lender-search`

Poll the latest lender search results for a deal.

Returns paginated results with AI ranking status.  Returns **404**
if no lender search has been run for the deal.

## Path parameters

- `deal_id` integer, required

## Query parameters

- `limit` integer — Number of results to return (1-200, clamped)
- `offset` integer — Offset for pagination (>= 0, clamped)

## Response `200`

Successful Response

- LenderSearchResultsResponse — OpenAPI schema for GET /deals/<id>/lender-search.
  - `request_id` string, required
  - `timestamp` string, required
  - `data` LenderSearchResultsData, required — Payload inside the ``data`` envelope for the lender-search GET.
    - `search_id` string, required
    - `status` string, required
    - `deal_id` integer, required
    - `results` LenderSearchResult[], required
      - `org_id` integer, nullable
      - `organization_name` string, nullable
      - `is_connected_lender` boolean, nullable
      - `ai_score` integer, nullable
      - `ai_rank_status` string, nullable
      - `ai_match_insights` string, nullable
      - `programs` LenderProgramResult[], nullable
        - `id` integer, required
        - `title` string, nullable
        - `loan_types` string[], nullable
        - `min_loan_amount` number, nullable
        - `max_loan_amount` number, nullable
        - `capital_source_type` string, nullable
        - `states` string[], nullable
        - `asset_types` string[], nullable
    - `pagination` LenderSearchPagination, required — Pagination metadata nested inside ``data``.
      - `total` integer, required
      - `limit` integer, required
      - `offset` integer, required
      - `has_more` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/lev/apis/lev-api.md) · [All operations](https://skmtc.net/lev/apis/lev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lev/lev-api/revisions/a586be7d6d3a/schema)