SightMap® Logo
API docs by Redocly

SightMap® REST API (v1.20230329)

Download OpenAPI specification:Download

URL: https://developers.sightmap.com License: Engrain Terms of Service

Introduction

The SightMap® API uses standard HTTP verbs to communicate and HTTP status codes to indicate status and errors. All responses come in standard JSON. The SightMap API is served over HTTPS to ensure data privacy; HTTP is not supported.

Versioning

Versions are communicated as VERSION.RELEASE-DATE, where VERSION denotes the version number of the API and prefixed to all API request paths, such as /v1/assets. RELEASE-DATE denotes backwards-compatible changes to the API.

When any non-backwards compatible additions must be made to the API, the version number will be incremented.

Backwards-compatible changes

We consider the following changes to be backwards-compatible:

  • Adding new API resources.
  • Adding new optional request parameters to existing API methods.
  • Adding new properties to existing API responses.
  • Changing the order of properties in existing API responses.
  • Changing the length or format of object IDs or other opaque strings.
  • You can safely assume object IDs we generate will never exceed 255 characters, but you should be able to handle IDs of up to that length. If for example you’re using MySQL, you should store IDs in a VARCHAR(255) COLLATE utf8_bin column (the COLLATE configuration ensures case-sensitivity in lookups).

Authentication

For requests which require Authentication, an API Key can be provided by either the api-key query parameter or API-Key header. We recommend the header over the query parameter as it avoids your API key from being stored in browser history and most server logs. If neither query parameter or header is provided, a 401 status code is returned with the following JSON:

{
  "message": "No API key found in request"
}

If your API key cannot be validated, a 403 status code is returned with the following JSON:

{
  "message": "Invalid authentication credentials"
}

API Key

An API key sent via the API-Key header.

curl -i -H "API-Key: 12345" https://api.sightmap.com/v1/assets
Security Scheme Type: API Key
Header parameter name: API-Key

Experimental features

We provide new API features via experimental flags. This allows users to opt-in for new functionality and provide feedback prior to a feature becoming generally available (GA). We believe in stability without stagnation. This ability allows our team to build and ship best-in-class APIs faster while upholding backwards-compatibility on GA features.

Experimental features are subject to change while undergoing development and feedback. Therefore, they are exempt from any backwards-compatibility guarantees until they reach GA. We do not expect nor recommend using experimental features in production environments unless a partnership has been established with our teams working closely together.

Flags are provided via the Experimental-Flags header. A comma-separated list is expected in order to pass multiple flags on a single request.

curl -i https://api.sightmap.com/v1/assets \
  -H "API-Key: 12345" \
  -H "Experimental-Flags: flag-1,flag-2"

Errors

The SightMap API uses standard HTTP status codes to indicate the success or failure of the API request. The body of the response will be JSON in the following format:

{
  "message": "Not found"
}

Accounts

List accounts

Returns a list of accounts.

Authorizations:
API Key
query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

View an account

Returns a specific account.

Authorizations:
API Key
path Parameters
account
required
string <id> <= 255 characters

An account ID.

Responses

Response samples

Content type
application/json
{
  • "id": "95",
  • "name": "Engrain",
  • "created_at": "2017-09-11T17:09:18+00:00",
  • "updated_at": "2017-09-11T17:09:18+00:00"
}

Embeds

List embeds

Returns a list of embeds for an account.

Requires sightmap.embeds.read permission.

NOTICE: This resource is experimental and requires the embed-resource experimental flag.

Authorizations:
API Key
path Parameters
account
required
string <id> <= 255 characters

An account ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

asset
string <id> <= 255 characters

An asset ID to filter the list on.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the embed-resource experimental flag.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

View an embed

Returns a specific embed.

Requires sightmap.embeds.read permission.

NOTICE: This resource is experimental and requires the embed-resource experimental flag.

Authorizations:
API Key
path Parameters
account
required
string <id> <= 255 characters

An account ID.

embed
required
string <id> <= 255 characters

An embed ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the embed-resource experimental flag.

Responses

Response samples

Content type
application/json
{
  • "id": "5587",
  • "account_id": "95",
  • "name": "The Lofts at New Main",
  • "url": "https://sightmap.com/embed/960p78rdw7n",
  • "sightmaps": [
    • {
      }
    ],
  • "created_at": "2020-10-30T15:16:35+00:00",
  • "updated_at": "2020-11-04T23:45:31+00:00"
}

Assets

List assets

Returns a list of allowed assets on an account.

NOTICE: This resource is experimental and requires the accounts-assets experimental flag.

path Parameters
account
required
string <id> <= 255 characters

An account ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

asset
string <id> <= 255 characters

An asset ID to filter the list on.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the accounts-assets experimental flag.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Assign assets

Assign one or more assets to an account.

Requires sightmap.accounts.update-assets permission.

NOTICE: This resource is experimental and requires the accounts-assets experimental flag.

Authorizations:
API Key
path Parameters
account
required
string <id> <= 255 characters

An account ID.

Request Body schema: application/json
required
Array of objects
Array
account_id
required
string <id> <= 255 characters
asset_id
required
string <id> <= 255 characters

The asset assigned on the account.

Responses

Request samples

Content type
application/json
{
  • "data": [
    • {
      },
    • {
      },
    • {
      }
    ]
}

Response samples

Content type
application/json
{
  • "message": "No API key found in request"
}

Unassign assets

Unassign one or more assets from an account.

Requires sightmap.accounts.update-assets permission.

NOTICE: This resource is experimental and requires the accounts-assets experimental flag.

