# Deal Team

> List team members on deals in the Lev API.

Source: https://www.lev.com/docs/build/deal-team

Last updated: March 2026

---
> 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](/build/deals) for details.

## List Team

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

List all team members assigned to a deal

#### Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `deal_id` | `integer` | Yes | The deal ID |

Response: `200`

#### Error Responses

- **401** (unauthorized): Authentication required
- **404** (not_found): Deal not found

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