---
title: "List Placements"
method: GET
path: "/api/external/v2/placements"
tags: ["external-v2-placements"]
---

# List Placements

`GET /api/external/v2/placements`

List placements across all deals accessible to the authenticated user.

Supports cursor-based pagination (default) and offset-based pagination
(when ``sort`` is provided).  Filtering and sorting use standard v2 query
parameters.

## 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

## Response `200`

Successful Response

- PlacementListResponse — OpenAPI schema for GET /api/external/v2/placements (list envelope).
  - `request_id` string, required
  - `timestamp` string, required
  - `data` PlacementResponse[], required
    - `id` integer, required
    - `deal_id` integer, required
    - `contact_id` integer, nullable
    - `private_company_id` integer, nullable
    - `lender_name` string, nullable — Lender display name for this placement — the account's own CRM / address-book name for the lender, falling back to the canonical lender (Organization) name when the CRM record is unnamed. Null when no lender is set. Embedded so callers need not resolve private_company_id via a separate lookup. For non-owner viewers of masked placements, this is a stable masked label such as 'Lender A'.
    - `contact_name` string, nullable — Full name of the lender contact on this placement. Null when no contact is set, or when a non-owner viewer is reading a masked placement.
    - `status` string, nullable
    - `visibility` string, nullable
    - `lender_status` string, nullable
    - `description` string, nullable
    - `score` number, nullable
    - `lev_score` number, nullable
    - `outreach_source` string, nullable
    - `outreach_date` string, nullable
    - `lender_first_response_date` string, nullable
    - `last_communication_date` string, nullable
    - `created_at` string, nullable
    - `updated_at` string, nullable
  - `pagination` object, 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/e1915e1423cf/schema)