iGUIDE DocsiGUIDE Docs
REST API
Viewer API
  • Create Params
  • Embed iGUIDE
About iGUIDE
REST API
Viewer API
  • Create Params
  • Embed iGUIDE
About iGUIDE
  • Introduction
  • RESO-compliant API
  • View API
  • Webhooks
  • API Responses

RESO-compliant API

The RESO-compliant API exposes publicly available data for a given iGUIDE View. Any features or data that are disabled in that iGUIDE View will not be accessible through the API. The format used in the API is designed to be compliant with RESO Data Dictionary v1.7.

Lightweight Autofill Endpoint

TIP

The response of this endpoint is compliant with the approved RCP-022: RESO Autofill Service.

Return information about an iGUIDE View as a RESO Property object that includes the following details:

  • property address
  • main building measurement details:
    • dimensions
    • areas
    • wall perimeter lengths
    • etc.
  • media links:
    • branded and unbranded iGUIDE URLs
    • PDF floor plan URLs (metric and imperial)
    • gallery images URLs
    • video URL
    • etc.

HTTP Request

GET https://youriguide.com/{viewId}/reso/autofill

Response Payload

PropertyTypeDescription
@reso.contextstringContext specifying Data Dictionay model and version as defined in RCP-025: RESO Common Format
valuearray of Autofill ObjectAn array with exactly one Autofill Object inside containing the details of the requested iGUIDE View

Example

Request:

curl https://youriguide.com/api-docs-sample/reso/autofill

Response:

