Signing in registered visitors
curl --request POST \
--url https://api.vizito.eu/api/companies/{company_id}/knownvisitors/signin \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
"5f2a1b9c4d3e2f0011223344"
]
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify(['5f2a1b9c4d3e2f0011223344'])
};
fetch('https://api.vizito.eu/api/companies/{company_id}/knownvisitors/signin', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vizito.eu/api/companies/{company_id}/knownvisitors/signin"
payload = ["5f2a1b9c4d3e2f0011223344"]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vizito.eu/api/companies/{company_id}/knownvisitors/signin",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'5f2a1b9c4d3e2f0011223344'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}[
{
"id": "5f2a1b9c4d3e2f0011223344",
"status": "success",
"visitorId": "5f2a1b9c4d3e2f0011223344",
"reason": "<string>"
}
]{
"message": "<string>"
}{
"error": "Invalid API key"
}Registered visitors
Signing in registered visitors
Creates a visit from each registered visitor, exactly as scanning their QR code at the kiosk would. Somebody already inside is skipped, not signed in twice, so the call is safe to repeat.
POST
/
companies
/
{company_id}
/
knownvisitors
/
signin
Signing in registered visitors
curl --request POST \
--url https://api.vizito.eu/api/companies/{company_id}/knownvisitors/signin \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
"5f2a1b9c4d3e2f0011223344"
]
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify(['5f2a1b9c4d3e2f0011223344'])
};
fetch('https://api.vizito.eu/api/companies/{company_id}/knownvisitors/signin', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vizito.eu/api/companies/{company_id}/knownvisitors/signin"
payload = ["5f2a1b9c4d3e2f0011223344"]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vizito.eu/api/companies/{company_id}/knownvisitors/signin",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'5f2a1b9c4d3e2f0011223344'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}[
{
"id": "5f2a1b9c4d3e2f0011223344",
"status": "success",
"visitorId": "5f2a1b9c4d3e2f0011223344",
"reason": "<string>"
}
]{
"message": "<string>"
}{
"error": "Invalid API key"
}Authorizations
An API key issued in the Backoffice, sent as Authorization: Bearer vzk_<key id>_<secret>.
A Microsoft Entra ID access token obtained with the client credentials
grant is accepted on the same header. The same value is also accepted in
an X-API-Key header.
Path Parameters
The location. A 24-character hexadecimal id.
Pattern:
^[0-9a-fA-F]{24}$Example:
"5f2a1b9c4d3e2f0011223344"
Body
application/json
A 24-character hexadecimal id.
Pattern:
^[0-9a-fA-F]{24}$Response
One result per id, carrying the new visit id on success.

