> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signalproptech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Viewings

> Tell Signal about viewings, and get feedback back.

Signal doesn't book resale or letting viewings: the negotiator books in your system and you tell us, with
`POST /viewings`. Send it when a viewing is booked, moved or cancelled, **before it happens**.

## Who it's for

One of:

* `enquiry_external_id`: an enquiry you sent us;
* `contact_id`: Signal's id for the person, from any event;
* `contact` with a phone number, plus `transaction_type`: someone who never enquired through Signal.

If you send more than one, `enquiry_external_id` wins, then `contact_id`, then `contact`. An id we've never seen is
skipped when the next one tells us who it is; it's a `422` only when nothing does. So always include the contact, with a phone number, and `transaction_type`.

Send `updated_at` (when it last changed in your system) and an older update than the one we hold is ignored, so a
retried `booked` can't undo a later `cancelled`. Without it, the last call wins.

## Statuses

| `status` | What Signal does |
| - | - |
| `booked` | Reminds them the day before, and asks for feedback afterwards |
| `cancelled`, `no_show` | Nothing, if it's before feedback is asked for |
| `completed` | If we already knew about it, asks for feedback at the next opportunity rather than waiting |

## When feedback is asked for

Feedback is asked for in the evening, between 19:00 and 21:00 Irish and UK time: a viewing that starts by 17:00 is asked about at 19:00, a later one about two hours after it starts, and one after 19:00 the next evening. A
viewing we first hear about more than two hours after its start is recorded but never triggers feedback: the response
says `"feedback": "not_scheduled"`, with reason `too_late`. Once feedback has been asked for, later changes are
recorded and do nothing else. It's never asked twice.

## The reminder the day before

On the afternoon before, Signal sends the viewer a reminder with two buttons: still coming, or can't make it. If they
tap can't make it, you receive `viewing.cant_make_it`, Signal asks when else would suit, and no feedback is asked
for. **Signal changes nothing in your system**: the negotiator cancels or moves the viewing there, and you send us the
update. The agency can switch reminders off.

## Show-home bookings made in Signal

New-homes buyers can book show-home visits in Signal itself. You receive those as `showhome.booking_made` /
`_changed` / `_cancelled`, keyed by `viewing_id`. Don't send them back to us with `POST /viewings`, or they'll be
counted twice.

## Several people at one viewing

Send one call per person, each with its own `external_id` (for example `vw_88213:con_5531`). Two people sharing one
phone get one feedback conversation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.