---
title: "Get Guest Visits"
method: GET
path: "/guest/v1/visits"
tags: ["Visits"]
---

# Get Guest Visits

`GET /guest/v1/visits`

Returns a list of visits in a site.

## Query parameters

- `site_id` string, uuid, required — The unique identifier of the Guest site. Valid sites can be retrieved with the Guest Site API.
- `start_time` integer, required — The start of the time range for requested visits. Formatted as a UNIX timestamp. Must be at most one day away from end_time.
- `end_time` integer, required — The end of the time range for requested visits. Formatted as a UNIX timestamp. Must be at most one day away from start_time.
- `page_token` string — The pagination token used to fetch the next page of results.
- `page_size` integer — The number of items returned in a single response. Default is 100. Max is 200.

## Response `200`

OK

- VisitResponse
  - `visits` VisitResponseItem[], required
    - `approval_status` string, required — The overall approval status of the visit - factoring in host approvals, questionnaires, and security screens. Can be one of: <code>PENDING</code> (host approval or background check not yet complete), <code>APPROVED</code> (all steps passed), or <code>DENIED</code> (visitor was denied entry due to one or more failures).
    - `check_in_time` integer, required — Timestamp at which the visitor checked in. Only present if the visit is successful (as opposed to denied or pending).
    - `deleted` boolean, required — True if the visit has been deleted within Command, false otherwise.
    - `device_name` string, required — Name of the tablet that checked in the visit.
    - `guest` GuestResponseItem
      - `created` integer, required — UTC timestamp at which the guest item was created.
      - `email` string, required — Email of the guest.
      - `full_name` string, required — Full name of the guest, if provided.
      - `guest_id` string, uuid, required — The unique identifier of the guest tied to this visit. Note that this will be different across visits, even if the guest is the same.
      - `has_photo` boolean, required — Whether the guest has a photo available.
      - `image_url` string — A *non-permanent* URL to the image of the guest. Only present if the guest provided an image at sign-in.
      - `is_sign_urls` boolean — Whether the provided image URL is a presigned URL. True by default. Undefined for student visits.
      - `person_id` string, required — The unique identifier of the Person of Interest created from this guest, if applicable.
      - `phone_number` string, required — Phone number of the guest.
    - `host` HostResponseItem
      - `delivery_location` string, required — (Mailroom) The host's default package delivery location.
      - `first_name` string, required — The preferred first name of the host. If none is specified by the host, the same as original_first_name.
      - `full_name` string, required — The full name of the host.
      - `has_delegate` boolean, required — Whether the host has a delegate assigned.
      - `has_email` boolean, required — Whether the host has an email address present.
      - `has_phone_number` boolean, required — Whether the host has a phone number present.
      - `host_id` string, uuid, required — The unique identifier of the host.
      - `last_name` string, required — The last name of the host.
      - `original_first_name` string, required — The original first name of the host.
      - `requires_host_approval` boolean, required — Whether the host requires host approval on all visits.
      - `student_id` string — For student-related visits, the student ID of the visit's student.
      - `student_number` string — For student-related visits, the student number of the visit's student.
    - `host_approval_status` string, required — Only present if the visit required host approval. Can be one of: <code>APPROVED</code> (approved by host), <code>PENDING</code> (host hasn't responded yet) or <code>DENIED</code> (denied by host).
    - `hosts` HostResponseItem[] — The host metadata associated with this visit.
      - `delivery_location` string, required — (Mailroom) The host's default package delivery location.
      - `first_name` string, required — The preferred first name of the host. If none is specified by the host, the same as original_first_name.
      - `full_name` string, required — The full name of the host.
      - `has_delegate` boolean, required — Whether the host has a delegate assigned.
      - `has_email` boolean, required — Whether the host has an email address present.
      - `has_phone_number` boolean, required — Whether the host has a phone number present.
      - `host_id` string, uuid, required — The unique identifier of the host.
      - `last_name` string, required — The last name of the host.
      - `original_first_name` string, required — The original first name of the host.
      - `requires_host_approval` boolean, required — Whether the host requires host approval on all visits.
      - `student_id` string — For student-related visits, the student ID of the visit's student.
      - `student_number` string — For student-related visits, the student number of the visit's student.
    - `is_contactless` boolean, required — True if the visit was made via the web, false if the visit was made via a tablet.
    - `next_page_token` string — The pagination token used to fetch the next page of results.
    - `open_ended_responses` OEQResponseItem[], required — Any open-ended question responses associated with this visit.
      - `chosen_answers` string[] — Chosen multiple-choice answers.
      - `question` string, required — The question answered by the visitor.
      - `response` string, required — The visitor's answer to the question. Also contains custom responses to multiple-choice questions.
    - `questionnaires` QuestionnaireResponseItem[], required — Any questionnaire responses associated with this visit.
      - `passed` boolean, required — Whether or not the visitor passed the questionnaire.
      - `questionnaire` string, required — The name of the questionnaire completed by the visitor.
    - `security_screen_status` string, required — Only present if the visit required a security screen. Can be one of: <code>NOT_STARTED</code> (visit submitted, security screen not yet submitted to provider), <code>START</code> (visitor information submitted to provider), <code>NO_MATCH</code> (screening complete, no match found), <code>NEEDS_REVIEW</code> (screening found potential match, needs human verification), <code>CONFIRMED_MATCH</code> (user-confirmed match) <code>ERROR</code> (error with security screen provider) or <code>CANCELED</code> (security screen not completed due to cancellation or time-out).
    - `sign_out_time` integer, required — Timestamp at which the visitor signed out.
    - `signatures` SignatureResponseItem[], required — Any document signatures associated with this visit.
      - `doc_signature_id` string, uuid, required — The unique identifier for the signed document.
      - `document_id` string, uuid, required — The unique identifier of the document the visitor signed.
      - `pdf_url` string, required — A *non-permanent* URL pointing to a PDF of the signed document.
      - `visit_id` string, uuid, required — The unique identifier of the visit the document signature corresponds to.
    - `site_id` string, uuid, required — The unique identifier of the Guest site.
    - `visit_id` string, uuid, required — The unique identifier of the visit.
    - `visit_type` string, required — Name of the visitor type the guest checked in as.

---

[API](https://skmtc.net/verkada/apis/api-tokens.md) · [All operations](https://skmtc.net/verkada/apis/api-tokens/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verkada/api-tokens/revisions/4a79d2d949a6/schema)