Showings
Create Showing
Creates a showing for a lead.
Notes:
- leadId, listing, startAt and endAt are required; the caller must manage the lead.
- listing is one of / / . When no Lofty listing matches, address is required and the showing is recorded against an external property.
- status defaults to scheduled. requested and scheduled showings must start in the future; completed allows a past time range.
- externalId is the idempotency key: a repeat call with the same externalId returns the existing showing with created=false.
POST
/
v2.0
/
showings
Create Showing
curl --request POST \
--url https://api.lofty.com/v2.0/showings \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>' \
--data '
{
"leadId": 563172647619608,
"listing": {
"listingId": "123456789",
"mlsOrgId": 12,
"mlsListingId": "ML81234567",
"address": "123 Main St, San Jose, CA 95112"
},
"startAt": "2026-11-01T10:00:00-07:00",
"endAt": "2026-11-01T10:30:00-07:00",
"status": "scheduled",
"note": "Buyer prefers morning",
"externalId": "showami-98765",
"timeZone": "America/Los_Angeles"
}
'import requests
url = "https://api.lofty.com/v2.0/showings"
payload = {
"leadId": 563172647619608,
"listing": {
"listingId": "123456789",
"mlsOrgId": 12,
"mlsListingId": "ML81234567",
"address": "123 Main St, San Jose, CA 95112"
},
"startAt": "2026-11-01T10:00:00-07:00",
"endAt": "2026-11-01T10:30:00-07:00",
"status": "scheduled",
"note": "Buyer prefers morning",
"externalId": "showami-98765",
"timeZone": "America/Los_Angeles"
}
headers = {
"Authorization": "<authorization>",
"Content-Type": "<content-type>"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
body: JSON.stringify({
leadId: 563172647619608,
listing: {
listingId: '123456789',
mlsOrgId: 12,
mlsListingId: 'ML81234567',
address: '123 Main St, San Jose, CA 95112'
},
startAt: '2026-11-01T10:00:00-07:00',
endAt: '2026-11-01T10:30:00-07:00',
status: 'scheduled',
note: 'Buyer prefers morning',
externalId: 'showami-98765',
timeZone: 'America/Los_Angeles'
})
};
fetch('https://api.lofty.com/v2.0/showings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lofty.com/v2.0/showings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'leadId' => 563172647619608,
'listing' => [
'listingId' => '123456789',
'mlsOrgId' => 12,
'mlsListingId' => 'ML81234567',
'address' => '123 Main St, San Jose, CA 95112'
],
'startAt' => '2026-11-01T10:00:00-07:00',
'endAt' => '2026-11-01T10:30:00-07:00',
'status' => 'scheduled',
'note' => 'Buyer prefers morning',
'externalId' => 'showami-98765',
'timeZone' => 'America/Los_Angeles'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lofty.com/v2.0/showings"
payload := strings.NewReader("{\n \"leadId\": 563172647619608,\n \"listing\": {\n \"listingId\": \"123456789\",\n \"mlsOrgId\": 12,\n \"mlsListingId\": \"ML81234567\",\n \"address\": \"123 Main St, San Jose, CA 95112\"\n },\n \"startAt\": \"2026-11-01T10:00:00-07:00\",\n \"endAt\": \"2026-11-01T10:30:00-07:00\",\n \"status\": \"scheduled\",\n \"note\": \"Buyer prefers morning\",\n \"externalId\": \"showami-98765\",\n \"timeZone\": \"America/Los_Angeles\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "<content-type>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.lofty.com/v2.0/showings")
.header("Authorization", "<authorization>")
.header("Content-Type", "<content-type>")
.body("{\n \"leadId\": 563172647619608,\n \"listing\": {\n \"listingId\": \"123456789\",\n \"mlsOrgId\": 12,\n \"mlsListingId\": \"ML81234567\",\n \"address\": \"123 Main St, San Jose, CA 95112\"\n },\n \"startAt\": \"2026-11-01T10:00:00-07:00\",\n \"endAt\": \"2026-11-01T10:30:00-07:00\",\n \"status\": \"scheduled\",\n \"note\": \"Buyer prefers morning\",\n \"externalId\": \"showami-98765\",\n \"timeZone\": \"America/Los_Angeles\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lofty.com/v2.0/showings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n \"leadId\": 563172647619608,\n \"listing\": {\n \"listingId\": \"123456789\",\n \"mlsOrgId\": 12,\n \"mlsListingId\": \"ML81234567\",\n \"address\": \"123 Main St, San Jose, CA 95112\"\n },\n \"startAt\": \"2026-11-01T10:00:00-07:00\",\n \"endAt\": \"2026-11-01T10:30:00-07:00\",\n \"status\": \"scheduled\",\n \"note\": \"Buyer prefers morning\",\n \"externalId\": \"showami-98765\",\n \"timeZone\": \"America/Los_Angeles\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "987654321",
"created": true
}
}"<string>""<string>""<string>"Body
application/json
Showing to create.
Lead the showing is for. The caller must manage this lead.
Example:
563172647619608
Which property the showing is for. Provide exactly one of: listingId; mlsOrgId + mlsListingId; address. Resolution order is listingId, then the MLS number, then address. When neither listingId nor the MLS number matches a Lofty listing, address is required and the showing is recorded against an external property.
Show child attributes
Show child attributes
Showing start, ISO 8601 with offset.
Example:
"2026-11-01T10:00:00-07:00"
Showing end, ISO 8601 with offset. Must be after startAt.
Example:
"2026-11-01T10:30:00-07:00"
Initial status. Defaults to scheduled. completed allows a past time range.
Available options:
requested, scheduled, in_progress, completed, denied, expired, cancelled Example:
"scheduled"
Free-text note shown with the showing.
Example:
"Buyer prefers morning"
The partner's own id for this showing. Used as the idempotency key.
Example:
"showami-98765"
IANA timezone used when a default showing configuration has to be created for the listing. Optional.
Example:
"America/Los_Angeles"
Response
Showing created (or found by externalId).
Wrapped response for POST /v2.0/showings. The result is returned under the 'data' key.
Result of creating a showing.
Show child attributes
Show child attributes
⌘I
Create Showing
curl --request POST \
--url https://api.lofty.com/v2.0/showings \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>' \
--data '
{
"leadId": 563172647619608,
"listing": {
"listingId": "123456789",
"mlsOrgId": 12,
"mlsListingId": "ML81234567",
"address": "123 Main St, San Jose, CA 95112"
},
"startAt": "2026-11-01T10:00:00-07:00",
"endAt": "2026-11-01T10:30:00-07:00",
"status": "scheduled",
"note": "Buyer prefers morning",
"externalId": "showami-98765",
"timeZone": "America/Los_Angeles"
}
'import requests
url = "https://api.lofty.com/v2.0/showings"
payload = {
"leadId": 563172647619608,
"listing": {
"listingId": "123456789",
"mlsOrgId": 12,
"mlsListingId": "ML81234567",
"address": "123 Main St, San Jose, CA 95112"
},
"startAt": "2026-11-01T10:00:00-07:00",
"endAt": "2026-11-01T10:30:00-07:00",
"status": "scheduled",
"note": "Buyer prefers morning",
"externalId": "showami-98765",
"timeZone": "America/Los_Angeles"
}
headers = {
"Authorization": "<authorization>",
"Content-Type": "<content-type>"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
body: JSON.stringify({
leadId: 563172647619608,
listing: {
listingId: '123456789',
mlsOrgId: 12,
mlsListingId: 'ML81234567',
address: '123 Main St, San Jose, CA 95112'
},
startAt: '2026-11-01T10:00:00-07:00',
endAt: '2026-11-01T10:30:00-07:00',
status: 'scheduled',
note: 'Buyer prefers morning',
externalId: 'showami-98765',
timeZone: 'America/Los_Angeles'
})
};
fetch('https://api.lofty.com/v2.0/showings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lofty.com/v2.0/showings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'leadId' => 563172647619608,
'listing' => [
'listingId' => '123456789',
'mlsOrgId' => 12,
'mlsListingId' => 'ML81234567',
'address' => '123 Main St, San Jose, CA 95112'
],
'startAt' => '2026-11-01T10:00:00-07:00',
'endAt' => '2026-11-01T10:30:00-07:00',
'status' => 'scheduled',
'note' => 'Buyer prefers morning',
'externalId' => 'showami-98765',
'timeZone' => 'America/Los_Angeles'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lofty.com/v2.0/showings"
payload := strings.NewReader("{\n \"leadId\": 563172647619608,\n \"listing\": {\n \"listingId\": \"123456789\",\n \"mlsOrgId\": 12,\n \"mlsListingId\": \"ML81234567\",\n \"address\": \"123 Main St, San Jose, CA 95112\"\n },\n \"startAt\": \"2026-11-01T10:00:00-07:00\",\n \"endAt\": \"2026-11-01T10:30:00-07:00\",\n \"status\": \"scheduled\",\n \"note\": \"Buyer prefers morning\",\n \"externalId\": \"showami-98765\",\n \"timeZone\": \"America/Los_Angeles\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<authorization>")
req.Header.Add("Content-Type", "<content-type>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.lofty.com/v2.0/showings")
.header("Authorization", "<authorization>")
.header("Content-Type", "<content-type>")
.body("{\n \"leadId\": 563172647619608,\n \"listing\": {\n \"listingId\": \"123456789\",\n \"mlsOrgId\": 12,\n \"mlsListingId\": \"ML81234567\",\n \"address\": \"123 Main St, San Jose, CA 95112\"\n },\n \"startAt\": \"2026-11-01T10:00:00-07:00\",\n \"endAt\": \"2026-11-01T10:30:00-07:00\",\n \"status\": \"scheduled\",\n \"note\": \"Buyer prefers morning\",\n \"externalId\": \"showami-98765\",\n \"timeZone\": \"America/Los_Angeles\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lofty.com/v2.0/showings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n \"leadId\": 563172647619608,\n \"listing\": {\n \"listingId\": \"123456789\",\n \"mlsOrgId\": 12,\n \"mlsListingId\": \"ML81234567\",\n \"address\": \"123 Main St, San Jose, CA 95112\"\n },\n \"startAt\": \"2026-11-01T10:00:00-07:00\",\n \"endAt\": \"2026-11-01T10:30:00-07:00\",\n \"status\": \"scheduled\",\n \"note\": \"Buyer prefers morning\",\n \"externalId\": \"showami-98765\",\n \"timeZone\": \"America/Los_Angeles\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "987654321",
"created": true
}
}"<string>""<string>""<string>"