Italy Alloggiati Web Guest Reporting with Passport OCR

The Requirement

Italian accommodations report guest identity details to the police through the Alloggiati Web portal shortly after arrival. Short-term rental hosts collect document photos remotely and copy each field into the portal by hand.

Capture Once, Confirm, Then Report

Extract document details from guest photos, review them, and prepare the Alloggiati Web submission from structured data. The passport OCR API returns structured JSON, so the same record can feed your forms, reports, and audit trail. Confirm current reporting fields and deadlines with the Questura and Alloggiati Web guidance.

Workflow Applications

Server-Side Integration

Send the passport image from your backend and keep only the fields your process needs.

import base64
import os
import requests

with open("passport.jpg", "rb") as image_file:
    image = base64.b64encode(image_file.read()).decode("ascii")

response = requests.post(
    "https://api.structocr.com/v1/passport",
    headers={"x-api-key": os.environ["STRUCTOCR_API_KEY"]},
    json={"img": image},
    timeout=30,
)

if response.ok:
    data = response.json()["data"]
    print("surname:", data.get("surname"))
    print("given_names:", data.get("given_names"))
    print("date_of_birth:", data.get("date_of_birth"))
    print("passport_number:", data.get("passport_number"))
else:
    print("Retake or review:", response.json().get("error"))

{
  "success": true,
  "data": {
    "surname": "SAMPLE",
    "given_names": "SAMPLE",
    "date_of_birth": "1990-01-01",
    "passport_number": "SAMPLE"
  }
}