{
  "@reso.context": "urn:reso:metadata:1.7:resource:property",
  "value": [
    {
      "Country": "CA",
      "StateOrProvince": "ON",
      "City": "Kitchener",
      "PostalCode": "N2G 2L3",
      "StreetName": "King St E",
      "StreetNumber": "301",
      "Media": [
        {
          "ResourceName": "Property",
          "MediaCategory": "Branded Virtual Tour",
          "MediaURL": "https://youriguide.com/api-docs-sample/"
        },
        {
          "ResourceName": "Property",
          "MediaCategory": "Unbranded Virtual Tour",
          "MediaURL": "https://unbranded.youriguide.com/api-docs-sample/"
        },
        {
          "ResourceName": "Property",
          "MediaCategory": "Floor Plan",
          "MediaType": "pdf",
          "MediaURL": "https://youriguide.com/api-docs-sample/doc/floorplan_imperial.pdf",
          "ShortDescription": "imperial"
        },
        {
          "ResourceName": "Property",
          "MediaCategory": "Floor Plan",
          "MediaType": "pdf",
          "MediaURL": "https://youriguide.com/api-docs-sample/doc/floorplan_metric.pdf",
          "ShortDescription": "metric"
        },
        {
          "ResourceName": "Property",
          "MediaCategory": "Floor Plan",
          "MediaType": "jpeg",
          "MediaURL": "https://youriguide.com/api-docs-sample/doc/floor-page_metric_1.jpg",
          "ShortDescription": "metric floor page"
        },
        {
          "ResourceName": "Property",
          "MediaCategory": "Floor Plan",
          "MediaType": "jpeg",
          "MediaURL": "https://youriguide.com/api-docs-sample/doc/floor-page_imperial_1.jpg",
          "ShortDescription": "imperial floor page"
        },
        {
          "ResourceName": "Property",
          "MediaCategory": "Floor Plan",
          "MediaType": "jpeg",
          "MediaURL": "https://youriguide.com/api-docs-sample/doc/floor-page_metric_2.jpg",
          "ShortDescription": "metric floor page"
        },
        {
          "ResourceName": "Property",
          "MediaCategory": "Floor Plan",
          "MediaType": "jpeg",
          "MediaURL": "https://youriguide.com/api-docs-sample/doc/floor-page_imperial_2.jpg",
          "ShortDescription": "imperial floor page"
        },
        ...
        {
          "MediaObjectID": "api-docs-sample:2MPC9G66HF1G.jpg",
          "PreferredPhotoYN": true,
          "ResourceName": "Property",
          "MediaCategory": "Photo",
          "MediaType": "jpeg",
          "MediaURL": "https://youriguide.com/api-docs-sample/f/2MPC9G66HF1G.jpg",
          "ImageHeight": 4265,
          "ImageWidth": 6400
        },
        {
          "MediaObjectID": "api-docs-sample:2MPC9G66HF1G.jpg",
          "PreferredPhotoYN": true,
          "ResourceName": "Property",
          "MediaCategory": "Photo",
          "MediaType": "jpeg",
          "MediaURL": "https://youriguide.com/api-docs-sample/f/2MPC9G66HF1G_m.jpg",
          "ImageHeight": 682,
          "ImageWidth": 1024
        },
        ...
        {
          "MediaObjectID": "api-docs-sample:2MPCAI3U37ZH.jpg",
          "ResourceName": "Property",
          "MediaCategory": "Photo",
          "MediaType": "jpeg",
          "MediaURL": "https://youriguide.com/api-docs-sample/f/2MPCAI3U37ZH.jpg",
          "ImageHeight": 4266,
          "ImageWidth": 6400
        },
        {
          "MediaObjectID": "api-docs-sample:2MPCAI3U37ZH.jpg",
          "ResourceName": "Property",
          "MediaCategory": "Photo",
          "MediaType": "jpeg",
          "MediaURL": "https://youriguide.com/api-docs-sample/f/2MPCAI3U37ZH_m.jpg",
          "ImageHeight": 682,
          "ImageWidth": 1024
        }
      ],
      "BelowGradeInteriorArea": 142.933077,
      "BelowGradeInteriorAreaUnits": "Square Meters",
      "BelowGradeInteriorAreaSource": "iGUIDE",
      "AboveGradeInteriorArea": 337.36767,
      "AboveGradeInteriorAreaUnits": "Square Meters",
      "AboveGradeInteriorAreaSource": "iGUIDE",
      "BelowGradeExteriorArea": 154.964481,
      "BelowGradeExteriorAreaUnits": "Square Meters",
      "BelowGradeExteriorAreaSource": "iGUIDE",
      "AboveGradeExteriorArea": 361.127776,
      "AboveGradeExteriorAreaUnits": "Square Meters",
      "AboveGradeExteriorAreaSource": "iGUIDE",
      "BelowGradeExcludedArea": 17.993266,
      "BelowGradeExcludedAreaUnits": "Square Meters",
      "BelowGradeExcludedAreaSource": "iGUIDE",
      "AboveGradeExcludedArea": 35.444345,
      "AboveGradeExcludedAreaUnits": "Square Meters",
      "AboveGradeExcludedAreaSource": "iGUIDE",
      "BelowGradeFinishedArea": 133.932156,
      "BelowGradeFinishedAreaUnits": "Square Meters",
      "BelowGradeFinishedAreaSource": "iGUIDE",
      "PerimeterWallThickness": 0.203,
      "PerimeterWallThicknessUnits": "Meters",
      "PerimeterWallThicknessSource": "iGUIDE",
      "Rooms": [
        {
          "RoomKey": "65",
          "StructureKey": "1",
          "FloorKey": "1",
          "FloorName": "Main Floor",
          "RoomType": "Dining",
          "RoomName": "Dining",
          "RoomLevel": "Main",
          "RoomWidth": 5.81,
          "RoomLength": 3.204,
          "RoomLengthWidthUnits": "Meters",
          "RoomLengthWidthSource": "iGUIDE",
          "RoomArea": 18.613239,
          "RoomAreaUnits": "Square Meters",
          "RoomAreaSource": "iGUIDE"
        },
        {
          "RoomKey": "126",
          "StructureKey": "1",
          "FloorKey": "1",
          "FloorName": "Main Floor",
          "RoomType": "Living",
          "RoomName": "Family",
          "RoomLevel": "Main",
          "RoomWidth": 5.657,
          "RoomLength": 4.514,
          "RoomLengthWidthUnits": "Meters",
          "RoomLengthWidthSource": "iGUIDE",
          "RoomArea": 25.506103,
          "RoomAreaUnits": "Square Meters",
          "RoomAreaSource": "iGUIDE"
        },
        {
          "RoomKey": "73",
          "StructureKey": "1",
          "FloorKey": "1",
          "FloorName": "Main Floor",
          "RoomType": "Garage",
          "RoomName": "Garage",
          "RoomLevel": "Main",
          "RoomWidth": 5.726,
          "RoomLength": 6.065,
          "RoomLengthWidthUnits": "Meters",
          "RoomLengthWidthSource": "iGUIDE",
          "RoomArea": 32.248413,
          "RoomAreaUnits": "Square Meters",
          "RoomAreaSource": "iGUIDE"
        },
        {
          "RoomKey": "72",
          "StructureKey": "1",
          "FloorKey": "1",
          "FloorName": "Main Floor",
          "RoomType": "Bathroom",
          "RoomName": "2pc Bath",
          "RoomLevel": "Main",
          "RoomWidth": 1.516,
          "RoomLength": 2.033,
          "RoomLengthWidthUnits": "Meters",
          "RoomLengthWidthSource": "iGUIDE",
          "RoomArea": 3.082274,
          "RoomAreaUnits": "Square Meters",
          "RoomAreaSource": "iGUIDE"
        },
        ...
        {
          "RoomKey": "127",
          "StructureKey": "1",
          "FloorKey": "3",
          "FloorName": "Basement",
          "RoomType": "Living",
          "RoomName": "Den",
          "RoomLevel": "Basement",
          "RoomWidth": 5.526,
          "RoomLength": 3.081,
          "RoomLengthWidthUnits": "Meters",
          "RoomLengthWidthSource": "iGUIDE",
          "RoomArea": 16.959129,
          "RoomAreaUnits": "Square Meters",
          "RoomAreaSource": "iGUIDE"
        },
        {
          "RoomKey": "117",
          "StructureKey": "1",
          "FloorKey": "3",
          "FloorName": "Basement",
          "RoomType": "Living",
          "RoomName": "Gym",
          "RoomLevel": "Basement",
          "RoomWidth": 3.784,
          "RoomLength": 3.641,
          "RoomLengthWidthUnits": "Meters",
          "RoomLengthWidthSource": "iGUIDE",
          "RoomArea": 13.778301,
          "RoomAreaUnits": "Square Meters",
          "RoomAreaSource": "iGUIDE"
        },
      ],
      "xPlntrStructures": [
        {
          "StructureKey": "1",
          "StructureName": "Main Building",
          "MainStructureYN": true,
          "BelowGradeInteriorArea": 142.933077,
          "BelowGradeInteriorAreaUnits": "Square Meters",
          "BelowGradeInteriorAreaSource": "iGUIDE",
          "AboveGradeInteriorArea": 337.36767,
          "AboveGradeInteriorAreaUnits": "Square Meters",
          "AboveGradeInteriorAreaSource": "iGUIDE",
          "BelowGradeExteriorArea": 154.964481,
          "BelowGradeExteriorAreaUnits": "Square Meters",
          "BelowGradeExteriorAreaSource": "iGUIDE",
          "AboveGradeExteriorArea": 361.127776,
          "AboveGradeExteriorAreaUnits": "Square Meters",
          "AboveGradeExteriorAreaSource": "iGUIDE",
          "BelowGradeExcludedArea": 17.993266,
          "BelowGradeExcludedAreaUnits": "Square Meters",
          "BelowGradeExcludedAreaSource": "iGUIDE",
          "AboveGradeExcludedArea": 35.444345,
          "AboveGradeExcludedAreaUnits": "Square Meters",
          "AboveGradeExcludedAreaSource": "iGUIDE",
          "BelowGradeFinishedArea": 133.932156,
          "BelowGradeFinishedAreaUnits": "Square Meters",
          "BelowGradeFinishedAreaSource": "iGUIDE",
          "PerimeterWallThickness": 0.203,
          "PerimeterWallThicknessUnits": "Meters",
          "PerimeterWallThicknessSource": "iGUIDE",
          "FloorsTotal": 3,
          "Floors": [
            {
              "FloorKey": "1",
              "StructureKey": "1",
              "FloorName": "Main Floor",
              "InteriorArea": 160.593319,
              "InteriorAreaUnits": "Square Meters",
              "InteriorAreaSource": "iGUIDE",
              "ExteriorArea": 171.862023,
              "ExteriorAreaUnits": "Square Meters",
              "ExteriorAreaSource": "iGUIDE",
              "ExcludedArea": 34.803838,
              "ExcludedAreaUnits": "Square Meters",
              "ExcludedAreaSource": "iGUIDE",
              "PerimeterWallLength": 60.025,
              "PerimeterWallLengthUnits": "Meters",
              "PerimeterWallLengthSource": "iGUIDE",
              "PerimeterWallThickness": 0.203,
              "PerimeterWallThicknessUnits": "Meters",
              "PerimeterWallThicknessSource": "iGUIDE",
              "RoomsTotal": 8,
              "Rooms": [
                {
                  "RoomKey": "72",
                  "StructureKey": "1",
                  "FloorKey": "1",
                  "FloorName": "Main Floor",
                  "RoomType": "Bathroom",
                  "RoomName": "2pc Bath",
                  "RoomLevel": "Main",
                  "RoomWidth": 1.516,
                  "RoomLength": 2.033,
                  "RoomLengthWidthUnits": "Meters",
                  "RoomLengthWidthSource": "iGUIDE",
                  "RoomArea": 3.082274,
                  "RoomAreaUnits": "Square Meters",
                  "RoomAreaSource": "iGUIDE"
                },
                ...
              ]
            },
            {
              "FloorKey": "2",
              "StructureKey": "1",
              "FloorName": "2nd Floor",
              ...
              "Rooms": [ ... ]
            },
            {
              "FloorKey": "3",
              "StructureKey": "1",
              "FloorName": "Basement",
              "BelowGradeYN": true,
              ...
              "Rooms": [ ... ]
            }
          ]
        },
        {
          "StructureKey": "2",
          "StructureName": "New Building",
          "AboveGradeExcludedArea": 8.698463,
          "AboveGradeExcludedAreaUnits": "Square Meters",
          "AboveGradeExcludedAreaSource": "iGUIDE",
          "FloorsTotal": 1,
          "Floors": [ ... ]
        }
      ]
    }
  ]
}

