BookingDTO

A single booking returned by GET /v1/open-api/booking/{id} — every field of BookingTableDTO plus flatDetails.

idint64nullable

Booking ID

Example: 512

uuidstringnullable

Booking UUID

Example: 8f3c2b16-9e51-4d0a-9f26-2f0b1c7a51de

numberstringnullable

Booking number

Example: B-2024-118

statusBookingStatus

Booking status.

• ACTIVE — active, the term has not expired
• CONTRACT — the booking turned into a contract
• CANCELED — cancelled

Possible values: [ACTIVE, CONTRACT, CANCELED]

Example: ACTIVE

sourceBookingSource

Where the booking came from.

• COMPANY — placed by the company itself (from inside the CRM)
• MARKETPLACE — placed through the uysot.uz marketplace
• OTHER — anything else

Possible values: [COMPANY, MARKETPLACE, OTHER]

Example: COMPANY

timestampint64nullable

Booking date, epoch seconds

Example: 1730419200

delayint32nullable

Booking term, in days

Example: 7

remainedint32nullable

Days remaining of the term

Example: 3

prePaymentdoublenullable

Prepayment amount, in currency

Example: 15000000

refundablePaymentbooleannullable

Whether the prepayment is refundable

Example: true

dealPricedoublenullable

Agreed price (discount applied), in currency

Example: 890000000

currency object

Currency information object.

idint32

Currency ID

Example: 1

valuedouble

Exchange rate (1 for the basic currency)

Example: 1

updateTimestampint64

Last update time (epoch seconds)

Example: 1672531200

basicboolean

Whether it's the company's basic currency

Example: true

ccystring

Currency code

Example: USD

notestringnullable

Free-text note

Example: Mijoz juma kuni keladi

employee object

Compact employee reference.

idint32

Employee ID

Example: 201

fullNamestring

Employee full name

Example: David Wilson

cancelEmployee object

Compact employee reference.

idint32

Employee ID

Example: 201

fullNamestring

Employee full name

Example: David Wilson

client object

Company client information object.

idint64

Client ID

Example: 1001

namestring

Client name (individual or legal entity)

Example: John Doe

innstring

