Search for your models
Sample Request
query {
models(query: "*") {
totalResults
results {
id
name
description
}
}
}
Sample Response
{
"data": {
"models": {
"totalResults": 1,
"results": [
{
"id": "MODEL_ID",
"name": "352 E Java Dr",
"description": ""
}
]
}
}
}
Buy a matterpak
Sample Request
mutation buyMatterpak {
unlockModelBundle(
id: $modelId,
bundleId: "mp:matterpak"
) {
id
name
description
availability
assets { url }
}
}
Sample Response
Use the URL from the response to download the Matterpak
{
"data": {
"unlockModelBundle": {
"id": "mp:matterpak",
"name": "Matterpak",
"description": "Order high resolution assets associated with the model.",
"availability": "unlocked",
"assets": [
{
"url": "https://qa-cdn-1.matterport.com/models/group_77/job_62927cc2-7552-4aad-8330-3904c5198354/wf_39d3f0f8baae4fc9aaeb6326edf55d8f/mesh/1.1.466.14860/2016-11-09_0240.05/62927cc275524aad83303904c5198354.zip?t=2-b3da2c89760c80f1671bc260d678d949f29bd8a8-1573485841-1"
}
]
}
}
}
Get all sweep locations and panos
Sample Request
{
model(id: $modelId) {
locations {
id
model {id}
position {x, y, z}
floor {id}
room {id}
panos {
id
skybox {
id
status
format
children
}
}
}
}
}
Sample Response
{
"data": {
"model": {
"locations": [
{
"id": "a0723324-ab3e-4500-bdee-8fec13d3ae9d",
"model": {
"id": "MODEL_ID"
},
"position": {
"x": 0,
"y": 0,
"z": 0
},
"panos": [
{
"id": "a0723324-ab3e-4500-bdee-8fec13d3ae9d",
"skybox": {
"id": "a0723324-ab3e-4500-bdee-8fec13d3ae9d",
"status": "available",
"format": "skybox",
; "children": [
"https://qa-cdn-1.matterport.com/models/1a56eedeff7d4a7481b961c009ae9236/assets/pan/~/high/a0723324ab3e4500bdee8fec13d3ae9d_skybox0.jpg?t=2-c81c9af53e390d7c5d9946f73a74665f0e06757c-1573701898-1",
"https://qa-cdn-1.matterport.com/models/1a56eedeff7d4a7481b961c009ae9236/assets/pan/~/high/a0723324ab3e4500bdee8fec13d3ae9d_skybox1.jpg?t=2-c81c9af53e390d7c5d9946f73a74665f0e06757c-1573701898-1",
"https://qa-cdn-1.matterport.com/models/1a56eedeff7d4a7481b961c009ae9236/assets/pan/~/high/a0723324ab3e4500bdee8fec13d3ae9d_skybox2.jpg?t=2-c81c9af53e390d7c5d9946f73a74665f0e06757c-1573701898-1",
"https://qa-cdn-1.matterport.com/models/1a56eedeff7d4a7481b961c009ae9236/assets/pan/~/high/a0723324ab3e4500bdee8fec13d3ae9d_skybox3.jpg?t=2-c81c9af53e390d7c5d9946f73a74665f0e06757c-1573701898-1",
"https://qa-cdn-1.matterport.com/models/1a56eedeff7d4a7481b961c009ae9236/assets/pan/~/high/a0723324ab3e4500bdee8fec13d3ae9d_skybox4.jpg?t=2-c81c9af53e390d7c5d9946f73a74665f0e06757c-1573701898-1",
"https://qa-cdn-1.matterport.com/models/1a56eedeff7d4a7481b961c009ae9236/assets/pan/~/high/a0723324ab3e4500bdee8fec13d3ae9d_skybox5.jpg?t=2-c81c9af53e390d7c5d9946f73a74665f0e06757c-1573701898-1"
]
}
}
]
},
{
…
Get all Mattertags and Locations
Sample Request
{
model(id: $modelId) {
mattertags {
id
label
description
media
position {x, y, z}
}
}
}
Sample Response
{
"data": {
"model": {
"mattertags": [
{
"id": $modelId,
"label": "Nest Thermostat",
"description": "",
"media": "https://www.youtube.com/watch?v=vgowFxYI8PI",
"position": {
"x": -1.20415628,
"y": -5.35434341,
"z": 3.1942153
}
},
{…
Order a schematic floor plan from our partner Cubicasa
To purchase
mutation buyFloorplan {
unlockModelBundle(
id: $modelId,
bundleId: "cubicasa:floorplan",
options: {deliverySpeed: normal}
)
{
id
name
description
availability
assets { url }
}
}
Again, floor plan assets won't be available until Cubicasa returns it (normal speed is about 2 days).
Find the asset by looking through the asset bundle
{
model(id: $modelId) {
bundles {
id
availability
name
description
assets {
id
url
validUntil
format
filename
status
}
supportedOptions {
deliverySpeeds
}
}
}
}
To retrieve the assets:
query getFloorplan($modelId:ID!) {
model(id: $modelId) {
bundle(id: "cubicasa:floorplan") {
assets { url }
}
}
}
To know the delivery speed available for your model
query getSupportedFloorplanDeliverySpeeds($modelId: ID!) {
model(id: $modelId) {
bundle(id: 'cubicasa:floorplan') {
supportedOptions { deliverySpeeds }
}
}
}
To know the different options to any bundle:
query getSupportedOptions($modelId: ID!) {
model(id: $modelId) {
bundles {
supportedOptions { units deliverySpeeds }
}
}
}
Get the colored rooms floorpan
{
model(id: $modelId) {
assets {
floorplans(provider: "matterport", flags: [colored_rooms]) {
provider
format
flags
id
url
}
}
}
Make Private
mutation {
updateModelVisibility(
id: $modelId,
visibility: 'private')
{
id
}
}
Make Public
mutation {
updateModelVisibility(
id: $modelId,
visibility: 'public')
{
id
}
}
Archive
mutation {
updateModelState(
id: $modelId,
state: inactive)
{
id
}
}
Activate
mutation {
updateModelState(
id: $modelId,
state: active)
{
id
}
}