Types

Autofill Object

TIP

This object is compliant with the approved RCP-022: RESO Autofill Service.

PropertyTypeDescription
 The following are RESO-DD Address Group fields
CountrystringCountry abbreviation in a postal address.
StateOrProvincestringText field containing the accepted postal abbreviation for a state or province.
CitystringCity in a postal address.
PostalCodestringPostal code portion of a street or mailing address.
StreetNamestringStreet name portion of a property's street address.
StreetNumberstringStreet number portion of a property's street address.
UnitNumberstringText field containing the number or portion of a larger building or complex.
 The following are RESO-DD Media Group fields
MediaArray of Media ObjectList of media objects with their URLs
RoomsArray of PropertyRoom ObjectList of room objects
 The following are RESO-DD Structure Group fields
AboveGradeFinishedAreafloatThe finished area of the structure that is above grade.
AboveGradeFinishedAreaUnitsstringThe unit of measurement used for the value in the AboveGradeFinishedArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
AboveGradeFinishedAreaSourcestringThe source of the measurement of the AboveGradeFinishedArea property. Always set to iGUIDE if AboveGradeFinishedArea is present.
 
BelowGradeFinishedAreafloatThe finished area of the structure that is below grade.
BelowGradeFinishedAreaUnitsstringThe unit of measurement used for the value in the BelowGradeFinishedArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
BelowGradeFinishedAreaSourcestringThe source of the measurement of the BelowGradeFinishedArea property. Always set to iGUIDE if BelowGradeFinishedArea is present.
 
 The following fields have not yet been added to the RESO Data Dictionary
