Check-Ins

Manage digital guest check-ins. Filoxenos provides a secure way to collect guest PII (Personally Identifiable Information) required for AADE reporting.

GET/checkins

Lists recent guest check-ins across your properties.

Scoperead

Query Parameters

Parameter	Type	Description
`property_id`	uuid	Filter by property.
`status`	enum	PENDING \| COMPLETE \| EXPIRED \| FALLBACK
`date_from`	date	Check-in start date window.
`date_to`	date	Check-in end date window.

Status Definitions

PENDING: Link sent, guest hasn't submitted yet.
COMPLETE: Guest submitted data successfully.
EXPIRED: Stay has ended without completion.
FALLBACK: Host manually entered data because guest failed to do so.

Data Privacy Note

Guest identity data is encrypted at rest and decrypted only when returned via authenticated API calls. Access to these endpoints is logged for security auditing.

Example Response

json

{
  "data": [
    {
      "id": "chk_556677",
      "booking_id": "book_abc123",
      "status": "COMPLETE",
      "guest": {
        "type": "DOMESTIC",
        "name": "Konstantinos Theodorou",
        "nationality": "GR",
        "tax_id": "123456789",
        "document_type": null,
        "document_number": null
      },
      "completed_at": "2026-06-14T18:22:00Z"
    }
  ]
}

Guest Classification

AADE requires different information depending on whether the guest is a Greek resident or a foreign visitor.

Domestic Guests

Requires a Greek Tax ID (ΑΦΜ). Document numbers are usually not required for domestic guests.

Foreign Guests

Requires nationality, document type (Passport/ID), and a valid document number.

POST/checkins/:id/resend

Triggers a new check-in request email/SMS to the guest.

Scopewrite

This endpoint only works if the check-in status is PENDING.