---
title: "List Deals"
method: GET
path: "/api/external/v2/deals"
tags: ["external-v2-deals"]
---

# List Deals

`GET /api/external/v2/deals`

## Query parameters

- `limit` integer — Number of results to return (1-200, clamped)
- `offset` integer — Offset for pagination (>= 0, clamped)
- `fields` string, nullable — Comma-separated sparse fieldset
- `include` string, nullable — Comma-separated relationship includes
- `cursor` string, nullable — Base64 cursor for pagination
- `sort` string, nullable — Comma-separated, - prefix for desc
- `search` string, nullable — Case-insensitive substring search on deal title, property city/state, and sponsor company name

## Response `200`

Successful Response

- DealListResponse — OpenAPI schema for GET /api/external/v2/deals (list envelope).
  - `request_id` string, required
  - `timestamp` string, required
  - `data` DealResponse[], required
    - `id` integer, required
    - `title` string, nullable, required
    - `loan_amount` number, nullable, required
    - `priority` string, required
    - `loan_type` string, nullable, required
    - `transaction_type` string, nullable, required
    - `business_plan` string, nullable, required
    - `description` string, nullable, required
    - `estimated_close_date` string, nullable, required
    - `close_date` string, nullable, required
    - `owner_account_id` integer, nullable, required
    - `sponsor_private_company_id` integer, nullable, required
    - `urls` DealUrlsResponse, required — Borrower-portal deeplinks emitted on every deal payload — keys mirror ``app.utils.url_generator.DEAL_SUBPAGE_PATHS``.
      - `overview` string, required
      - `data` string, required
      - `dataroom` string, required
      - `lenders` string, required
      - `quote_matrix` string, required
      - `vaults` string, required
    - `created_at` string, nullable, required
    - `updated_at` string, nullable, required
    - `archived` boolean, required
    - `archived_at` string, nullable, required
    - `financials` DealFinancialsResponse
      - `id` integer, required
      - `in_place_noi` number, nullable, required
      - `stabilized_noi` number, nullable, required
      - `stabilized_value` number, nullable, required
      - `stabilized_occupancy` number, nullable, required
      - `purchase_price` number, nullable, required
      - `asking_price` number, nullable, required
      - `estimated_value` number, nullable, required
      - `total_cost` number, nullable, required
      - `total_cost_basis` number, nullable, required
      - `capex` number, nullable, required
      - `existing_debt` number, nullable, required
      - `going_in_cap_rate` number, nullable, required
      - `land_cost` number, nullable, required
    - `properties` DealPropertyResponse[], nullable
      - `id` integer, required
      - `name` string, nullable, required
      - `address` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required
      - `zip` string, nullable, required
      - `asset_type_id` integer, nullable, required
      - `units` integer, nullable, required
      - `square_footage` number, nullable, required
      - `year_built` integer, nullable, required
  - `pagination` unknown, 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/5bfe74cf6f12/schema)