BelowGradeInteriorAreafloatThe interior area of the structure that is below grade (surface of the ground adjacent to foundation).
BelowGradeInteriorAreaUnitsstringThe unit of measurement used for the value in the BelowGradeInteriorArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
BelowGradeInteriorAreaSourcestringThe source of the measurement of the BelowGradeInteriorArea property. Always set to iGUIDE if BelowGradeInteriorArea is present.
 
AboveGradeInteriorAreafloatThe interior area of the structure that is above grade.
AboveGradeInteriorAreaUnitsstringThe unit of measurement used for the value in the AboveGradeInteriorArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
AboveGradeInteriorAreaSourcestringThe source of the measurement of the AboveGradeInteriorArea property. Always set to iGUIDE if AboveGradeInteriorArea is present.
 
BelowGradeExteriorAreafloatThe exterior area of the structure that is below grade.
BelowGradeExteriorAreaUnitsstringThe unit of measurement used for the value in the BelowGradeExteriorArea property. Possible values: Square Feet or Square Meters, see AreaUnits Lookups.
BelowGradeExteriorAreaSourcestringThe source of the measurement of the BelowGradeExteriorArea property. Always set to iGUIDE if BelowGradeExteriorArea is present.
 
AboveGradeExteriorAreafloatThe exterior area of the structure that is above grade.
AboveGradeExteriorAreaUnitsstringThe unit of measurement used for the value in the AboveGradeExteriorArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
AboveGradeExteriorAreaSourcestringThe source of the measurement of the AboveGradeExteriorArea property. Always set to iGUIDE if AboveGradeExteriorArea is present.
 
