visits.notices

Customer notices planned or handled for a visit (appointment reminder, on the way, arrived), with status pending, queued (handed to text, email, or both), cancelled or skipped and why. Owner or office.

WhoAgents can call this
RESTGET /v1/visits/notices
MCP toolvisits_notices
Writesno
AreaScheduling and visits

When to use it

Customer notices planned or handled for a visit (appointment reminder, on the way, arrived), with status pending, queued (handed to text, email, or both), cancelled or skipped and why. Owner or office.

What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

Input

FieldTypeRequired
visit_idstring (uuid)yes

Example

GET https://doingwork.work/v1/visits/notices?visit_id=00000000-0000-4000-8000-000000000000

Output

FieldTypeAlways there
visit_idstring (uuid)yes
itemsarrayyes
items[].notice_idstring (uuid)no
items[].kindstring (one of appointment_reminder, on_my_way, arrived)no
items[].due_atstring (date-time)no
items[].statusstring (one of pending, queued, cancelled, skipped)no
items[].outcome['string', 'null']no
items[].customer_email_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']no
items[].finished_at['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')']no
{
  "visit_id": "00000000-0000-4000-8000-000000000000",
  "items": [
    {
      "notice_id": "00000000-0000-4000-8000-000000000000",
      "kind": "appointment_reminder",
      "due_at": "...",
      "status": "pending",
      "outcome": "...",
      "customer_email_id": "00000000-0000-4000-8000-000000000000",
      "finished_at": "..."
    }
  ]
}

Errors

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.