Gets a single company visit

Retrieves one visit with its visitors, their check-in state, the host and the visit type. Cancelled visits are returned with status cancelled. A visit of another company is reported as not found. Requires the Visitors module.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

The requested visit

Bodyapplication/json

Example

{
    "id": "b1eebc99-9c0b-4ef8-bb6d-6bb9bd380b01",
    "officeId": "a1eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
    "visitType": {
        "id": "f1eebc99-9c0b-4ef8-bb6d-6bb9bd380f01",
        "name": "Business"
    },
    "name": "Quarterly review",
    "status": "scheduled",
    "anonymized": false,
    "startTime": "2026-06-24T09:00:00.000Z",
    "endTime": "2026-06-24T10:00:00.000Z",
    "host": {
        "id": "d1eebc99-9c0b-4ef8-bb6d-6bb9bd380d01",
        "email": "john.host@deskbird.com",
        "firstName": "John",
        "lastName": "Host"
    },
    "visitors": [
        {
            "id": "c1eebc99-9c0b-4ef8-bb6d-6bb9bd380c01",
            "userId": null,
            "email": "jane.visitor@example.com",
            "firstName": "Jane",
            "lastName": "Visitor",
            "companyName": "Example Ltd",
            "status": "checkedIn",
            "checkedInAt": "2026-06-24T09:02:00.000Z",
            "checkedOutAt": null,
            "checkedInSource": "webapp",
            "anonymized": false
        }
    ],
    "completedAt": null,
    "cancelledAt": null,
    "createdAt": "2026-06-01T08:00:00.000Z",
    "updatedAt": "2026-06-24T09:02:00.000Z",
    "createdByUserId": "d1eebc99-9c0b-4ef8-bb6d-6bb9bd380d01"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Gets a single company visit

Request

Request Code Samples

Responses