Showings
NewBetaShowing objects list property showings (in-person tours, self-showings, etc.) scheduled in AppFolio®.
The Showing Object
Attributes
appfolioIdstring
AppFolio ID of the showing.
Example:
"139"
showingTimestring
ISO timestamp of the scheduled showing.
Example:
"2026-04-13T20:00:00.000Z"
confirmationTimestring
ISO timestamp when the showing was confirmed (null if never confirmed).
Example:
null
statusstring
Status of the showing (e.g. "Scheduled", "Confirmed", "Completed", "Canceled", "No Show").
Example:
"Completed"
typestring
Type of the showing (e.g. "In-Person", "Self-Showing").
Example:
"In-Person"
descriptionstring
Free-text description/notes attached to the showing.
Example:
null
assignedUserstring
Display name of the user assigned to the showing.
Example:
null
More Attributes
inquiryIdstring
inquiryTypestring
createdAtstring
createdBystring
createdByIdstring
assignedUserIdstring
lisaScheduledboolean
guestCard.uuidstring
guestCard.leadTypestring
guestCard.sourcestring
guestCard.lastActivityDatestring
guestCard.lastActivityTypestring
property.streetstring
property.street2string
property.citystring
property.statestring
property.zipstring
unit.typestring
unit.typeIdstring
rentalApplication.groupIdstring
rentalApplication.showingToApplicationTimeDaysstring
The Showing Object
{
"appfolioId": "139",
"inquiryId": "16722",
"inquiryType": "User",
"showingTime": "2026-04-13T20:00:00.000Z",
"confirmationTime": null,
"createdAt": "2026-04-13T07:52:23.000Z",
"createdBy": "Jane Manager",
"createdById": "13",
"status": "Completed",
"type": "In-Person",
"description": null,
"assignedUser": null,
"assignedUserId": null,
"lisaScheduled": false,
"guestCard": {
"appfolioId": "5094",
"uuid": "a1b2c3d4-0000-0000-0000-000000000001",
"name": "Doe, Jane",
"email": "jane.doe@example.com",
"phoneNumber": "(555) 010-0199",
"leadType": "Free",
"source": "No Source Recorded",
"lastActivityDate": "2026-04-13",
"lastActivityType": "Showing"
},
"property": {
"appfolioId": "9",
"label": "Example Property, LLC - 100 Main St. Los Angeles, CA 90049",
"name": "Example Property, LLC",
"address": "100 Main St. Los Angeles, CA 90049",
"street": "100 Main St.",
"street2": null,
"city": "Los Angeles",
"state": "CA",
"zip": "90049"
},
"unit": {
"appfolioId": "290",
"label": "408",
"type": "3 Bed + 2 Bath",
"typeId": "9"
},
"rentalApplication": {
"appfolioId": null,
"groupId": null,
"status": null,
"receivedAt": null,
"showingToApplicationTimeDays": null
}
}
Get All Showings
GET /v1/showings?dateRange=this_month_to_date
Follows: Authentication • Caching • Polling • List Response Format • Scheduled Job
The showings endpoint returns the property showings in your AppFolio® account, filtered by date range, status, property, and assigned user. Filter values mirror the dropdowns on the AppFolio Showings report: status accepts all, scheduled, confirmed, completed, canceled, or no_show; propertyVisibility accepts active, active_and_inactive, or inactive. If you omit the date filter, we default to this_month_to_date so new accounts see the current month's showings out-of-the-box.
Parameters
propertyIdselect
AppFolio ID of a Property to serve as a filter.
propertyGroupIdselect
AppFolio ID of a Property Group to serve as a filter.
ownerIdselect
AppFolio ID of an Owner to serve as a filter.
dateRangeselect
Showing Date Range for report.
Default Value:
this_month_to_date
Possible Values:
today
this_week
this_week_to_date
this_month
this_month_to_date
this_quarter
this_quarter_to_date
this_year_to_date
last_year
last_year_to_date
yesterday
last_week
last_week_to_date
last_month
last_month_to_date
last_quarter
last_quarter_to_date
last_7_days
last_30_days
last_60_days
last_90_days
trailing_12_months
next_7_days
next_30_days
next_60_days
next_90_days
next_week
next_month
next_quarter
until_1_week_ago
until_1_month_ago
all_time
dateFromdate
Showing Date to given in MM/DD/YYYY (e.g. 01/31/2021)
dateTodate
Showing Date to given in MM/DD/YYYY (e.g. 01/31/2021)
statusselect
Filter showings for a specific status. Default: all.
Default Value:
all
Possible Values:
all
scheduled
confirmed
completed
canceled
no_show
assignedUserstring
Filter showings for a specific assigned user. Accepts the AppFolio user display name (e.g. "Jane Manager") or AppFolio user ID. Default: All.
propertyVisibilityselect
Filter by property visibility. Default: active.
Default Value:
active
Possible Values:
active
active_and_inactive
inactive
sortOrderselect
Sort order for ShowingTime. Default: desc.
Default Value:
desc
Possible Values:
desc
asc
Returns
The standard List Response Format with a data property containing an array of Showing objects.
GET /v1/showings?dateRange=this_month_to_date
curl -X GET 'https://api.skywalkapi.com/v1/showings?dateRange=this_month_to_date' \
-H "X-API-Key: PUT_YOUR_API_KEY_HERE"
Response
{
"meta": {
"status": "ok",
"path": "/v1/showings",
"query": {
"dateRange": "this_month_to_date"
},
"count": 1,
"lastUpdated": 1610992228
},
"links": {
"next": "/v1/showings?cursor=abcdefg"
},
"data": [
{
"appfolioId": "139",
"inquiryId": "16722",
"inquiryType": "User",
"showingTime": "2026-04-13T20:00:00.000Z",
"confirmationTime": null,
"createdAt": "2026-04-13T07:52:23.000Z",
"createdBy": "Jane Manager",
"createdById": "13",
"status": "Completed",
"type": "In-Person",
"description": null,
"assignedUser": null,
"assignedUserId": null,
"lisaScheduled": false,
"guestCard": {
"appfolioId": "5094",
"uuid": "a1b2c3d4-0000-0000-0000-000000000001",
"name": "Doe, Jane",
"email": "jane.doe@example.com",
"phoneNumber": "(555) 010-0199",
"leadType": "Free",
"source": "No Source Recorded",
"lastActivityDate": "2026-04-13",
"lastActivityType": "Showing"
},
"property": {
"appfolioId": "9",
"label": "Example Property, LLC - 100 Main St. Los Angeles, CA 90049",
"name": "Example Property, LLC",
"address": "100 Main St. Los Angeles, CA 90049",
"street": "100 Main St.",
"street2": null,
"city": "Los Angeles",
"state": "CA",
"zip": "90049"
},
"unit": {
"appfolioId": "290",
"label": "408",
"type": "3 Bed + 2 Bath",
"typeId": "9"
},
"rentalApplication": {
"appfolioId": null,
"groupId": null,
"status": null,
"receivedAt": null,
"showingToApplicationTimeDays": null
}
}
]
}