BelowGradeExcludedAreafloatThe excluded area of the structure that is below grade.
BelowGradeExcludedAreaUnitsstringThe unit of measurement used for the value in the BelowGradeExcludedArea property. Possible values: Square Feet or Square Meters, see AreaUnits Lookups.
BelowGradeExcludedAreaSourcestringThe source of the measurement of the BelowGradeExcludedArea property. Always set to iGUIDE if BelowGradeExcludedArea is present.
 
AboveGradeExcludedAreafloatThe excluded area of the structure that is above grade.
AboveGradeExcludedAreaUnitsstringThe unit of measurement used for the value in the AboveGradeExcludedArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
AboveGradeExcludedAreaSourcestringThe source of the measurement of the AboveGradeExcludedArea property. Always set to iGUIDE if AboveGradeExcludedArea is present.
 
BelowGradeUnfinishedAreafloatThe unfinished area of the structure that is below grade.
BelowGradeUnfinishedAreaUnitsstringThe unit of measurement used for the value in the BelowGradeUnfinishedArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
BelowGradeUnfinishedAreaSourcestringThe source of the measurement of the BelowGradeUnfinishedArea property. Always set to iGUIDE if BelowGradeUnfinishedArea is present.
 
AboveGradeUnfinishedAreafloatThe unfinished area of the structure that is above grade.
AboveGradeUnfinishedAreaUnitsstringThe unit of measurement used for the value in the AboveGradeUnfinishedArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
AboveGradeUnfinishedAreaSourcestringThe source of the measurement of the AboveGradeUnfinishedArea property. Always set to iGUIDE if AboveGradeUnfinishedArea is present.
 
PerimeterWallThicknessfloatThe thickness of the exterior wall of the structure.
PerimeterWallThicknessUnitsstringThe unit of measurement used for the value in the PerimeterWallThickness property. Possible values: Feet or Meters, see RESO-DD LinearUnits Lookups.
PerimeterWallThicknessSourcestringThe source of the measurement of the PerimeterWallThickness property. Always set to iGUIDE if PerimeterWallThickness is present.
 The following are Planitar-specific fields, not part of RESO DataDictionaryL
xPlntrStructures
non-RESO
Array of PropertyStructure ObjectList of structures including nested objects such as floors and rooms

PropertyRoom Object

This type describes a single room.

TIP

This type corresponds to RESO-DD PropertyRooms Resource.

PropertyTypeDescription
RoomKeystringThe unique identifier for the room.
FloorKeystringThe unique identifier of the floor this room belongs to.
FloorName
non-RESO
stringThe name of the floor this room belongs to.
StructureKeystringThe unique identifier of the structure this room belongs to.
RoomTypestringThe room's type. Common values: Outdoor, Bedroom, Living, Bathroom, Kitchen, Storage, Garage, Unfinished, Stairs, Office, Dining, Laundry, Utility, ColdRoom, Other.
RoomNamestringThe user-defined name for the room.
RoomLevel
DD 2.0
stringThe room's level. See RESO-DD RoomLevel Lookups
Note: The support of this field is experimental. The value may be missing. Consider using Autofill Object's xPlntrStructures instead. Its implementation is complete and stable.
RoomAreafloatThe interior area of the room.
RoomAreaUnitsstringThe unit of measurement used for the value in the RoomArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
RoomAreaSourcestringThe source of the measurement of the RoomArea property. Always set to iGUIDE if RoomArea is present.
RoomWidthfloatThe width of the room.
RoomLengthfloatThe length of the room.
RoomWidthLengthUnitsstringThe unit of measurement used for the value in the RoomWidthLength property. Possible values: Feet or Meters, see RESO-DD LinearUnits Lookups.
RoomWidthLengthSourcestringThe source of the measurement of the RoomWidth and RoomLength properties. Always set to iGUIDE if the dimensions are present.

Example:

{
  "RoomKey": "28",
  "FloorKey": "2",
  "FloorName": "Downstairs",
  "StructureKey": "3",
  "RoomType": "Bedroom",
  "RoomName": "Master Bedroom",
  "RoomLevel": "Basement",
  "RoomArea": 13.0012,
  "RoomAreaUnits": "Square Meters",
  "RoomAreaSource": "iGUIDE",
  "RoomWidth": 3.075,
  "RoomLength": 4.266,
  "RoomLengthWidthUnits": "Meters",
  "RoomLengthWidthSource": "iGUIDE"
}

