Build

Deal Team

List team members on deals in the Lev API.

Updated August 2026

GET/api/external/v2/deals/{deal_id}/team

Team data can also be embedded directly in deal list and detail responses using ?include=team on GET /deals or GET /deals/{deal_id}. See Deals for details. For the person who owns the deal, read the owner_user field on deal responses — the primary deal principal, matched on is_primary and deal_role together. is_primary alone does not identify the owner, and owner_account_id is the owning account rather than a person.

List Team

GET/api/external/v2/deals/{deal_id}/team

List all team members assigned to a deal

Path parameters

deal_idintegerrequired

The deal ID

Response (200):

{
  "request_id": "...",
  "timestamp": "2026-03-20T15:30:45Z",
  "data": [
    {
      "id": 401,
      "user_id": 1234,
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@example.com",
      "deal_role": "deal_lead",
      "is_primary": true,
      "permission": null,
      "photo_url": null
    }
  ]
}

401unauthorized

Authentication required— Missing or invalid Authorization header

404not_found

Deal not found— The deal_id doesn't exist or isn't accessible to the authenticated user

Team Member Object

Field	Type	Description
`id`	integer	Team assignment identifier
`user_id`	integer\|null	User ID
`first_name`	string\|null	First name
`last_name`	string\|null	Last name
`email`	string\|null	Email address
`deal_role`	string\|null	Team role (deal_lead, originator, closer, etc.)
`is_primary`	boolean	Whether this is the primary member for its `deal_role`, so a `deal_principal` row and a `primary_lender_contact` row can both be primary. Primary on its own does not mean deal owner — the owner is the primary `deal_principal`, returned as `owner_user` on the Deal Object
`permission`	string\|null	Permission level
`photo_url`	string\|null	Profile photo URL