WARNING: When an asset is unassigned from an account, any embeds or other related data may be deleted and cannot be undone.

Authorizations:
API Key
path Parameters
account
required
string <id> <= 255 characters

An account ID.

Request Body schema: application/json
required
Array of objects
Array
account_id
required
string <id> <= 255 characters
asset_id
required
string <id> <= 255 characters

The asset assigned on the account.

Responses

Request samples

Content type
application/json
{
  • "data": [
    • {
      },
    • {
      }
    ]
}

Response samples

Content type
application/json
{
  • "message": "No API key found in request"
}

Assets

List assets

Returns a list of allowed assets.

Authorizations:
API Key
query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Create an asset

Requires sightmap.assets.create permission

Authorizations:
API Key
Request Body schema: application/json
market
required
string
Enum: "affordable_housing" "agriculture" "airplane" "airport" "build_to_rent" "camping" "cemetery" "condos" "coworking" "cruise_ship" "cultural" "data_center" "demo" "education" "entertainment" "gallery_museum" "geography" "government" "harbor_marina" "healthcare" "hospitality" "industrial" "infrastructure" "land" "logistics" "manufactured_housing" "master_planned" "military_housing" "mixed_use" "multifamily" "office" "oil_and_gas" "other" "parking" "rentable_items" "resort" "retail" "salon" "self_storage" "senior_living" "single_family" "spa" "stadium_arena" "student" "theme_park" "transit"
name
required
string <= 255 characters
display_name
required
string <= 255 characters
description
string or null <= 255 characters
address_line1
required
string <= 63 characters
address_line2
string or null <= 63 characters
address_city
required
string <= 63 characters
address_state
required
string = 2 characters

Two letter abbreviated state or province.

address_country
required
string = 3 characters

An ISO 3166-1 alpha-3 country code.

address_postal_code
required
string <= 15 characters
address_latitude
number or null <float> [ -90 .. 90 ]
address_longitude
number or null <float> [ -180 .. 180 ]

Responses

Request samples

Content type
application/json
{
  • "market": "multifamily",
  • "name": "The Lofts at New Main",
  • "display_name": "The Lofts at New Main",
  • "description": null,
  • "address_line1": "100 New Main St",
  • "address_line2": null,
  • "address_city": "Cleveland",
  • "address_state": "OH",
  • "address_country": "USA",
  • "address_postal_code": "91801",
  • "address_latitude": 41.433243,
  • "address_longitude": -81.3941872
}

Response samples

Content type
application/json
{
  • "id": "1323",
  • "uuid": "d5779fbb-43fe-4d54-b642-266ce815a3f3",
  • "market": "multifamily",
  • "name": "The Lofts at New Main",
  • "display_name": "The Lofts at New Main",
  • "description": null,
  • "unit_count": 138,
  • "address_line1": "100 New Main St",
  • "address_line2": null,
  • "address_city": "Cleveland",
  • "address_state": "OH",
  • "address_country": "USA",
  • "address_postal_code": "91801",
  • "address_latitude": 41.433243,
  • "address_longitude": -81.3941872,
  • "created_at": "2017-09-11T17:08:59+00:00",
  • "updated_at": "2019-10-10T04:25:58+00:00"
}

View an asset

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

Responses

Response samples

Content type
application/json
{
  • "id": "1323",
  • "uuid": "d5779fbb-43fe-4d54-b642-266ce815a3f3",
  • "market": "multifamily",
  • "name": "The Lofts at New Main",
  • "display_name": "The Lofts at New Main",
  • "description": null,
  • "unit_count": 138,
  • "address_line1": "100 New Main St",
  • "address_line2": null,
  • "address_city": "Cleveland",
  • "address_state": "OH",
  • "address_country": "USA",
  • "address_postal_code": "91801",
  • "address_latitude": 41.433243,
  • "address_longitude": -81.3941872,
  • "created_at": "2017-09-11T17:08:59+00:00",
  • "updated_at": "2019-10-10T04:25:58+00:00"
}

Update an asset

Requires sightmap.assets.update permission

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

Request Body schema: application/json
id
required
string <id> <= 255 characters
market
string
Enum: "affordable_housing" "agriculture" "airplane" "airport" "build_to_rent" "camping" "cemetery" "condos" "coworking" "cruise_ship" "cultural" "data_center" "demo" "education" "entertainment" "gallery_museum" "geography" "government" "harbor_marina" "healthcare" "hospitality" "industrial" "infrastructure" "land" "logistics" "manufactured_housing" "master_planned" "military_housing" "mixed_use" "multifamily" "office" "oil_and_gas" "other" "parking" "rentable_items" "resort" "retail" "salon" "self_storage" "senior_living" "single_family" "spa" "stadium_arena" "student" "theme_park" "transit"
name
string <= 255 characters
display_name
string <= 255 characters
description
string or null <= 255 characters
address_line1
string <= 63 characters
address_line2
string or null <= 63 characters
address_city
string <= 63 characters
address_state
string = 2 characters

Two letter abbreviated state or province.

address_country
string = 3 characters

An ISO 3166-1 alpha-3 country code.

address_postal_code
string <= 15 characters
address_latitude
number or null <float> [ -90 .. 90 ]
address_longitude
number or null <float> [ -180 .. 180 ]

Responses

Request samples

Content type
application/json
{
  • "id": "1323",
  • "market": "multifamily",
  • "name": "The Lofts at New Main",
  • "display_name": "The Lofts at New Main",
  • "address_line1": "100 New Main St",
  • "address_city": "Cleveland",
  • "address_state": "OH",
  • "address_country": "USA",
  • "address_postal_code": "91801",
  • "address_latitude": 41.433243,
  • "address_longitude": -81.3941872
}

