---
title: "Quote data model"
url: "https://docs.unified.to/property/quote/model"
description: "The Quote data model object in Unified's Quote API: 14 fields, including created_at, listing_id and unittype_id, with types and enum values."
date: "2026-10-29T08:41:27.988Z"
updated: "2026-10-29T08:41:27.988Z"
---
# Quote data model

Updated: October 29, 2026

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](https://docs.unified.to/property/integrations.md) page. 

| Field                         | Type                 | Required | Description                                                                                |
| ----------------------------- | -------------------- | -------- | ------------------------------------------------------------------------------------------ |
| id                            | string               | No       | unique identifier for the quote                                                            |
| created\_at                   | string (date-time)   | No       | when the quote was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)                        |
| listing\_id                   | string               | No       | pointer to the Property Listing to price                                                   |
| unittype\_id                  | string               | No       | pointer to the Property Unittype (room type) to price                                      |
| start\_at                     | string (date-time)   | No       | the arrival (check-in) date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)                       |
| end\_at                       | string (date-time)   | No       | the departure (check-out) date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)                    |
| guests                        | number               | No       | total number of guests                                                                     |
| adults                        | number               | No       | number of adults                                                                           |
| children                      | number               | No       | number of children                                                                         |
| promotion\_code               | string               | No       | promotion or coupon code to apply                                                          |
| currency                      | string               | No       | ISO 4217 currency code                                                                     |
| total\_amount                 | number               | No       | the total price of the stay                                                                |
| deposit\_amount               | number               | No       | the deposit due at booking                                                                 |
| line\_items                   | PropertyLineitem\[\] | No       | price breakdown (base price, fees, taxes, discounts)                                       |
| line\_items\[\].type          | enum                 | No       | base price, fee, tax, discount or deposit Values: BASE, FEE, TAX, DISCOUNT, DEPOSIT, OTHER |
| line\_items\[\].name          | string               | No       | the line item name, eg. Cleaning fee                                                       |
| line\_items\[\].description   | string               | No       | free-text description of the line item                                                     |
| line\_items\[\].amount        | number               | No       | the line item amount (discounts are negative)                                              |
| line\_items\[\].is\_mandatory | boolean              | No       | whether the line item is mandatory                                                         |

## TypeScript

```typescript
export type PropertyQuote = {
	id?: string; // unique identifier for the quote
	created_at?: string-time; // when the quote was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	listing_id?: string; // pointer to the Property Listing to price
	unittype_id?: string; // pointer to the Property Unittype (room type) to price
	start_at?: string-time; // the arrival (check-in) date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	end_at?: string-time; // the departure (check-out) date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	guests?: number; // total number of guests
	adults?: number; // number of adults
	children?: number; // number of children
	promotion_code?: string; // promotion or coupon code to apply
	currency?: string; // ISO 4217 currency code
	total_amount?: number; // the total price of the stay
	deposit_amount?: number; // the deposit due at booking
	line_items?: []; // price breakdown (base price, fees, taxes, discounts)
	raw?: any; // raw data from the integration
} 
```

## Zod

```typescript
import { z } from 'zod';

export const ZodPropertyQuote = z.object({
	id: z.string().optional().describe("unique identifier for the quote"),
	created_at: z.string-time().optional().describe("when the quote was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	listing_id: z.string().optional().describe("pointer to the Property Listing to price"),
	unittype_id: z.string().optional().describe("pointer to the Property Unittype (room type) to price"),
	start_at: z.string-time().optional().describe("the arrival (check-in) date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	end_at: z.string-time().optional().describe("the departure (check-out) date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	guests: z.number().optional().describe("total number of guests"),
	adults: z.number().optional().describe("number of adults"),
	children: z.number().optional().describe("number of children"),
	promotion_code: z.string().optional().describe("promotion or coupon code to apply"),
	currency: z.string().optional().describe("ISO 4217 currency code"),
	total_amount: z.number().optional().describe("the total price of the stay"),
	deposit_amount: z.number().optional().describe("the deposit due at booking"),
	line_items: z.array().optional().describe("price breakdown (base price, fees, taxes, discounts)"),

});
```

## Python

```python
import dataclasses

@dataclasses.dataclass
class PropertyQuote:
	"""unique identifier for the quote"""
	id: Optional[str]
	"""when the quote was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	created_at: Optional[str]
	"""pointer to the Property Listing to price"""
	listing_id: Optional[str]
	"""pointer to the Property Unittype (room type) to price"""
	unittype_id: Optional[str]
	"""the arrival (check-in) date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	start_at: Optional[str]
	"""the departure (check-out) date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	end_at: Optional[str]
	"""total number of guests"""
	guests: Optional[int]
	"""number of adults"""
	adults: Optional[int]
	"""number of children"""
	children: Optional[int]
	"""promotion or coupon code to apply"""
	promotion_code: Optional[str]
	"""ISO 4217 currency code"""
	currency: Optional[str]
	"""the total price of the stay"""
	total_amount: Optional[int]
	"""the deposit due at booking"""
	deposit_amount: Optional[int]
	"""price breakdown (base price, fees, taxes, discounts)"""
	line_items: Optional[PropertyPropertyQuoteLine_items]

```
