Build

Deal Team

List team members on deals in the Lev API.

Updated March 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.

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 team member
`permission`	string\|null	Permission level
`photo_url`	string\|null	Profile photo URL