V2 field reference

The shared strict XML and JSON field contract for each listing category.

Import documentation menu

Choose a category to see every accepted V2 field and its available option values.

Listing categorySearch fields

Required fields only

<flat>

Fields: 44

Flats

<flat>

Update rule: Omitting an optional field clears its previous imported value because every V2 record is a complete snapshot. Primary contact name, phone and email instead use broker/owner fallback.

Field path	Rules and example	Requirement	Type	Multiple values
Identity
`/domoplius/listings/flat/external_id` #	Example:`100001`	Required	`positive_integer`	No
`/domoplius/listings/flat/action_type` #	Constraints: allowed values: 1, 3, 9 Example:`1`	Required	`option_id`	No
Contacts
`/domoplius/listings/flat/contact_name` #	Constraints: up to 50 characters Example:`Partnerio brokeris`	Optional	`string`	No
`/domoplius/listings/flat/contact_phone` #	Constraints: up to 32 characters Example:`+37060000000`	Optional	`string`	No
`/domoplius/listings/flat/contact_secondary_phone` #	Constraints: up to 32 characters Example:`+37061111111`	Optional	`string`	No
`/domoplius/listings/flat/contact_email` #	Constraints: up to 100 characters; valid email address Example:`[email protected]`	Optional	`email`	No
Pricing
`/domoplius/listings/flat/price_eur` #	Constraints: greater than 0; at most 28962001.85; up to 2 decimal places; decimal with up to two places Example:`145000`	Depends on conditions Required when action_type equals 1, 3.	`decimal`	No
`/domoplius/listings/flat/short_rent_hour_eur` #	Constraints: greater than 0; at most 28962001.85; up to 2 decimal places; decimal with up to two places Example:`15`	Optional	`decimal`	No
`/domoplius/listings/flat/short_rent_day_eur` #	Constraints: greater than 0; at most 28962001.85; up to 2 decimal places; decimal with up to two places Example:`75`	Depends on conditions Required when action_type equals 9.	`decimal`	No
`/domoplius/listings/flat/short_rent_person_eur` #	Constraints: greater than 0; at most 28962001.85; up to 2 decimal places; decimal with up to two places Example:`25`	Optional	`decimal`	No
Location
`/domoplius/listings/flat/administrative_unit_id` #	Example:`461`	Required	`positive_integer`	No
`/domoplius/listings/flat/settlement_id` #	Example:`1`	Required	`positive_integer`	No
`/domoplius/listings/flat/microdistrict_id` #	Example:`31`	Optional	`positive_integer`	No
`/domoplius/listings/flat/street_id` #	Example:`22328`	Optional	`positive_integer`	No
`/domoplius/listings/flat/building_number` #	Constraints: up to 32 characters Example:`12A`	Optional	`string`	No
`/domoplius/listings/flat/unit_number` #	Constraints: up to 32 characters Example:`4`	Optional	`string`	No
`/domoplius/listings/flat/hide_building_number` #	Constraints: allowed values: false, true Example:`false`	Optional	`boolean`	No
`/domoplius/listings/flat/hide_unit_number` #	Constraints: allowed values: false, true Example:`false`	Optional	`boolean`	No
`/domoplius/listings/flat/latitude` #	Constraints: at least -90; at most 90; up to 7 decimal places; coordinate with up to seven places Example:`54.687157`	Optional	`decimal`	No
`/domoplius/listings/flat/longitude` #	Constraints: at least -180; at most 180; up to 7 decimal places; coordinate with up to seven places Example:`25.279652`	Optional	`decimal`	No
Content and media
`/domoplius/listings/flat/description` #	Constraints: up to 65535 bytes Example:`Šviesus butas.`	Optional	`string`	No
`/domoplius/listings/flat/video_url` #	Constraints: up to 2048 characters; Absolute HTTP(S) YouTube URL Example:`https://www.youtube.com/watch?v=dQw4w9WgXcQ`	Optional	`url`	No
`/domoplius/listings/flat/photos/photo_url` #	Constraints: up to 2048 characters; up to 30 values; absolute HTTP or HTTPS URL Example:`["https://example.lt/photo.jpg"]`	Optional	`url_list`	Yes
Features
`/domoplius/listings/flat/features/feature_id` #	Constraints: greater than 0; up to 85 values Example:`[79]`	Optional	`option_id_list`	Yes
Property data
`/domoplius/listings/flat/flat_size` #	Constraints: greater than 0; at most 99999999.99; up to 2 decimal places; decimal with up to two places Example:`50.5`	Required	`decimal`	No
`/domoplius/listings/flat/flat_rooms` #	Constraints: greater than 0; at most 255 Example:`1`	Required	`integer`	No
`/domoplius/listings/flat/flat_floor` #	Constraints: at least 0; at most 255 Example:`1`	Optional	`integer`	No
`/domoplius/listings/flat/flat_situation_id` #	Constraints: greater than 0 Example:`1`	Optional	`option_id`	No
`/domoplius/listings/flat/flat_in_floor_id` #	Constraints: greater than 0 Example:`1`	Optional	`option_id`	No
`/domoplius/listings/flat/flat_door_id` #	Constraints: greater than 0 Example:`1`	Optional	`option_id`	No
`/domoplius/listings/flat/flat_windows_id` #	Constraints: greater than 0 Example:`1`	Optional	`option_id`	No
`/domoplius/listings/flat/construction_type_id` #	Constraints: greater than 0 Example:`1`	Optional	`option_id`	No
`/domoplius/listings/flat/building_reconstruction_date` #	Constraints: up to 7 characters; year from 1400 to 2031; YYYY or YYYY-MM Example:`2020-05`	Optional	`string`	No
`/domoplius/listings/flat/building_water_supply_id` #	Constraints: greater than 0 Example:`1`	Optional	`option_id`	No
`/domoplius/listings/flat/building_gas_id` #	Constraints: greater than 0 Example:`1`	Optional	`option_id`	No
`/domoplius/listings/flat/building_sewerage_id` #	Constraints: greater than 0 Example:`1`	Optional	`option_id`	No
`/domoplius/listings/flat/building_build_date` #	Constraints: up to 7 characters; year from 1400 to 2031; YYYY or YYYY-MM Example:`2020-05`	Optional	`string`	No
`/domoplius/listings/flat/building_floors` #	Constraints: at least 0; at most 65535 Example:`1`	Optional	`integer`	No
`/domoplius/listings/flat/building_heating_id` #	Constraints: greater than 0 Example:`1`	Optional	`option_id`	No
`/domoplius/listings/flat/energy_certificate_id` #	Constraints: greater than 0 Example:`1`	Optional	`option_id`	No
`/domoplius/listings/flat/heating_taxes` #	Constraints: at least 0 Example:`1`	Optional	`integer`	No
`/domoplius/listings/flat/other_taxes` #	Constraints: at least 0 Example:`1`	Optional	`integer`	No
`/domoplius/listings/flat/interest_in_change` #	Constraints: allowed values: false, true Example:`false`	Optional	`boolean`	No
`/domoplius/listings/flat/window_directions` #	Constraints: up to 64 characters; allowed values: n, e, s, w; comma-separated lowercase direction codes Example:`n,e`	Optional	`string`	No