Media Object

TIP

This type corresponds to RESO-DD Media Resource.

PropertyTypeDescription
MediaCategorystringCategory describing record. Possible values: Branded Virtual Tour, Unbranded Virtual Tour, Floor Plan, Photo and Video; see MediaCategory Lookups.
MediaTypestringMedia Types as defined by IANA. Possible values: pdf, jpeg, png or gif.
MediaURLstringThe URL to the media referenced by the record.
MediaHTMLstringHTML code to embed the media referenced by the record, e.g. virtual tour, image, video.
ShortDescriptionstringThe short text used to describe the media. This field is used to distinguish PDF floor plans in imperial units from those in metric units. The value will be set to imperial for PDF floor plans in imperial units and metric for PDF floor plans in metric units.
ImageHeightintThe height of the image expressed in pixels.
ImageWidthintThe width of the image expressed in pixels.
PreferredPhotoYNbooleanA flag indicating that the media record is the preferred photo. This will typically mean the photo to be shown when only one of the photos is to be displayed.
MediaObjectIDstringThe unique identifier of the underlying resource specified by the given media record.
Set for images only. Media records specifying different resolutions of the same image will have same the MediaObjectID value.
ResourceNamestringThe resource or table of the listing or other record the media relates to. Possible values: Property, Member, Office or Contacts; see ResourceName Lookups.

TIP

The ShortDescription field is used to distinguish PDF floor plans in imperial units from those in metric units. Possible values for PDF floor plans are:

  • imperial for PDF floor plans in imperial units
  • metric for PDF floor plans in metric units

Examples

Virtual Tour records:

[
  {
    "ResourceName": "Property",
    "MediaCategory": "Branded Virtual Tour",
    "MediaURL": "https://youriguide.com/api-docs-sample/"
  },
  {
    "ResourceName": "Property",
    "MediaCategory": "Unbranded Virtual Tour",
    "MediaURL": "https://unbranded.youriguide.com/api-docs-sample/"
  }
]

PDF floor plan records:

[
  {
    "ResourceName": "Property",
    "MediaCategory": "Floor Plan",
    "MediaType": "pdf",
    "MediaURL": "https://youriguide.com/api-docs-sample/doc/floorplan_imperial.pdf",
    "ShortDescription": "imperial"
  },
  {
    "ResourceName": "Property",
    "MediaCategory": "Floor Plan",
    "MediaType": "pdf",
    "MediaURL": "https://youriguide.com/api-docs-sample/doc/floorplan_metric.pdf",
    "ShortDescription": "metric"
  }
]

JPEG floor plan records (one image per floor):

[
  {
    "ResourceName": "Property",
    "MediaCategory": "Floor Plan",
    "MediaType": "jpeg",
    "MediaURL": "https://youriguide.com/api-docs-sample/doc/floor-page_metric_1.jpg",
    "ShortDescription": "metric floor page"
  },
  {
    "ResourceName": "Property",
    "MediaCategory": "Floor Plan",
    "MediaType": "jpeg",
    "MediaURL": "https://youriguide.com/api-docs-sample/doc/floor-page_imperial_1.jpg",
    "ShortDescription": "imperial floor page"
  },
  {
    "ResourceName": "Property",
    "MediaCategory": "Floor Plan",
    "MediaType": "jpeg",
    "MediaURL": "https://youriguide.com/api-docs-sample/doc/floor-page_metric_2.jpg",
    "ShortDescription": "metric floor page"
  },
  {
    "ResourceName": "Property",
    "MediaCategory": "Floor Plan",
    "MediaType": "jpeg",
    "MediaURL": "https://youriguide.com/api-docs-sample/doc/floor-page_imperial_2.jpg",
    "ShortDescription": "imperial floor page"
  }
]

Records for different resolutions of the same image:

[
  {
    "MediaObjectID": "api-docs-sample:2MPC9G66HF1G.jpg",
    "PreferredPhotoYN": true,
    "ResourceName": "Property",
    "MediaCategory": "Photo",
    "MediaType": "jpeg",
    "MediaURL": "https://youriguide.com/api-docs-sample/f/2MPC9G66HF1G.jpg",
    "ImageHeight": 4265,
    "ImageWidth": 6400
  },
  {
    "MediaObjectID": "api-docs-sample:2MPC9G66HF1G.jpg",
    "PreferredPhotoYN": true,
    "ResourceName": "Property",
    "MediaCategory": "Photo",
    "MediaType": "jpeg",
    "MediaURL": "https://youriguide.com/api-docs-sample/f/2MPC9G66HF1G_m.jpg",
    "ImageHeight": 682,
    "ImageWidth": 1024
  }
]

