---
title: "DealPhaseHistoryByDealId (Teamleader Focus)"
description: "Deal Phase History by Deal ID"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/teamleader/Teamleader.V2.DealPhaseHistoryByDealId
original: https://documentation.invantive.eu/en/datamodels/teamleader/Teamleader.V2.DealPhaseHistoryByDealId
updated: 2026-11-01T17:45:29Z
license: https://documentation.invantive.eu/en/
---

# DealPhaseHistoryByDealId: Teamleader Focus Deal Phase History by Deal ID

`read only` `REST`

- Catalog: `Teamleader`
- Schema: `V2`
- Primary Keys: `id`
- Label: Deal Phase History by Deal ID

Can only retrieve data.

## API Source

- Endpoint: `deals.info`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 39 |

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `id` | `` | [x] |  |  |

## Table Columns

The columns of the table `DealPhaseHistoryByDealId` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `deal_closed_at` | `datetime` | Deal Closed at | [ ] | filters on the platform, writable, `::ancestor.closed_at` |  |
| `deal_created_at` | `datetime` | Deal Created at | [x] | filters on the platform, writable, `::ancestor.created_at` |  |
| `deal_id` | `varchar2` | Deal ID | [x] | filters on the platform, writable, `::ancestor.id` |  |
| `deal_purchase_order_number` | `varchar2` | Deal Purchase Order Number | [ ] | filters on the platform, writable, `::ancestor.purchase_order_number` |  |
| `deal_reference` | `varchar2` | Deal Reference | [ ] | filters on the platform, writable, `::ancestor.reference` |  |
| `deal_status` | `varchar2` | Deal Status | [x] | filters on the platform, writable, `::ancestor.status` |  |
| `deal_summary` | `varchar2` | Deal Summary | [ ] | filters on the platform, writable, `::ancestor.summary` |  |
| `deal_title` | `varchar2(120)` | Deal Title | [ ] | filters on the platform, writable, `::ancestor.title` |  |
| `deal_updated_at` | `datetime` | Deal Updated at | [x] | filters on the platform, writable, `::ancestor.updated_at` |  |
| `deal_web_url` | `varchar2` | Deal Web URL | [x] | filters on the platform, writable, `::ancestor.web_url` |  |
| `phase_id` | `varchar2` | Phase ID | [x] | filters on the platform, writable, `phase.id` |  |
| `phase_type` | `varchar2` | Phase Type | [x] | filters on the platform, writable, `phase.type` |  |
| `started_at` | `datetime` | Started at | [x] | filters on the platform, writable |  |
| `started_by_id` | `varchar2` | Started by User ID | [ ] | filters on the platform, writable, `started_by.id` |  |
| `started_by_type` | `varchar2` | Started by User Type | [ ] | filters on the platform, writable, `started_by.type` |  |



## Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

- [Teamleader Focus](/en/release-notes/drivers?driver=teamleader-focus)

