---
title: "Deal data model"
url: "https://docs.unified.to/crm/deal/model"
description: "API reference for Deal data model. Launch multiple pre-built Deal integrations today with zero maintenance — all through a single API."
generated_at: "2026-06-26T21:09:41.407Z"
---
# Deal data model

A deal represents an opportunity with companies and/or contacts

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](/crm/integrations) page. 

### 

* Data Model
* Typescript Type
* Zod Shape
* Python Class

Data Model

**id**string 

Unique identifier for this deal object

**created\_at**date 

The date that this deal object was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date 

The last date that this deal object was updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**name**string 

The name of this deal

**amount**number 

The potential amount that deal could be worth

**currency**string 

The currency for the deal amount (3 letter ISO code; eg. USD)

**closed\_at**date 

The date that this deal closed (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**closing\_at**date 

expected closing date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**stage**string 

@deprecated Use stages array instead

**stage\_id**string 

@deprecated Use stages array instead

**pipeline**string 

@deprecated Use pipelines array instead

**pipeline\_id**string 

@deprecated Use pipelines array instead

**stages** array 

**pipelines** array 

**source**string 

The source for this deal

**probability**number 

**tags**string array 

**lost\_reason**string 

**won\_reason**string 

**user\_id**string 

(reference to HrisEmployee)

**contact\_ids**string array 

(reference to CrmContact)

**company\_ids**string array 

(reference to CrmCompany)

**metadata** array 

**raw**any 

The raw data returned by the integration for this deal