Client INN (individual's PINFL)

Example: 123456789

statusClientStatus

Client status enum.

Possible values: [NEW, ACTIVE, PASSIVE, ARCHIVE]

Example: ACTIVE

flat object

Compact apartment reference with its building and house (project), used inside LeadEventDTO as flat.

Same shape as ContractFlatCompactDTO, which is built from a contract's apartment and takes repaired from the contract; here repaired is the apartment's own flag.

idint32nullable

Apartment ID

Example: 7781

numberstringnullable

Apartment number

Example: 45

roomsstringnullable

Room count

Example: 3

floorint32nullable

Floor

Example: 5

areadoublenullable

Area, m².

Example: 78.4

repairedbooleannullable

Whether the apartment is repaired

Example: true

buildingIdint32nullable

Building ID

Example: 34

buildingNamestringnullable

Building name

Example: A blok

houseIdint32nullable

House (project) ID

Example: 12

houseNamestringnullable

House (project) name

Example: Green Valley

house object

Most compact house (project) reference — identity only.

idint32

House ID

Example: 12

namestringnullable

House name

Example: Green Valley

branchIdint32nullable

Branch the booking was created in

Example: 1

branchNamestringnullable

Branch name

Example: Chilonzor

contractIdint32nullable

Contract the booking turned into (set when status is CONTRACT)

Example: 1409

contractNumberstringnullable

Contract number

Example: C-1409

cancelTimestampint64nullable

Cancellation time, epoch seconds

Example: 1733011200

cancelNotestringnullable

Cancellation note

Example: Mijoz voz kechdi

cancelReasons object[]nullable

Cancellation reasons attached to the booking.

Array [

idint32nullable

Reason ID

Example: 3

nameUzstringnullable

Name in Uzbek (Latin)

Example: Mijoz voz kechdi

nameRustringnullable

Name in Russian

Example: Клиент отказался

nameEnstringnullable

Name in English

Example: Client withdrew

nameKrstringnullable

Name in Uzbek (Cyrillic)

Example: Мижоз воз кечди

nameTjstringnullable

Name in Tajik

Example: Муштарӣ даст кашид

nameKystringnullable

Name in Kyrgyz

Example: Кардар баш тартты

]

realtorIdint32nullable

Realtor company that placed the booking (in the MARKETPLACE flow)

Example: 77

realtorNamestringnullable

Realtor company name

Example: Uysot Realty

flatDetails objectnullable

The full apartment object — building, house, prices, address and custom field values, identical in shape to GET /v1/open-api/flat/{id}. Never present in the list response.

idint32

Apartment ID

Example: 1024

numberstringnullable

Apartment number

Example: 45

roomsstringnullable

Room count, stored as text

Example: 3

areadoublenullable

Total area, m²

Example: 78.4

statusCommerceStatus

Commercial status of an apartment.

• SALE — on sale
• BOOKED — booked
• SOLD — sold
• RESERVE — reserved
• DELIVERED — keys handed over
• REGISTERED — registered to the client

Possible values: [SALE, BOOKED, SOLD, RESERVE, DELIVERED, REGISTERED]

Example: SALE

repairedbooleannullable

Whether the apartment is repaired

Example: true

apartmentbooleannullable

Whether the unit is an apartment

Example: true

pricedoublenullable

Total price, in currency

Example: 780000000

pricePerAreadoublenullable

Price per m²

Example: 9948000

pricePerAreaRepaireddoublenullable

Price per m² with repair

Example: 10969000

priceRepaireddoublenullable

Total price with repair

Example: 860000000

priceNotRepaireddoublenullable

Total price without repair

Example: 780000000

floorint32nullable

Floor

Example: 7

building object

A building (block) of a house.

idint32

Building ID

Example: 34

namestringnullable

Building name

Example: A blok

isSalebooleannullable

Whether the building is on sale

Example: true

startDatestringnullable

Construction start date (dd.MM.yyyy)

Example: 05.01.2025

finishDatestringnullable

Construction finish date (dd.MM.yyyy)

Example: 01.12.2027

deletedTimestampint64nullable

Deletion time (epoch seconds, null if active)

Example: null

house object

House (project) as embedded in FlatDTO — without the buildings list.

idint32

House ID

Example: 12

namestringnullable

House name

Example: Green Valley

addressstringnullable

Street address of the house

Example: Chilonzor 9-kvartal

deletedTimestampint64nullable

Deletion time (epoch seconds, null if active)

Example: null

isSalebooleannullable

Whether the house is on sale

Example: true

buildingStartsstringnullable

Construction start date (dd.MM.yyyy)

Example: 05.01.2025

releasestringnullable

Planned hand-over date (dd.MM.yyyy)

Example: 01.12.2027

terrace objectnullable

The apartment's terrace, null when it has none.

idint32

Terrace ID

Example: 501

areadoublenullable

Terrace area, m²

Example: 6.2

pricePerAreadoublenullable

Terrace price per m²

Example: 4000000

pricePerAreaRepaireddoublenullable

Terrace price per m² with repair

Example: 4500000

currency objectnullable

Currency of the prices — the house's currency, null when the house has none.

idint32

Currency ID

Example: 1

valuedouble

Exchange rate (1 for the basic currency)

Example: 1

updateTimestampint64

Last update time (epoch seconds)

Example: 1672531200

basicboolean

Whether it's the company's basic currency

Example: true

ccystring

Currency code

Example: USD

categoryFlatCategory

Apartment class.

Possible values: [ECONOMICAL, COMFORT, BUSINESS, PREMIUM]

Example: COMFORT

nonResidentialTypeNonResidentialType

Type of a non-residential unit.

• BASEMENT — basement
• SHOP — shop
• PARKING — parking place
• APARTMENT — apartment

Possible values: [BASEMENT, SHOP, PARKING, APARTMENT]

Example: SHOP

address objectnullable

The house's address, null when the house has no district set.

indexint32nullable

Postal index

Example: 100096

zonestringnullable

Country zone / phone zone

Example: UZ

country_enstringnullable

Example: Uzbekistan

country_rustringnullable

Example: Узбекистан

country_uzstringnullable

Example: O'zbekiston

country_krstringnullable

Example: Ўзбекистон

country_trstringnullable

Example: Özbekistan

country_tjstringnullable

Example: Ӯзбекистон

country_kystringnullable

Example: Өзбекстан

region_enstringnullable

Example: Tashkent

region_rustringnullable

Example: Ташкент

region_uzstringnullable

Example: Toshkent

region_krstringnullable

Example: Тошкент

region_trstringnullable

Example: Taşkent

region_tjstringnullable

Example: Тошканд

region_kystringnullable

Example: Ташкент

city_enstringnullable

Example: Chilanzar

city_rustringnullable

Example: Чиланзар

city_uzstringnullable

Example: Chilonzor

city_krstringnullable

Example: Чилонзор

city_trstringnullable

Example: Çilanzar

city_tjstringnullable

Example: Чилонзор

city_kystringnullable

Example: Чиланзар

streetstringnullable

Street address of the house

Example: Chilonzor 9-kvartal

fields object[]nullable

Apartment custom field values. null when the caller didn't request them.

Array [

fieldIdint64

Field ID — matches FlatFieldDTO.id

Example: 12

valuestringnullable

The resolved value as text (option name, date, URL, …)

Example: Ochiq

namestringnullable

Field name

Example: Balkon turi

typeCustomFieldType

Custom field type, shared by every custom-field family (contract, flat, payment and lead task). Serialized by name. Identical value set to ContractFieldType, which remains as the contract-family alias.

Possible values: [TEXT, EXTENDED_TEXT, DATE, SELECT, MULTI_SELECT, RADIO, TOGGLE_SWITCH, URL, TAG, LOCATION, COUNTER, ADDRESS, EMPLOYEE, FILE, NUMBER]

Example: SELECT

requiredbooleannullable

Whether the field is mandatory

Example: false

sortOrderint32nullable

Display position

Example: 1

numberdoublenullable

Numeric value — NUMBER fields only

Example: 1500000

currencyIdint32nullable

Currency of number — NUMBER fields only

Example: 24

valuesstring[]

Ordered values of a multi-value field (MULTI_SELECT, EMPLOYEE, FILE). Empty for single-value types.

Example: []

latitudedoublenullable

Latitude — LOCATION fields only

Example: null

longitudedoublenullable

Longitude — LOCATION fields only

Example: null

files object[]

Attached files — FILE fields only. Empty for every other type.

Array [

absolutePathstringnullable

Presigned URL to the full-size file

Example: https://minio.uysot.uz/uysot/files/201/avatar.png?X-Amz-Expires=3600

thumbAbsolutePathstringnullable

Presigned URL to the thumbnail rendition

Example: https://minio.uysot.uz/uysot/files/201/avatar_thumb.png?X-Amz-Expires=3600

smallestAbsolutePathstringnullable

Presigned URL to the smallest rendition

Example: https://minio.uysot.uz/uysot/files/201/avatar_small.png?X-Amz-Expires=3600

]

]

BookingDTO

{
  "id": 512,
  "uuid": "8f3c2b16-9e51-4d0a-9f26-2f0b1c7a51de",
  "number": "B-2024-118",
  "status": "ACTIVE",
  "source": "COMPANY",
  "timestamp": 1730419200,
  "delay": 7,
  "remained": 3,
  "prePayment": 15000000,
  "refundablePayment": true,
  "dealPrice": 890000000,
  "currency": {
    "id": 1,
    "value": 1,
    "updateTimestamp": 1672531200,
    "basic": true,
    "ccy": "USD"
  },
  "note": "Mijoz juma kuni keladi",
  "employee": {
    "id": 201,
    "fullName": "David Wilson"
  },
  "cancelEmployee": {
    "id": 201,
    "fullName": "David Wilson"
  },
  "client": {
    "id": 1001,
    "name": "John Doe",
    "inn": "123456789",
    "status": "ACTIVE"
  },
  "flat": {
    "id": 7781,
    "number": "45",
    "rooms": "3",
    "floor": 5,
    "area": 78.4,
    "repaired": true,
    "buildingId": 34,
    "buildingName": "A blok",
    "houseId": 12,
    "houseName": "Green Valley"
  },
  "house": {
    "id": 12,
    "name": "Green Valley"
  },
  "branchId": 1,
  "branchName": "Chilonzor",
  "contractId": 1409,
  "contractNumber": "C-1409",
  "cancelTimestamp": 1733011200,
  "cancelNote": "Mijoz voz kechdi",
  "cancelReasons": [
    {
      "id": 3,
      "nameUz": "Mijoz voz kechdi",
      "nameRu": "Клиент отказался",
      "nameEn": "Client withdrew",
      "nameKr": "Мижоз воз кечди",
      "nameTj": "Муштарӣ даст кашид",
      "nameKy": "Кардар баш тартты"
    }
  ],
  "realtorId": 77,
  "realtorName": "Uysot Realty",
  "flatDetails": {
    "id": 1024,
    "number": "45",
    "rooms": "3",
    "area": 78.4,
    "status": "SALE",
    "repaired": true,
    "apartment": true,
    "price": 780000000,
    "pricePerArea": 9948000,
    "pricePerAreaRepaired": 10969000,
    "priceRepaired": 860000000,
    "priceNotRepaired": 780000000,
    "floor": 7,
    "building": {
      "id": 34,
      "name": "A blok",
      "isSale": true,
      "startDate": "05.01.2025",
      "finishDate": "01.12.2027",
      "deletedTimestamp": null
    },
    "house": {
      "id": 12,
      "name": "Green Valley",
      "address": "Chilonzor 9-kvartal",
      "deletedTimestamp": null,
      "isSale": true,
      "buildingStarts": "05.01.2025",
      "release": "01.12.2027"
    },
    "terrace": {
      "id": 501,
      "area": 6.2,
      "pricePerArea": 4000000,
      "pricePerAreaRepaired": 4500000
    },
    "currency": {
      "id": 1,
      "value": 1,
      "updateTimestamp": 1672531200,
      "basic": true,
      "ccy": "USD"
    },
    "category": "COMFORT",
    "nonResidentialType": "SHOP",
    "address": {
      "index": 100096,
      "zone": "UZ",
      "country_en": "Uzbekistan",
      "country_ru": "Узбекистан",
      "country_uz": "O'zbekiston",
      "country_kr": "Ўзбекистон",
      "country_tr": "Özbekistan",
      "country_tj": "Ӯзбекистон",
      "country_ky": "Өзбекстан",
      "region_en": "Tashkent",
      "region_ru": "Ташкент",
      "region_uz": "Toshkent",
      "region_kr": "Тошкент",
      "region_tr": "Taşkent",
      "region_tj": "Тошканд",
      "region_ky": "Ташкент",
      "city_en": "Chilanzar",
      "city_ru": "Чиланзар",
      "city_uz": "Chilonzor",
      "city_kr": "Чилонзор",
      "city_tr": "Çilanzar",
      "city_tj": "Чилонзор",
      "city_ky": "Чиланзар",
      "street": "Chilonzor 9-kvartal"
    },
    "fields": [
      {
        "fieldId": 12,
        "value": "Ochiq",
        "name": "Balkon turi",
        "type": "SELECT",
        "required": false,
        "sortOrder": 1,
        "number": 1500000,
        "currencyId": 24,
        "values": [],
        "latitude": null,
        "longitude": null,
        "files": [
          {
            "absolutePath": "https://minio.uysot.uz/uysot/files/201/avatar.png?X-Amz-Expires=3600",
            "thumbAbsolutePath": "https://minio.uysot.uz/uysot/files/201/avatar_thumb.png?X-Amz-Expires=3600",
            "smallestAbsolutePath": "https://minio.uysot.uz/uysot/files/201/avatar_small.png?X-Amz-Expires=3600"
          }
        ]
      }
    ]
  }
}