Identity

/domoplius/listings/flat/external_id #

Requiredpositive_integer Multiple values: No

Example:100001

/domoplius/listings/flat/action_type #

Requiredoption_id Multiple values: No

Constraints: allowed values: 1, 3, 9

Example:1

Contacts

/domoplius/listings/flat/contact_name #

Optionalstring Multiple values: No

Constraints: up to 50 characters

Example:Partnerio brokeris

/domoplius/listings/flat/contact_phone #

Optionalstring Multiple values: No

Constraints: up to 32 characters

Example:+37060000000

/domoplius/listings/flat/contact_secondary_phone #

Optionalstring Multiple values: No

Constraints: up to 32 characters

Example:+37061111111

/domoplius/listings/flat/contact_email #

Optionalemail Multiple values: No

Constraints: up to 100 characters; valid email address

Example:[email protected]

Pricing

/domoplius/listings/flat/price_eur #

Depends on conditionsdecimal Multiple values: No

Required when action_type equals 1, 3.

Constraints: greater than 0; at most 28962001.85; up to 2 decimal places; decimal with up to two places

Example:145000

/domoplius/listings/flat/short_rent_hour_eur #

Optionaldecimal Multiple values: No

Constraints: greater than 0; at most 28962001.85; up to 2 decimal places; decimal with up to two places

Example:15

/domoplius/listings/flat/short_rent_day_eur #

Depends on conditionsdecimal Multiple values: No

Required when action_type equals 9.

Constraints: greater than 0; at most 28962001.85; up to 2 decimal places; decimal with up to two places

Example:75

/domoplius/listings/flat/short_rent_person_eur #

Optionaldecimal Multiple values: No

Constraints: greater than 0; at most 28962001.85; up to 2 decimal places; decimal with up to two places

Example:25

Location

/domoplius/listings/flat/administrative_unit_id #

Requiredpositive_integer Multiple values: No

Example:461

/domoplius/listings/flat/settlement_id #

Requiredpositive_integer Multiple values: No

Example:1

/domoplius/listings/flat/microdistrict_id #

Optionalpositive_integer Multiple values: No

Example:31

/domoplius/listings/flat/street_id #

Optionalpositive_integer Multiple values: No

Example:22328

/domoplius/listings/flat/building_number #

Optionalstring Multiple values: No

Constraints: up to 32 characters

Example:12A

/domoplius/listings/flat/unit_number #

Optionalstring Multiple values: No