Video record:

{
  "ResourceName": "Property",
  "MediaCategory": "Video",
  "MediaURL": "https://youtu.be/DobXEWPLpKI"
}

PropertyStructure Object

This type describes a standalone structure (building) of the property. Every property has at least one structure that is the main building.

EXPERIMENTAL

This type is compliant with RCP-022: RESO Autofill Service that is not approved yet.

PropertyTypeDescription
StructureKeystringThe unique identifier for the structure.
StructureNamestringThe user-defined name for the structure.
MainStructureYNbooleanA flag indicating whether it is the main structure of the property.
 
BelowGradeInteriorAreafloatThe interior area of the structure that is below grade (surface of the ground adjacent to foundation).
BelowGradeInteriorAreaUnitsstringThe unit of measurement used for the value in the BelowGradeInteriorArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
BelowGradeInteriorAreaSourcestringThe source of the measurement of the BelowGradeInteriorArea property. Always set to iGUIDE if BelowGradeInteriorArea is present.
 
AboveGradeInteriorAreafloatThe interior area of the structure that is above grade.
AboveGradeInteriorAreaUnitsstringThe unit of measurement used for the value in the AboveGradeInteriorArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
AboveGradeInteriorAreaSourcestringThe source of the measurement of the AboveGradeInteriorArea property. Always set to iGUIDE if AboveGradeInteriorArea is present.
 
BelowGradeExteriorAreafloatThe exterior area of the structure that is below grade.
BelowGradeExteriorAreaUnitsstringThe unit of measurement used for the value in the BelowGradeExteriorArea property. Possible values: Square Feet or Square Meters, see AreaUnits Lookups.
BelowGradeExteriorAreaSourcestringThe source of the measurement of the BelowGradeExteriorArea property. Always set to iGUIDE if BelowGradeExteriorArea is present.
 
AboveGradeExteriorAreafloatThe exterior area of the structure that is above grade.
AboveGradeExteriorAreaUnitsstringThe unit of measurement used for the value in the AboveGradeExteriorArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
AboveGradeExteriorAreaSourcestringThe source of the measurement of the AboveGradeExteriorArea property. Always set to iGUIDE if AboveGradeExteriorArea is present.
 
AboveGradeFinishedAreafloatThe finished area of the structure that is above grade.
AboveGradeFinishedAreaUnitsstringThe unit of measurement used for the value in the AboveGradeFinishedArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
AboveGradeFinishedAreaSourcestringThe source of the measurement of the AboveGradeFinishedArea property. Always set to iGUIDE if AboveGradeFinishedArea is present.
 
BelowGradeFinishedAreafloatThe finished area of the structure that is below grade.
BelowGradeFinishedAreaUnitsstringThe unit of measurement used for the value in the BelowGradeFinishedArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
BelowGradeFinishedAreaSourcestringThe source of the measurement of the BelowGradeFinishedArea property. Always set to iGUIDE if BelowGradeFinishedArea is present.
 
PerimeterWallThicknessfloatThe thickness of the exterior wall of the structure.
PerimeterWallThicknessUnitsstringThe unit of measurement used for the value in the PerimeterWallThickness property. Possible values: Feet or Meters, see RESO-DD LinearUnits Lookups.
PerimeterWallThicknessSourcestringThe source of the measurement of the PerimeterWallThickness property. Always set to iGUIDE if PerimeterWallThickness is present.
 
FloorsTotalintThe total number of floors in the structure.
FloorsArray of PropertyFloor Object

Example:

{
  "StructureKey": "1",
  "StructureName": "Main Building",
  "MainStructureYN": true,
  "BelowGradeInteriorArea": 142.933077,
  "BelowGradeInteriorAreaUnits": "Square Meters",
  "BelowGradeInteriorAreaSource": "iGUIDE",
  "AboveGradeInteriorArea": 337.36767,
  "AboveGradeInteriorAreaUnits": "Square Meters",
  "AboveGradeInteriorAreaSource": "iGUIDE",
  "BelowGradeExteriorArea": 154.964481,
  "BelowGradeExteriorAreaUnits": "Square Meters",
  "BelowGradeExteriorAreaSource": "iGUIDE",
  "AboveGradeExteriorArea": 361.127776,
  "AboveGradeExteriorAreaUnits": "Square Meters",
  "AboveGradeExteriorAreaSource": "iGUIDE",
  "BelowGradeExcludedArea": 17.993266,
  "BelowGradeExcludedAreaUnits": "Square Meters",
  "BelowGradeExcludedAreaSource": "iGUIDE",
  "AboveGradeExcludedArea": 35.444345,
  "AboveGradeExcludedAreaUnits": "Square Meters",
  "AboveGradeExcludedAreaSource": "iGUIDE",
  "BelowGradeFinishedArea": 133.932156,
  "BelowGradeFinishedAreaUnits": "Square Meters",
  "BelowGradeFinishedAreaSource": "iGUIDE",
  "PerimeterWallThickness": 0.203,
  "PerimeterWallThicknessUnits": "Meters",
  "PerimeterWallThicknessSource": "iGUIDE",
  "FloorsTotal": 3,
  "Floors": [ ... ]
}

PropertyFloor Object

This type describes a single floor. Every property has at least one floor.

EXPERIMENTAL

This type is compliant with RCP-022: RESO Autofill Service that is not approved yet.

PropertyTypeDescription
FloorKeystringThe unique identifier for the floor.
StructureKeystringThe unique identifier for the structure the floor belongs to.
FloorNamestringThe user-defined name for the floor.
BelowGradeYNbooleanA flag indicating whether the floor is below grade.
InteriorAreafloatThe interior area of the floor.
InteriorAreaUnitsstringThe unit of measurement used for the value in the InteriorArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
InteriorAreaSourcestringThe source of the measurement of the InteriorArea property. Always set to iGUIDE if InteriorArea is present.
ExteriorAreafloatThe exterior area of the floor.
ExteriorAreaUnitsstringThe unit of measurement used for the value in the ExteriorArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
ExteriorAreaSourcestringThe source of the measurement of the ExteriorArea property. Always set to iGUIDE if ExteriorArea is present.
FinishedAreafloatThe finished area of the floor.
FinishedAreaUnitsstringThe unit of measurement used for the value in the FinishedArea property. Possible values: Square Feet or Square Meters, see RESO-DD AreaUnits Lookups.
FinishedAreaSourcestringThe source of the measurement of the FinishedArea property. Always set to iGUIDE if FinishedArea is present.
PerimeterWallLengthfloatThe perimeter length of the exterior wall of the floor.
PerimeterWallLengthUnitsstringThe unit of measurement used for the value in the PerimeterWallLength property. Possible values: Feet or Meters, see RESO-DD LinearUnits Lookups.
PerimeterWallLengthSourcestringThe source of the measurement of the PerimeterWallLength property. Always set to iGUIDE if PerimeterWallLength is present.
PerimeterWallThicknessfloatThe thickness of exterior wall of the floor.
PerimeterWallThicknessUnitsstringThe unit of measurement used for the value in the PerimeterWallThickness property. Possible values: Feet or Meters, see RESO-DD LinearUnits Lookups.
PerimeterWallThicknessSourcestringThe source of the measurement of the PerimeterWallThickness property. Always set to iGUIDE if PerimeterWallThickness is present.
RoomsTotalintThe total number of rooms in the floor.
RoomsArray of PropertyRoom Object

Example:

{
  "FloorKey": "1",
  "StructureKey": "1",
  "FloorName": "MAIN FLOOR",
  "InteriorArea": 146.17929917836838,
  "InteriorAreaUnits": "Square Meters",
  "InteriorAreaSource": "iGUIDE",
  "ExteriorArea": 160.0571592075057,
  "ExteriorAreaUnits": "Square Meters",
  "ExteriorAreaSource": "iGUIDE",
  "FinishedArea": 160.0571592075057,
  "FinishedAreaUnits": "Square Meters",
  "FinishedAreaSource": "iGUIDE",
  "PerimeterWallLength": 55.51144011654928,
  "PerimeterWallLengthUnits": "Meters",
  "PerimeterWallLengthSource": "iGUIDE",
  "PerimeterWallThickness": 0.2,
  "PerimeterWallThicknessUnits": "Meters",
  "PerimeterWallThicknessSource": "iGUIDE",
  "RoomsTotal": 7,
  "Rooms": [ ... ]
}
Last Updated:
Prev
Introduction
Next
View API