Response samples

Content type
application/json
{
  • "id": "1323",
  • "uuid": "d5779fbb-43fe-4d54-b642-266ce815a3f3",
  • "market": "multifamily",
  • "name": "The Lofts at New Main",
  • "display_name": "The Lofts at New Main",
  • "description": null,
  • "unit_count": 138,
  • "address_line1": "100 New Main St",
  • "address_line2": null,
  • "address_city": "Cleveland",
  • "address_state": "OH",
  • "address_country": "USA",
  • "address_postal_code": "91801",
  • "address_latitude": 41.433243,
  • "address_longitude": -81.3941872,
  • "created_at": "2017-09-11T17:08:59+00:00",
  • "updated_at": "2019-10-10T04:25:58+00:00"
}

Units

List units

Returns a list of units for an asset.

Requires sightmap.units.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

unit-number
string <= 255 characters

A unit number to filter the list on.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Create a unit

Create a unit for an asset.

Requires sightmap.units.create permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

Request Body schema:
asset_id
required
string <id> <= 255 characters

The asset the unit belongs to.

building_id
required
string <id> <= 255 characters

The building the unit is in.

floor_id
required
string <id> <= 255 characters

The floor the unit is on.

floor_plan_id
required
string <id> <= 255 characters

The floor plan of the unit.

unit_number
required
string <= 255 characters

The unit number.

area
required
integer <int32> >= 0

The area of the unit represented as square footage or square meters.

Responses

Request samples

Content type
{
  • "asset_id": "1323",
  • "building_id": "8265",
  • "floor_id": "4730",
  • "floor_plan_id": "14641",
  • "unit_number": "E13",
  • "area": 700
}

Response samples

Content type
application/json
{
  • "id": "258670",
  • "asset_id": "1323",
  • "building_id": "8265",
  • "floor_id": "4730",
  • "floor_plan_id": "14641",
  • "map_id": "258670",
  • "unit_number": "E13",
  • "area": 700,
  • "view_image_url": null,
  • "secondary_view_image_url": null,
  • "created_at": "2017-09-11T17:09:18+00:00",
  • "updated_at": "2018-01-20T03:44:39+00:00"
}

View a unit

Returns a specific unit.

Requires sightmap.units.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

unit
required
string <id> <= 255 characters

A unit ID.

Responses

Response samples

Content type
application/json
{
  • "id": "258670",
  • "asset_id": "1323",
  • "building_id": "8265",
  • "floor_id": "4730",
  • "floor_plan_id": "14641",
  • "map_id": "258670",
  • "unit_number": "E13",
  • "area": 700,
  • "view_image_url": null,
  • "secondary_view_image_url": null,
  • "created_at": "2017-09-11T17:09:18+00:00",
  • "updated_at": "2018-01-20T03:44:39+00:00"
}

Update a unit

Requires sightmap.units.update permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

unit
required
string <id> <= 255 characters

A unit ID.

Request Body schema:
id
required
string <id> <= 255 characters
asset_id
required
string <id> <= 255 characters

The asset the unit belongs to.

building_id
string <id> <= 255 characters

The building the unit is in.

floor_id
string <id> <= 255 characters

The floor the unit is on.

floor_plan_id
string <id> <= 255 characters

The floor plan of the unit.

unit_number
string <= 255 characters

The unit number.

area
integer <int32> >= 0

The area of the unit represented as square footage or square meters.

view_image
string
Value: "delete"

Delete the primary view image of the unit.

secondary_view_image
string
Value: "delete"

Delete the secondary view image of the unit.

Responses

Request samples

Content type
{
  • "id": "258670",
  • "asset_id": "1323",
  • "building_id": "8265",
  • "floor_id": "4730",
  • "floor_plan_id": "14641",
  • "map_id": "258670",
  • "unit_number": "E13",
  • "area": 700
}

Response samples

Content type
application/json
{
  • "id": "258670",
  • "asset_id": "1323",
  • "building_id": "8265",
  • "floor_id": "4730",
  • "floor_plan_id": "14641",
  • "map_id": "258670",
  • "unit_number": "E13",
  • "area": 700,
  • "view_image_url": null,
  • "secondary_view_image_url": null,
  • "created_at": "2017-09-11T17:09:18+00:00",
  • "updated_at": "2018-01-20T03:44:39+00:00"
}

Delete a unit

Requires sightmap.units.delete permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

unit
required
string <id> <= 255 characters

A unit ID.

Responses

Response samples

Content type
application/json
{
  • "id": "258670",
  • "asset_id": "1323",
  • "building_id": "8265",
  • "floor_id": "4730",
  • "floor_plan_id": "14641",
  • "map_id": "258670",
  • "unit_number": "E13",
  • "area": 700,
  • "view_image_url": null,
  • "secondary_view_image_url": null,
  • "created_at": "2017-09-11T17:09:18+00:00",
  • "updated_at": "2018-01-20T03:44:39+00:00"
}

List unit outbound links

Returns a list of unit outbound links.

Requires sightmap.unit-outbound-links.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Create a unit outbound link

Create a unit outbound link for an asset.

Requires sightmap.unit-outbound-links.create permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

Request Body schema: application/json
One of
asset_id
required
string <id> <= 255 characters

The asset the outbound link belongs to.

type
required
string
Enum: "iframe_api" "url_template" "urls_per_unit"