Constraints: up to 32 characters

Example:4

/domoplius/listings/flat/hide_building_number #

Optionalboolean Multiple values: No

Constraints: allowed values: false, true

Example:false

/domoplius/listings/flat/hide_unit_number #

Optionalboolean Multiple values: No

Constraints: allowed values: false, true

Example:false

/domoplius/listings/flat/latitude #

Optionaldecimal Multiple values: No

Constraints: at least -90; at most 90; up to 7 decimal places; coordinate with up to seven places

Example:54.687157

/domoplius/listings/flat/longitude #

Optionaldecimal Multiple values: No

Constraints: at least -180; at most 180; up to 7 decimal places; coordinate with up to seven places

Example:25.279652

Content and media

/domoplius/listings/flat/description #

Optionalstring Multiple values: No

Constraints: up to 65535 bytes

Example:Šviesus butas.

/domoplius/listings/flat/video_url #

Optionalurl Multiple values: No

Constraints: up to 2048 characters; Absolute HTTP(S) YouTube URL

Example:https://www.youtube.com/watch?v=dQw4w9WgXcQ

/domoplius/listings/flat/photos/photo_url #

Optionalurl_list Multiple values: Yes

Constraints: up to 2048 characters; up to 30 values; absolute HTTP or HTTPS URL

Example:["https://example.lt/photo.jpg"]

Features

/domoplius/listings/flat/features/feature_id #

Optionaloption_id_list Multiple values: Yes

Constraints: greater than 0; up to 85 values

Example:[79]

Property data

/domoplius/listings/flat/flat_size #

Requireddecimal Multiple values: No

Constraints: greater than 0; at most 99999999.99; up to 2 decimal places; decimal with up to two places

Example:50.5

/domoplius/listings/flat/flat_rooms #

Requiredinteger Multiple values: No

Constraints: greater than 0; at most 255

Example:1

/domoplius/listings/flat/flat_floor #

Optionalinteger Multiple values: No

Constraints: at least 0; at most 255

Example:1

/domoplius/listings/flat/flat_situation_id #

Optionaloption_id Multiple values: No

Constraints: greater than 0

Example:1

/domoplius/listings/flat/flat_in_floor_id #

Optionaloption_id Multiple values: No

Constraints: greater than 0

Example:1

/domoplius/listings/flat/flat_door_id #

Optionaloption_id Multiple values: No

Constraints: greater than 0

Example:1

/domoplius/listings/flat/flat_windows_id #

Optionaloption_id Multiple values: No

Constraints: greater than 0

Example:1

/domoplius/listings/flat/construction_type_id #

Optionaloption_id Multiple values: No

Constraints: greater than 0

Example:1

/domoplius/listings/flat/building_reconstruction_date #

Optionalstring Multiple values: No

Constraints: up to 7 characters; year from 1400 to 2031; YYYY or YYYY-MM

Example:2020-05

/domoplius/listings/flat/building_water_supply_id #

Optionaloption_id Multiple values: No

Constraints: greater than 0

Example:1

/domoplius/listings/flat/building_gas_id #

Optionaloption_id Multiple values: No

Constraints: greater than 0

Example:1

/domoplius/listings/flat/building_sewerage_id #

Optionaloption_id Multiple values: No

Constraints: greater than 0

Example:1

/domoplius/listings/flat/building_build_date #

Optionalstring Multiple values: No

Constraints: up to 7 characters; year from 1400 to 2031; YYYY or YYYY-MM

Example:2020-05

/domoplius/listings/flat/building_floors #

Optionalinteger Multiple values: No

Constraints: at least 0; at most 65535

Example:1

/domoplius/listings/flat/building_heating_id #

Optionaloption_id Multiple values: No

Constraints: greater than 0

Example:1

/domoplius/listings/flat/energy_certificate_id #

Optionaloption_id Multiple values: No

Constraints: greater than 0

Example:1

/domoplius/listings/flat/heating_taxes #

Optionalinteger Multiple values: No

Constraints: at least 0

Example:1

/domoplius/listings/flat/other_taxes #

Optionalinteger Multiple values: No

Constraints: at least 0

Example:1

/domoplius/listings/flat/interest_in_change #

Optionalboolean Multiple values: No

Constraints: allowed values: false, true

Example:false

/domoplius/listings/flat/window_directions #

Optionalstring Multiple values: No

Constraints: up to 64 characters; allowed values: n, e, s, w; comma-separated lowercase direction codes

Example:n,e

For API clients

Optional integration details for clients that synchronise the public field, option, and location endpoints.

XML requires the V2 namespace and version="2"; JSON has no version property. Both formats use the same listing fields.
Unknown fields, aliases, duplicate scalar fields, and malformed collections are rejected.
Fetch numeric option and location IDs from the V2 endpoints instead of hard-coding them.
Responses support ETags, five-minute caching, and rate limiting.