Listing visitors

GET /visitors/bycompany/{company_id}

The visitor log — the same data the Backoffice grid shows. A visitor is one visit, not a person.

Path parameters

string

required

The location.

Query parameters

integer

required

Rows to return, e.g. 50.

integer

required

1-based page number.

string

asc or desc, e.g. sorting[signed_in]=desc.

string

Case-insensitive substring match on any field, e.g. filter[company]=acme.

string

Together with filter[field][endDate], restricts a date field to a range. Both ISO 8601.

Response

number

Visits matching the filter, ignoring paging.

array

The page of visits. Photos and signatures are left out — fetch a single visitor for those.

Show visit

string

The visit id.

string

Visitor’s first name.

string

Visitor’s last name.

string

The organisation the visitor comes from.

string

Visitor’s email address.

string

Phone number, international format.

string

Name of the host being visited.

string

Where the host’s notification went.

string

Id of the visit type used.

string

Entrance the visitor came through.

string

Set when the visit came from a registered visitor.

string

When the visit started.

string

When it ended. Absent while the visitor is inside.

number

0 Backoffice or API · 1 kiosk · 2 contactless.

number

Same scale, for the sign-out.

string

pending, approved or rejected on screened visit types.

boolean

Marked safe during an evacuation.

string

When the visit was last changed.

Every custom field the visit type defines is on the visit too, under its own field_name.

curl -G https://api.vizito.eu/api/visitors/bycompany/5f2a1b9c4d3e2f0011223344 \
  -H "Authorization: Bearer $VIZITO_API_KEY" \
  -d count=50 -d page=1 \
  --data-urlencode "sorting[signed_in]=desc" \
  --data-urlencode "filter[signed_in][startDate]=2026-08-01T00:00:00.000Z" \
  --data-urlencode "filter[signed_in][endDate]=2026-09-01T00:00:00.000Z"

{
  "total": 128,
  "visitors": [
    {
      "_id": "66b0f1a2c3d4e5f600112233",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "company": "Analytical Engines Ltd",
      "email": "ada@example.com",
      "recipient": "Jane Doe",
      "visit_type": "5f2a1b9c4d3e2f0011223399",
      "signed_in": "2026-08-29T07:58:11.000Z",
      "signed_in_source": 1
    }
  ]
}

count and page are required. Without them the endpoint answers 400 Please include count, page and sorting query parameters.

Getting started

Locations

Visitors

Registered visitors

Hosts

Visit types

Entry points

Agreements

Devices

Reporting

Webhooks

Listing visitors

Path parameters

Query parameters

Response

​Path parameters

​Query parameters

​Response

Path parameters

Query parameters

Response