The type determines how the unit outbound link behaves in the application and what actionable data is stored.

  • url_template: A templated URL which can be generated for all units given a few unit specific variables.
  • urls_per_unit: A list of fully qualified URLs for each unit.
  • iframe_api: The link fires an IFrame API event using a unique key, which is provided via the event_key property. No URL is navigated to.
name
required
string <= 255 characters
label
string or null <= 95 characters

The text label on the outbound link.

event_key
required
string <= 63 characters [a-z0-9-]

A value used in all IFrame event names for the outbound link. For example when event_key is foo, the event name for when the user clicks on the outbound link will be outbound.foo.click.

Responses

Request samples

Content type
application/json
Example
{
  • "asset_id": "1323",
  • "type": "iframe_api",
  • "name": "360 Tour",
  • "label": "View 360 Tour",
  • "event_key": "website360Tour"
}

Response samples

Content type
application/json
Example
{
  • "id": "6011",
  • "asset_id": "1323",
  • "type": "iframe_api",
  • "name": "360 Tour",
  • "label": "View 360 Tour",
  • "event_key": "website360Tour",
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

View a unit outbound link

Returns a specific unit outbound link.

Requires sightmap.unit-outbound-links.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

outbound-link
required
string <id> <= 255 characters

A unit outbound link ID.

Responses

Response samples

Content type
application/json
Example
{
  • "id": "6011",
  • "asset_id": "1323",
  • "type": "iframe_api",
  • "name": "360 Tour",
  • "label": "View 360 Tour",
  • "event_key": "website360Tour",
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

Update a unit outbound link

Requires sightmap.unit-outbound-links.create permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

outbound-link
required
string <id> <= 255 characters

A unit outbound link ID.

Request Body schema: application/json
One of
id
required
string <id> <= 255 characters
asset_id
required
string <id> <= 255 characters

The asset the outbound link belongs to.

type
required
string
Enum: "iframe_api" "url_template" "urls_per_unit"

The type determines how the unit outbound link behaves in the application and what actionable data is stored.

  • url_template: A templated URL which can be generated for all units given a few unit specific variables.
  • urls_per_unit: A list of fully qualified URLs for each unit.
  • iframe_api: The link fires an IFrame API event using a unique key, which is provided via the event_key property. No URL is navigated to.
name
string <= 255 characters
label
string or null <= 95 characters

The text label on the outbound link.

event_key
string <= 63 characters [a-z0-9-]

A value used in all IFrame event names for the outbound link. For example when event_key is foo, the event name for when the user clicks on the outbound link will be outbound.foo.click.

Responses

Request samples

Content type
application/json
Example
{
  • "id": "6011",
  • "name": "360 Tour",
  • "type": "iframe_api",
  • "label": "View 360 Tour",
  • "event_key": "website360Tour"
}

Response samples

Content type
application/json
Example
{
  • "id": "6011",
  • "asset_id": "1323",
  • "type": "iframe_api",
  • "name": "360 Tour",
  • "label": "View 360 Tour",
  • "event_key": "website360Tour",
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

List unit outbound link URLs

Returns a list of URLs for each unit when the unit outbound link type is urls_per_unit.

Requires sightmap.unit-outbound-links.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

outbound-link
required
string <id> <= 255 characters

A unit outbound link ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

Responses

Response samples

Content type
application/json
{}

Update unit outbound link URLs

Update a URL for any or all units when the unit outbound link type is urls_per_unit.

Requires sightmap.unit-outbound-links.update permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

outbound-link
required
string <id> <= 255 characters

A unit outbound link ID.

Request Body schema: application/json
Array of objects
Array
unit_id
required
string <id> <= 255 characters
url
required
string or null

A fully qualified URL assigned to the unit.

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "message": "No API key found in request"
}

Unit Descriptions

List groups

Returns a list of unit description groups for an asset.

Requires sightmap.unit-descriptions.read permission.

NOTICE: This resource is experimental and requires the unit-descriptions-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the unit-descriptions-resource experimental flag.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Create a group

Create a unit description group.

Requires sightmap.unit-descriptions.create permission.

NOTICE: This resource is experimental and requires the unit-descriptions-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the unit-descriptions-resource experimental flag.

Request Body schema: application/json
asset_id
required
string <id> <= 255 characters

The asset the unit description group belongs to.

name
required
string <= 255 characters

Responses

Request samples

Content type
application/json
{
  • "asset_id": "1323",
  • "name": "Amenities"
}

Response samples

Content type
application/json
{
  • "id": "7",
  • "asset_id": "1323",
  • "name": "Amenities",
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

View a group

Returns a specific unit description group.

Requires sightmap.unit-descriptions.read permission.

NOTICE: This resource is experimental and requires the unit-descriptions-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit description group ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the unit-description-resource experimental flag.

Responses

Response samples

Content type
application/json
{
  • "id": "7",
  • "asset_id": "1323",
  • "name": "Amenities",
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

Update a group

Update a unit description group.

Requires sightmap.unit-descriptions.update permission.

NOTICE: This resource is experimental and requires the unit-descriptions-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit description group ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the unit-description-resource experimental flag.

Request Body schema: application/json
id
required
string <id> <= 255 characters
asset_id
required
string <id> <= 255 characters

The asset the unit description group belongs to.

name
required
string <= 255 characters

Responses

Request samples

Content type
application/json
{
  • "id": "7",
  • "asset_id": "1323",
  • "name": "Amenities"
}

Response samples

Content type
application/json
{
  • "id": "7",
  • "asset_id": "1323",
  • "name": "Amenities",
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

List descriptions

Returns a list of descriptions for a unit description group.

Requires sightmap.unit-descriptions.read permission.

NOTICE: This resource is experimental and requires the unit-descriptions-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit description group ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the unit-descriptions-resource experimental flag.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Create a description

Create one or more unit descriptions.

Requires sightmap.unit-descriptions.create permission.

NOTICE: This resource is experimental and requires the unit-descriptions-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit description group ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the unit-descriptions-resource experimental flag.

Request Body schema: application/json
Array of objects
Array
group_id
required
string <id> <= 255 characters

The unit description group the description belongs to.

name
required
string <= 255 characters
label
required
string <= 15 characters

The tab label displayed in the application.

body
required
string <= 2000 characters

The text content displayed in the application, which is expected to be plain text or basic syntax Markdown.

is_enabled
required
boolean

Determines whether or not the description should be displayed in the application.

Responses

Request samples

Content type
application/json
{
  • "data": [
    • {
      },
    • {
      }
    ]
}

Response samples

Content type
application/json
{
  • "data": [
    • {
      },
    • {
      }
    ]
}

Update a description

Update one or more unit descriptions.

Requires sightmap.unit-descriptions.update permission.

NOTICE: This resource is experimental and requires the unit-descriptions-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit description group ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the unit-descriptions-resource experimental flag.

Request Body schema: application/json
Array of objects
Array
id
required
string <id> <= 255 characters
group_id
required
string <id> <= 255 characters

The unit description group the description belongs to.

name
string <= 255 characters
label
string <= 15 characters

The tab label displayed in the application.

body
string <= 2000 characters

The text content displayed in the application, which is expected to be plain text or basic syntax Markdown.

is_enabled
boolean

Determines whether or not the description should be displayed in the application.

Responses

Request samples

Content type
application/json
{
  • "data": [
    • {
      },
    • {
      }
    ]
}

Response samples

Content type
application/json
{
  • "data": [
    • {
      },
    • {
      }
    ]
}

View a description

Returns a specific unit description.

Requires sightmap.unit-descriptions.read permission.

NOTICE: This resource is experimental and requires the unit-descriptions-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit description group ID.

description
required
string <id> <= 255 characters

A unit description ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the unit-description-resource experimental flag.

Responses

Response samples

Content type
application/json
{
  • "id": "1000",
  • "asset_id": "1323",
  • "group_id": "7",
  • "name": "Amenity 1",
  • "label": "Amenities",
  • "body": "* Quartz countertops\n* Mountain views\n* Stainless steel appliances\n",
  • "is_enabled": true,
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

List units assigned to descriptions

Returns a list of units for a unit description group.

Requires sightmap.unit-descriptions.read permission.

NOTICE: This resource is experimental and requires the unit-descriptions-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit description group ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the unit-descriptions-resource experimental flag.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Assign units to descriptions

Assign one or more units to one or more descriptions.

Requires sightmap.unit-descriptions.update permission.

NOTICE: This resource is experimental and requires the unit-descriptions-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit description group ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the unit-descriptions-resource experimental flag.

Request Body schema: application/json
Array of objects
Array
group_id
required
string <id> <= 255 characters

The unit description group the relation belongs to.

unit_id
required
string <id> <= 255 characters
description_id
required
string <= 255 characters

The description the units are assigned to.

Responses

Request samples

Content type
application/json
{
  • "data": [
    • {
      },
    • {
      }
    ]
}

Response samples

Content type
application/json
{
  • "data": [
    • {
      },
    • {
      }
    ]
}

Floors

List floors

Returns a list of floors for an asset.

Requires sightmap.floors.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Create a floor

Create a floor for an asset.

Requires sightmap.floors.create permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

Request Body schema: application/json
asset_id
required
string <id> <= 255 characters

The asset the floor belongs to.

name
required
string <= 255 characters
filter_label
required
string <= 255 characters

The default filter label for the floor.

filter_short_label
required
string <= 4 characters

The default short filter label for the floor.

sort
required
integer <int32>

The sort order of the floor.

Responses

Request samples

Content type
application/json
{
  • "asset_id": "1323",
  • "name": "1",
  • "filter_label": "Floor 1",
  • "filter_short_label": "1",
  • "sort": 2
}

Response samples

Content type
application/json
{
  • "id": "4730",
  • "asset_id": "1323",
  • "name": "1",
  • "filter_label": "Floor 1",
  • "filter_short_label": "1",
  • "sort": 2,
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

View a floor

Returns a specific floor.

Requires sightmap.floors.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

floor
required
string <id> <= 255 characters

A floor ID.

Responses

Response samples

Content type
application/json
{
  • "id": "4730",
  • "asset_id": "1323",
  • "name": "1",
  • "filter_label": "Floor 1",
  • "filter_short_label": "1",
  • "sort": 2,
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

Update a floor

Requires sightmap.floors.update permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

floor
required
string <id> <= 255 characters

A floor ID.

Request Body schema: application/json
id
required
string <id> <= 255 characters
asset_id
required
string <id> <= 255 characters

The asset the floor belongs to.

name
string <= 255 characters
filter_label
string <= 255 characters

The default filter label for the floor.

filter_short_label
string <= 4 characters

The default short filter label for the floor.

sort
integer <int32>

The sort order of the floor.

Responses

Request samples

Content type
application/json
{
  • "id": "4730",
  • "asset_id": "1323",
  • "name": "1",
  • "filter_label": "Floor 1",
  • "filter_short_label": "1",
  • "sort": 2
}

Response samples

Content type
application/json
{
  • "id": "4730",
  • "asset_id": "1323",
  • "name": "1",
  • "filter_label": "Floor 1",
  • "filter_short_label": "1",
  • "sort": 2,
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

Floor Plans

List floor plans

Returns a list of floor plans for an asset.

Requires sightmap.floor-plans.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

Responses

Response samples

Content type
application/json
{}

Create a floor plan

Create a floor plan for an asset.

Requires sightmap.floor-plans.create permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

Request Body schema:
asset_id
required
string <id> <= 255 characters

The asset the floor plan belongs to.

name
required
string <= 255 characters
bedroom_count
required
integer <int32> >= 0

The number of bedrooms.

bathroom_count
required
number <float> >= 0

The number of bathrooms. Fractional values represent partial baths (e.g. 1.5 is 1 1/2 baths).

filter_label
required
string <= 255 characters

Responses

Request samples

Content type
{
  • "asset_id": "1323",
  • "name": "1 Bed 1 Bath",
  • "bedroom_count": 1,
  • "bathroom_count": 1,
  • "filter_label": "1 Bed 1 Bath"
}

Response samples

Content type
application/json
{}

View a floor plan

Returns a specific floor plan.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

floor-plan
required
string <id> <= 255 characters

A floor plan ID.

Responses

Response samples

Content type
application/json
{}

Update a floor plan

Requires sightmap.floor-plans.update permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

floor-plan
required
string <id> <= 255 characters

A floor plan ID.

Request Body schema:
id
required
string <id> <= 255 characters
asset_id
required
string <id> <= 255 characters

The asset the floor plan belongs to.

name
string <= 255 characters
bedroom_count
integer <int32> >= 0

The number of bedrooms.

bathroom_count
number <float> >= 0

The number of bathrooms. Fractional values represent partial baths (e.g. 1.5 is 1 1/2 baths).

image
string
Value: "delete"

Delete the primary image of the floor plan.

secondary_image
string
Value: "delete"

Delete the secondary image of the floor plan.

filter_label
string <= 65 characters

Responses

Request samples

Content type
{
  • "id": "14641",
  • "asset_id": "1323",
  • "name": "1 Bed 1 Bath",
  • "bedroom_count": 1,
  • "bathroom_count": 1,
  • "filter_label": "1 Bed 1 Bath"
}

Response samples

Content type
application/json
{}

Delete a floor plan

Requires sightmap.floor-plans.delete permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

floor-plan
required
string <id> <= 255 characters

A floor plan ID.

Responses

Response samples

Content type
application/json
{}

Buildings

List buildings

Returns a list of buildings for an asset.

Requires sightmap.buildings.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Create a building

Create a building for an asset.

Requires sightmap.buildings.create permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

Request Body schema: application/json
asset_id
required
string <id> <= 255 characters

The asset the building belongs to.

name
required
string <= 255 characters

Responses

Request samples

Content type
application/json
{
  • "asset_id": "1323",
  • "name": "W"
}

Response samples

Content type
application/json
{
  • "id": "8267",
  • "asset_id": "1323",
  • "name": "W",
  • "created_at": "2017-09-11T17:09:18+00:00",
  • "updated_at": "2017-09-11T17:09:18+00:00"
}

View a building

Returns a specific building.

Requires sightmap.buildings.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

building
required
string <id> <= 255 characters

A building ID.

Responses

Response samples

Content type
application/json
{
  • "id": "8267",
  • "asset_id": "1323",
  • "name": "W",
  • "created_at": "2017-09-11T17:09:18+00:00",
  • "updated_at": "2017-09-11T17:09:18+00:00"
}

Update a building

Requires sightmap.buildings.update permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

building
required
string <id> <= 255 characters

A building ID.

Request Body schema: application/json
id
required
string <id> <= 255 characters
asset_id
required
string <id> <= 255 characters

The asset the building belongs to.

name
required
string <= 255 characters

Responses

Request samples

Content type
application/json
{
  • "id": "8267",
  • "asset_id": "1323",
  • "name": "W"
}

Response samples

Content type
application/json
{
  • "id": "8267",
  • "asset_id": "1323",
  • "name": "W",
  • "created_at": "2017-09-11T17:09:18+00:00",
  • "updated_at": "2017-09-11T17:09:18+00:00"
}

Amenities

List amenities Deprecated

Returns a list of amenities for an asset.

Requires sightmap.amenities.read permission.

NOTICE: This resource is experimental and requires the amenity-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the amenity-resource experimental flag.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

View an amenity Deprecated

Returns a specific amenity.

Requires sightmap.amenities.read permission.

NOTICE: This resource is experimental and requires the amenity-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

amenity
required
string <id> <= 255 characters

An amenity ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the amenity-resource experimental flag..

Responses

Response samples

Content type
application/json
{
  • "id": "8267",
  • "asset_id": "1323",
  • "gallery_id": "3321",
  • "name": "Infinity Pool",
  • "label": "Infinity Pool",
  • "description": "An infinity pool is a reflecting or swimming pool, where the water flows over one or more edges, producing a visual effect of water with no boundary. Such pools are often designed so that the edge appears to merge with a larger body of water such as the ocean, or with the sky. They are often seen at resorts, estates, and in other luxurious places.",
  • "iframe_source_url": null,
  • "outbound_link_url": "https://engrain.com/",
  • "created_at": "2017-09-11T17:09:18+00:00",
  • "updated_at": "2017-09-11T17:09:18+00:00"
}

Image Galleries

List galleries

Returns a list of image galleries for an asset.

Requires sightmap.galleries.read permission.

NOTICE: This resource is experimental and requires the gallery-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the gallery-resource experimental flag.

Responses

Response samples

Content type
application/json
{}

View a gallery

Returns a specific image gallery.

NOTICE: This resource is experimental and requires the gallery-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

gallery
required
string <id> <= 255 characters

A gallery ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the gallery-resource experimental flag.

Responses

Response samples

Content type
application/json
{}

Unit Maps

List unit maps

Returns a list of unit maps for an asset.

Requires sightmap.unit-maps.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

tags
string <id> <= 255 characters

A comma-separated list of one or more tags to filter the list on (e.g. tag-1,tag-2).

Responses

Response samples

Content type
application/json
{}

Create a unit map

Create a Unit Map for an asset.

Requires sightmap.unit-maps.create permission.

NOTICE: This resource is experimental and requires the create-unitmap-resource experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the create-unitmap-resource experimental flag.

Request Body schema: multipart/form-data
required
object
asset_id
required
string <id> <= 255 characters

The asset the unit map belongs to.

name
required
string <= 255 characters
tags
Array of strings <= 255 characters <= 3 items ^[a-z]{1}[a-z0-9-]{1,254}$

The tags assigned to the unit map.

style
required
string
Enum: "a" "a.1" "a.2" "b" "c" "d" "e" "f.1" "f.2" "f.3" "g.1" "g.2" "h" "x"

The defined style of the unit map.

This field is required when file or source is provided.

file
required
string <binary>

The unit map file. Must be a .umap file.

source
required
string <binary>

The unit map source file. Must be either an .svg, .ai, or .pdf file.

Responses

Response samples

Content type
application/json
{}

View a unit map

Returns a specific unit map.

Requires sightmap.unit-maps.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

map
required
string <id> <= 255 characters

A unit map ID.

Responses

Response samples

Content type
application/json
{}

Update a unit map

Requires sightmap.unit-maps.update permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

map
required
string <id> <= 255 characters

A unit map ID.

Request Body schema:
id
required
string <id> <= 255 characters
asset_id
required
string <id> <= 255 characters

The asset the unit map belongs to.

name
string <= 255 characters
tags
Array of strings <= 255 characters <= 3 items ^[a-z]{1}[a-z0-9-]{1,254}$

The tags assigned to the unit map.

is_dimension_locked
boolean
Default: false
style
string
Enum: "a" "a.1" "a.2" "b" "c" "d" "e" "f.1" "f.2" "f.3" "g.1" "g.2" "h" "x"

The defined style of the unit map.

Responses

Request samples

Content type
{
  • "id": "575",
  • "asset_id": "1323",
  • "name": "The Lofts at New Main",
  • "tags": [
    • "ils",
    • "mls"
    ],
  • "style": "b"
}

Response samples

Content type
application/json
{}

List backgrounds

Returns a list of backgrounds for the unit map.

Requires sightmap.unit-maps.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

map
required
string <id> <= 255 characters

A unit map ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

Responses

Response samples

Content type
application/json
{}

View a background

Returns a specific background for a unit map.

Requires sightmap.unit-maps.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

map
required
string <id> <= 255 characters

A unit map ID.

background
required
string <id> <= 255 characters

A background ID.

Responses

Response samples

Content type
application/json
{}

Caches

Build caches

Builds and/or rebuilds all caches for an asset.

Requires sightmap.caches.build permission.

NOTICE: This resource is experimental and requires the build-caches experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the build-caches experimental flag.

Responses

Response samples

Content type
application/json
{
  • "message": "No API key found in request"
}

Asset References

References provide asset ID mappings to other third-party systems.

List references

Returns a list of asset references for an asset.

Requires sightmap.asset-references.read permission.

NOTICE: This resource is experimental and requires the references experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the references experimental flag.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Create a reference

Create an asset reference for an asset.

Requires sightmap.asset-references.create permission.

NOTICE: This resource is experimental and requires the references experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the references experimental flag.

Request Body schema: application/json
asset_id
required
string <id> <= 255 characters

The asset the reference belongs to.

name
required
string <= 255 characters
description
string or null <= 255 characters
key
string or null <= 255 characters ^[a-z]{1}[a-z0-9-]{1,254}$

A string used across resources to indicate the third-party system the reference value is part of.

The key cannot be used more than once per asset, which ensures only a single reference may exist per asset for each key.

value
required
string <= 255 characters

The matched reference value to the asset.

Responses

Request samples

Content type
application/json
{
  • "asset_id": "4715",
  • "name": "Google Places",
  • "key": "google-places",
  • "value": "ChIJuw4JzfOGbIcR1PPArQtuTcQ"
}

Response samples

Content type
application/json
{
  • "id": "2630",
  • "asset_id": "4715",
  • "name": "Google Places",
  • "description": null,
  • "key": "google-places",
  • "value": "ChIJuw4JzfOGbIcR1PPArQtuTcQ",
  • "created_at": "2021-03-11T17:09:18+00:00",
  • "updated_at": "2021-01-20T03:44:39+00:00"
}

View a reference

Returns a specific asset reference.

Requires sightmap.asset-references.read permission.

NOTICE: This resource is experimental and requires the references experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

reference
required
string <id> <= 255 characters

An asset reference ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the references experimental flag.

Responses

Response samples

Content type
application/json
{
  • "id": "2630",
  • "asset_id": "4715",
  • "name": "Google Places",
  • "description": null,
  • "key": "google-places",
  • "value": "ChIJuw4JzfOGbIcR1PPArQtuTcQ",
  • "created_at": "2021-03-11T17:09:18+00:00",
  • "updated_at": "2021-01-20T03:44:39+00:00"
}

Update a reference

Requires sightmap.asset-references.update permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

reference
required
string <id> <= 255 characters

An asset reference ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the references experimental flag.

Request Body schema: application/json
id
required
string <id> <= 255 characters
asset_id
required
string <id> <= 255 characters

The asset the reference belongs to.

name
string <= 255 characters
description
string or null <= 255 characters
key
string or null <= 255 characters ^[a-z]{1}[a-z0-9-]{1,254}$

A string used across resources to indicate the third-party system the reference value is part of.

The key cannot be used more than once per asset, which ensures only a single reference may exist per asset for each key.

value
required
string <= 255 characters

The matched reference value to the asset.

Responses

Request samples

Content type
application/json
{
  • "id": "2630",
  • "asset_id": "4715",
  • "name": "Google Places",
  • "description": null,
  • "key": "google-places",
  • "value": "ChIJuw4JzfOGbIcR1PPArQtuTcQ"
}

Response samples

Content type
application/json
{
  • "id": "2630",
  • "asset_id": "4715",
  • "name": "Google Places",
  • "description": null,
  • "key": "google-places",
  • "value": "ChIJuw4JzfOGbIcR1PPArQtuTcQ",
  • "created_at": "2021-03-11T17:09:18+00:00",
  • "updated_at": "2021-01-20T03:44:39+00:00"
}

Unit References

References provide unit ID mappings to other third-party systems.

List groups

Returns a list of unit reference groups for an asset.

Requires sightmap.unit-references.read permission.

NOTICE: This resource is experimental and requires the references experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the references experimental flag.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Create a group

Create a unit reference group.

Requires sightmap.unit-references.create permission.

NOTICE: This resource is experimental and requires the references experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the references experimental flag.

Request Body schema: application/json
asset_id
required
string <id> <= 255 characters

The asset the unit reference group belongs to.

name
required
string <= 255 characters
description
string or null <= 255 characters
key
string or null <= 255 characters ^[a-z]{1}[a-z0-9-]{1,254}$

A string used across resources to indicate the third-party system the references are part of.

The key cannot be used more than once per asset, which ensures only a single reference group may exist per asset for each key.

Responses

Request samples

Content type
application/json
{
  • "asset_id": "1323",
  • "name": "Yardi Voyager",
  • "key": "yardi-voyager"
}

Response samples

Content type
application/json
{
  • "id": "2630",
  • "asset_id": "1323",
  • "name": "Yardi Voyager",
  • "key": "yardi-voyager",
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

View a group

Returns a specific unit reference group.

Requires sightmap.unit-references.read permission.

NOTICE: This resource is experimental and requires the references experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit reference group ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the references experimental flag.

Responses

Response samples

Content type
application/json
{
  • "id": "2630",
  • "asset_id": "1323",
  • "name": "Yardi Voyager",
  • "key": "yardi-voyager",
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

Update a group

Update a unit reference group.

Requires sightmap.unit-references.update permission.

NOTICE: This resource is experimental and requires the references experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit reference group ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the references experimental flag.

Request Body schema: application/json
id
required
string <id> <= 255 characters
asset_id
required
string <id> <= 255 characters

The asset the unit reference group belongs to.

name
string <= 255 characters
description
string or null <= 255 characters
key
string or null <= 255 characters ^[a-z]{1}[a-z0-9-]{1,254}$

A string used across resources to indicate the third-party system the references are part of.

The key cannot be used more than once per asset, which ensures only a single reference group may exist per asset for each key.

Responses

Request samples

Content type
application/json
{
  • "id": "2630",
  • "asset_id": "1323",
  • "name": "Yardi Voyager",
  • "key": "yardi-voyager"
}

Response samples

Content type
application/json
{
  • "id": "2630",
  • "asset_id": "1323",
  • "name": "Yardi Voyager",
  • "key": "yardi-voyager",
  • "created_at": "2017-09-11T17:09:17+00:00",
  • "updated_at": "2019-01-02T22:01:09+00:00"
}

List references

Returns a list of references for a unit reference group.

Requires sightmap.unit-references.read permission.

NOTICE: This resource is experimental and requires the references experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit reference group ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the references experimental flag.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

Update references

Update one or more references on a unit reference group.

Requires sightmap.unit-references.update permission.

NOTICE: This resource is experimental and requires the references experimental flag.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

group
required
string <id> <= 255 characters

A unit reference group ID.

header Parameters
Experimental-Flags
required
string

This resource is experimental and requires the references experimental flag.

Request Body schema: application/json
Array of objects
Array
group_id
required
string <id> <= 255 characters

The group the reference belongs to.

unit_id
required
string <id> <= 255 characters

The unit the reference belongs to. A unit can only have one reference per group.

value
required
string or null <= 255 characters

The matched reference value to the unit. Must be unique amongst the group when non-null.

Responses

Request samples

Content type
application/json
{
  • "data": [
    • [
      ]
    ]
}

Response samples

Content type
application/json
{
  • "message": "No API key found in request"
}

Pricing & Availability

List pricing processes

Returns the pricing processes for an asset.

Requires sightmap.pricing.read permission.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

query Parameters
page
integer <int32>

Request a specific page of resources.

per-page
integer <int32>

Limit the number of returned resources.

Responses

Response samples

Content type
application/json
{
  • "paging": {
    • "per_page": 100,
    • "current_page": 1,
    • "prev_url": null,
    • "next_url": null
    },
  • "data": [
    • {
      }
    ]
}

View a pricing process

Returns a specific pricing process.

Authorizations:
API Key
path Parameters
asset
required
string <id> <= 255 characters

An asset ID.

process
required
string <id> <= 255 characters

A process ID.

query Parameters
page
integer <int32>