Server definition
- Hash
- sha256:5e377c616df59978625e70e8d489e5b71ffefc1f4768320461a7a34957350e77
- What it is
- What a remote MCP server returned when asked what it offers: 6 tools
The blob, as servednamed by its sha256
{
"instructions": "Ospitario is a vacation-rental registry for Italy, Germany, Spain, France and Portugal: one passport per home, with the proof level reached and direct, commission-free contact to the operator. Use it to find a place to stay or the operator behind a listing the traveler already knows, then give the traveler the contactPageUrl: contact is direct and commission-free. An empty result means no operator with a verified claim matches; say so instead of guessing. A result marked unclaimed (tier L0) holds facts from the operator's website with nothing proven and no direct contact; say so, and use send_inquiry to write. Calendar dates are a hint, never a booking commitment.",
"tools": [
{
"description": "Full passport of one property: attributes stated by the operator (provenance says who states them and when they changed; they are not checked by Ospitario), the pool's stated facets (null: not stated), tier and date, registration status, direct contact, blocked dates, liability insurance and safety equipment as declared by the operator, priceFrom (indicative, negotiated directly, no booking), and the page link to hand to the traveler. No booking through Ospitario; an inquiry can be sent to the operator with send_inquiry, or the traveler uses the direct contact on the passport. Insurance status and safety equipment are host-declared, not verified: Ospitario has seen no policy and no device. Availability is a hint, never a booking commitment: a night not blocked in the operator's synced calendar may already be taken, since the calendar is a copy that can lag behind; only the operator confirms availability, and Ospitario holds or books nothing. Prices are indicative, stated by the host (on an unclaimed passport: taken from the official website), negotiated directly with the host; there is no booking through Ospitario. Every result is a property with a proven listing (L2/L2c), a verified operator (L3), a right to manage verified by document review (LA) or, marked L0 and unclaimed, facts from the operator's official website with nothing proven; the result names the tier and the date it was reached, and whether the registration number (Italy: CIN) was checked against the public register. Contact is direct with the operator and commission-free, so the traveler pays no platform fee. No result means nothing proven matches; nothing is inferred, estimated or filled in.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"lang": {
"description": "Language of labels in the result; defaults to en",
"enum": [
"it",
"de",
"en",
"es",
"pt",
"fr"
],
"type": "string"
},
"slug": {
"description": "Passport slug from a search or lookup result",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_passport",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"contactPageUrl": {
"description": "Page with the passport and the operator's direct contact; give this link to the traveler",
"type": "string"
},
"found": {
"type": "boolean"
},
"jsonLd": {
"additionalProperties": {},
"description": "schema.org VacationRental of the passport",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"property": {
"additionalProperties": false,
"properties": {
"amenities": {
"description": "Amenities in the operator's own words",
"items": {
"type": "string"
},
"type": "array"
},
"availability": {
"additionalProperties": false,
"properties": {
"lastSync": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Last successful calendar sync, ISO timestamp"
},
"status": {
"description": "calendar: blocked dates come from the operator's calendar, synced recently (lastSync); unblocked nights are not confirmed free; on_request: the operator answers availability on request, no dates are published; unknown: no current calendar, ask the operator. Availability is a hint, never a booking commitment: a night not blocked in the operator's synced calendar may already be taken, since the calendar is a copy that can lag behind; only the operator confirms availability, and Ospitario holds or books nothing.",
"enum": [
"calendar",
"on_request",
"unknown"
],
"type": "string"
}
},
"required": [
"status",
"lastSync"
],
"type": "object"
},
"bathrooms": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Bathrooms; a half bath counts 0.5. null: not stated."
},
"bedrooms": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"beds": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bunk": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"double": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"single": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"sofa": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"double",
"single",
"sofa",
"bunk"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Beds by kind as the operator states them; null: not stated"
},
"blocked": {
"description": "Blocked date ranges from the operator's calendar as last synced; a night not listed is not confirmed free",
"items": {
"additionalProperties": false,
"properties": {
"from": {
"description": "First blocked night, YYYY-MM-DD",
"type": "string"
},
"to": {
"description": "Checkout day, YYYY-MM-DD (exclusive)",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"type": "array"
},
"booking": {
"additionalProperties": false,
"description": "What a traveler can do with this passport: contact the operator, never book through Ospitario. Availability is separate (availability, blocked)",
"properties": {
"bookable": {
"const": false,
"description": "Always false: Ospitario takes no bookings and no payment. A result, a free night or a sent inquiry reserves nothing; the operator confirms dates and price",
"type": "boolean"
},
"contact": {
"description": "direct: the operator's own channels are in contact, and send_inquiry mails the operator; relay_only: unclaimed, write with send_inquiry (the official website in contact.site is the operator's own page, not an inquiry channel of Ospitario). send_inquiry may still refuse, with a reason",
"enum": [
"direct",
"relay_only"
],
"type": "string"
}
},
"required": [
"bookable",
"contact"
],
"type": "object"
},
"cancellation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"capacity": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Maximum number of guests"
},
"checkinFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Check-in from, HH:MM local time; null: not stated"
},
"checkoutUntil": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Checkout until, HH:MM local time; null: not stated (a stated 00:00, usually 12:00 AM typed for noon, counts as not stated)"
},
"childrenAllowed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether children are welcome, as the operator states it; null: not stated"
},
"cleaningFee": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"description": "Per stay, as stated; 0: none",
"type": "number"
},
"currency": {
"const": "EUR",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cleaning fee per stay as the operator states it; null: not stated (which is not the same as none; see extraCosts)"
},
"contact": {
"additionalProperties": false,
"description": "Direct contact of the operator; no commission and no intermediary",
"properties": {
"email": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"site": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"whatsapp": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phone",
"whatsapp",
"email",
"site"
],
"type": "object"
},
"country": {
"description": "ISO 3166-1 alpha-2 country code",
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"eventsAllowed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether parties or events are allowed, as the operator states it; null: not stated"
},
"extraCosts": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Costs beyond the nightly price in the operator's words (cleaning, tourist tax, linen, energy); null: not stated, which is not the same as none (a bare number without what or currency counts as not stated)"
},
"facilities": {
"additionalProperties": false,
"description": "true: there, false: stated absent, null: not stated. The operator's yes/no wins; otherwise read from the amenity lines by fixed patterns, as for the pool",
"properties": {
"airConditioning": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"balcony": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"bbq": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "A barbecue or outdoor grill"
},
"crib": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "A cot for a baby"
},
"elevator": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"fireplace": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"heating": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"hotTub": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"kitchen": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"microwave": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"parking": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"tv": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"washingMachine": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"wifi": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"workspace": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "A place to work (desk); not a statement about the internet speed"
}
},
"required": [
"parking",
"workspace",
"airConditioning",
"heating",
"wifi",
"kitchen",
"washingMachine",
"tv",
"bbq",
"crib",
"elevator",
"hotTub",
"fireplace",
"balcony",
"microwave"
],
"type": "object"
},
"floorArea": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Living area in square metres as the operator states it; null: not stated"
},
"houseRules": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"languages": {
"description": "Languages the operator speaks, as written on their website (unclaimed passports)",
"items": {
"type": "string"
},
"type": "array"
},
"liabilityInsurance": {
"anyOf": [
{
"additionalProperties": false,
"description": "Liability insurance (RC). Insurance status and safety equipment are host-declared, not verified: Ospitario has seen no policy and no device. null: the operator said nothing. The traveler should ask the operator for the policy before booking; platform guarantees (e.g. AirCover) do not cover direct bookings.",
"properties": {
"insurer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Insurer as named by the operator"
},
"label": {
"type": "string"
},
"status": {
"description": "declared: the operator states a liability insurance (RC) policy; none: the operator states there is none",
"enum": [
"declared",
"none"
],
"type": "string"
},
"validUntil": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "End of the policy as stated by the operator, YYYY-MM-DD"
}
},
"required": [
"status",
"insurer",
"validUntil",
"label"
],
"type": "object"
},
{
"type": "null"
}
]
},
"location": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"streetAddress": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"latitude",
"longitude",
"streetAddress",
"postalCode"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Exact location and address, only when the operator chose to publish them; never for an unclaimed passport"
},
"locationNotes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"minNights": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Minimum stay in nights as the operator states it; null: not stated, ask the operator"
},
"municipality": {
"type": "string"
},
"name": {
"type": "string"
},
"petsAllowed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether pets are allowed, as the operator states it; null: not stated, ask the operator."
},
"placeKind": {
"anyOf": [
{
"enum": [
"entire",
"private_room",
"shared_room"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "What the guest rents: the entire place, a private room or a shared room. Declared by the operator; null: not stated."
},
"pool": {
"additionalProperties": false,
"description": "The pool, facet by facet; null: not stated. Never inferred.",
"properties": {
"access": {
"anyOf": [
{
"enum": [
"private",
"shared"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "null: not stated, or the lines disagree"
},
"heated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "true: a heated or heatable pool. It does not say the pool is heated on given dates: see heatedSeason and heating. null: not stated"
},
"heatedSeason": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Days the pool is heated every year, MM-DD to MM-DD; null: not declared, or several periods (see heatedSeasons)"
},
"heatedSeasons": {
"description": "Every period the pool is heated each year; empty: not declared",
"items": {
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
"type": "array"
},
"heating": {
"anyOf": [
{
"enum": [
"none",
"included",
"surcharge",
"on_request"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "As the operator declares it: no heating, heating included, heating for a surcharge, heating on request (notice in notes); null: not declared"
},
"notes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Conditions in the operator's words: surcharge, notice for heating, hours, age rules"
},
"present": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "true: the operator declares a pool, or a line names a pool of the house; false: declared or stated absent; null: not stated"
},
"season": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Days the pool is open every year, MM-DD to MM-DD inclusive (may run across New Year); null when several periods are declared (see seasons); null: not declared, ask the operator"
},
"seasons": {
"description": "Every period the pool is open each year, as the operator declares them; empty: not declared, ask the operator",
"items": {
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
"type": "array"
},
"setting": {
"anyOf": [
{
"enum": [
"indoor",
"outdoor"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "null: not stated"
},
"source": {
"anyOf": [
{
"enum": [
"operator",
"amenity_text"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "operator: declared in the passport's pool fields; amenity_text: read from the amenity lines by fixed patterns in six languages, a line that places the pool elsewhere (public, nearby) does not count; null: nothing about a pool"
}
},
"required": [
"present",
"access",
"setting",
"heated",
"heating",
"season",
"heatedSeason",
"seasons",
"heatedSeasons",
"notes",
"source"
],
"type": "object"
},
"priceFrom": {
"anyOf": [
{
"additionalProperties": false,
"description": "Indicative price per night. Prices are indicative, stated by the host (on an unclaimed passport: taken from the official website), negotiated directly with the host; there is no booking through Ospitario. null: the operator gave no price.",
"properties": {
"currency": {
"enum": [
"EUR"
],
"type": "string"
},
"label": {
"description": "e.g. \"da 120 €/notte\"",
"type": "string"
},
"nightlyFrom": {
"description": "Lowest nightly price among the current and future periods",
"type": "number"
},
"seasons": {
"description": "Current and future periods; ended ones are left out",
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"enum": [
"EUR"
],
"type": "string"
},
"label": {
"type": "string"
},
"nightlyFrom": {
"description": "Lowest nightly price the operator states for this period",
"type": "number"
},
"seasonLabel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Season name in the operator's words"
},
"validFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "First day of the period, YYYY-MM-DD; null: no start given"
},
"validTo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Last day of the period, YYYY-MM-DD; null: no end given"
}
},
"required": [
"nightlyFrom",
"currency",
"seasonLabel",
"validFrom",
"validTo",
"label"
],
"type": "object"
},
"type": "array"
},
"updatedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When the operator last changed the prices, YYYY-MM-DD"
}
},
"required": [
"nightlyFrom",
"currency",
"label",
"seasons",
"updatedAt"
],
"type": "object"
},
{
"type": "null"
}
]
},
"propertyKind": {
"anyOf": [
{
"enum": [
"apartment",
"house",
"villa",
"farmhouse",
"trullo",
"cottage",
"chalet",
"other"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Kind of building from a fixed list (farmhouse: masseria, casale; trullo: Apulian trullo); type keeps the operator's own word. null: not stated"
},
"provenance": {
"additionalProperties": false,
"description": "Where the passport's facts come from; a proof level is about the operator and the listings, not about the house's features",
"properties": {
"facts": {
"description": "Who states the description, capacity, rooms, amenities, pool, rules and price: the operator through their account, or (unclaimed) the operator's official website as read by Ospitario",
"enum": [
"operator",
"official_website"
],
"type": "string"
},
"factsUpdatedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Last change of these facts, ISO timestamp; null: unknown. Calendar sync and verification have their own dates (availability.lastSync, verification.date)"
},
"register": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"license": {
"const": "CC BY 4.0",
"type": "string"
},
"page": {
"description": "The dataset's page",
"type": "string"
},
"recordDate": {
"description": "Last change of the register record, YYYY-MM-DD",
"type": "string"
},
"source": {
"description": "The register and its publisher, as the licence asks to name them",
"type": "string"
}
},
"required": [
"source",
"license",
"page",
"recordDate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Unclaimed only: the regional register completed facts the website does not state (CIN, municipality, category, beds, rooms); null: none from a register"
},
"verified": {
"const": false,
"description": "These facts are not checked by Ospitario. What is checked is named elsewhere: verification, references and trust (who may rent, which listings), registration.status (the number against the register)",
"type": "boolean"
}
},
"required": [
"facts",
"verified",
"factsUpdatedAt",
"register"
],
"type": "object"
},
"province": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Region code, ISO 3166-2 without the country prefix: IT/ES province (LE, GR), FR département (75), DE Land (HH), PT distrito (11)"
},
"references": {
"description": "Platform listings proven to belong to this operator, each with its own tier, date and passed proofs",
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"domain": {
"type": "string"
},
"label": {
"type": "string"
},
"listingId": {
"description": "The platform's own listing id (Booking: country/slug)",
"type": "string"
},
"proofs": {
"description": "Passed proofs only, with method and date",
"items": {
"additionalProperties": false,
"properties": {
"date": {
"description": "Last passed check, YYYY-MM-DD",
"type": "string"
},
"label": {
"type": "string"
},
"method": {
"description": "How listing control was proven. airbnb_calendar: the operator's Airbnb calendar export link carries the listing id; date_challenge: Ospitario named a random date, and the operator blocked it in the platform's calendar export within 48 hours (not used for new proofs since 2026-11-07); platform_email: a platform email to the operator with a valid DKIM signature; channel_manager: the operator's channel manager lists the listing.",
"enum": [
"airbnb_calendar",
"date_challenge",
"platform_email",
"channel_manager"
],
"type": "string"
}
},
"required": [
"method",
"label",
"date"
],
"type": "object"
},
"type": "array"
},
"tier": {
"enum": [
"L2",
"L2c"
],
"type": "string"
}
},
"required": [
"domain",
"listingId",
"tier",
"label",
"date",
"proofs"
],
"type": "object"
},
"type": "array"
},
"registration": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Day the number was last found in the official source (YYYY-MM-DD); a match of the code, never a check of the operator's identity"
},
"label": {
"type": "string"
},
"number": {
"description": "The registration number as the operator declared it (Italy: CIN); checked only as far as status says",
"type": "string"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The official source that confirmed the number, with its licence; null when none did"
},
"status": {
"description": "unchecked: the operator declared the country's short-term rental registration number (Italy: CIN), not yet checked against the public register; exists: the number is in the register; missing: the register no longer lists it.",
"enum": [
"unchecked",
"exists",
"missing"
],
"type": "string"
}
},
"required": [
"number",
"status",
"label",
"checkedAt",
"source"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Registration number status; null if the operator gave none"
},
"safety": {
"description": "Safety equipment the operator states is present. Insurance status and safety equipment are host-declared, not verified: Ospitario has seen no policy and no device. An item not listed is absent or not stated: see safetyStated.",
"items": {
"enum": [
"smokeDetector",
"gasDetector",
"coDetector",
"fireExtinguisher"
],
"type": "string"
},
"type": "array"
},
"safetyStated": {
"additionalProperties": false,
"description": "Each safety item: true present, false stated absent, null not stated. Insurance status and safety equipment are host-declared, not verified: Ospitario has seen no policy and no device.",
"properties": {
"coDetector": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"fireExtinguisher": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"gasDetector": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"smokeDetector": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"smokeDetector",
"gasDetector",
"coDetector",
"fireExtinguisher"
],
"type": "object"
},
"securityDeposit": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"description": "Per stay, as stated; 0: none",
"type": "number"
},
"currency": {
"const": "EUR",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Security deposit per stay as the operator states it; null: not stated"
},
"slug": {
"type": "string"
},
"smokingAllowed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether smoking is allowed inside, as the operator states it; null: not stated"
},
"stepFreeAccess": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether the home can be entered without steps, as the operator states it; null: not stated. Not an accessibility certification"
},
"summary": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"generated": {
"const": true,
"type": "boolean"
},
"text": {
"type": "string"
}
},
"required": [
"text",
"generated"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Two neutral sentences composed automatically from the facts of an unclaimed passport; not the operator's words"
},
"trust": {
"additionalProperties": false,
"description": "What Ospitario verified, by area: the managing account, authority over the property, platform listings",
"properties": {
"managedByHost": {
"description": "A host account with a confirmed email manages this passport; false for an unclaimed (L0) passport. A confirmed email proves nothing about the property",
"type": "boolean"
},
"propertyAuthority": {
"description": "Proofs that this operator may represent the property; empty when none. Independent of platform listings",
"items": {
"additionalProperties": false,
"properties": {
"date": {
"description": "YYYY-MM-DD",
"type": "string"
},
"method": {
"description": "operator_eid: eID identity matched to the registration holder (L3, Italy); document_review: documents checked by Ospitario's admin (LA)",
"enum": [
"operator_eid",
"document_review"
],
"type": "string"
}
},
"required": [
"method",
"date"
],
"type": "object"
},
"type": "array"
},
"verifiedListings": {
"description": "Platform listings with their own listing-control proof (see references); 0 is normal for a property without platforms",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"managedByHost",
"propertyAuthority",
"verifiedListings"
],
"type": "object"
},
"type": {
"description": "Accommodation type as stated by the operator",
"type": "string"
},
"unclaimed": {
"description": "true: an unclaimed passport (tier L0) built from the operator's official website; email and phone are not shown, write with send_inquiry",
"type": "boolean"
},
"unitCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Separately rentable homes this passport describes; 1: one home; more: ask the operator which unit the facts are for; null: not stated"
},
"verification": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"date": {
"description": "Date the tier was reached, YYYY-MM-DD",
"type": "string"
},
"label": {
"description": "Human-readable name of the tier",
"type": "string"
},
"tier": {
"description": "Verification tier (docs: ADR 0012, 0017, 0024, 0025). L0 unclaimed: facts read from the operator's official website, nothing proven, the operator has not claimed the page; contact only through send_inquiry. L2 listing verified: the operator proved control of the platform listing (calendar export link with the listing id, platform email with a valid DKIM signature, or channel manager); since 2026-11-07 also their right to manage the property (LA or L3), and earlier L2 stands as it was reached. L2c listing calendar proven (Booking, Vrbo): the operator blocked a random date Ospitario named in that platform's calendar export within 48 hours; no new L2c since 2026-11-07. LA right-to-manage documents reviewed: Ospitario's admin checked documents tying the operator to this property (registration record, deed, lease, mandate or company register); a person found them consistent, without eID, so it does not prove who holds the account and never proves a platform listing. L3 operator verified: the operator's eID identity (SPID/CIE) matches the CIN holder in the national register's PDF. L4 document verified (automated check): an ownership, lease or mandate document is consistent with that identity and the property; it states consistency, not authenticity. L5 manually verified: a reviewer checked the document (an optional upgrade; it does not affect search order).",
"enum": [
"L0",
"L2",
"L2c",
"LA",
"L3",
"L4",
"L5"
],
"type": "string"
}
},
"required": [
"tier",
"label",
"date"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Strongest current tier of the property and its listings"
}
},
"required": [
"slug",
"name",
"municipality",
"province",
"country",
"type",
"capacity",
"bedrooms",
"amenities",
"pool",
"placeKind",
"bathrooms",
"floorArea",
"petsAllowed",
"checkinFrom",
"checkoutUntil",
"location",
"minNights",
"beds",
"extraCosts",
"childrenAllowed",
"stepFreeAccess",
"unitCount",
"propertyKind",
"smokingAllowed",
"eventsAllowed",
"cleaningFee",
"securityDeposit",
"facilities",
"description",
"locationNotes",
"houseRules",
"cancellation",
"contact",
"verification",
"registration",
"references",
"availability",
"blocked",
"liabilityInsurance",
"priceFrom",
"unclaimed",
"summary",
"languages",
"safety",
"safetyStated",
"trust",
"provenance",
"booking"
],
"type": "object"
},
"reason": {
"description": "not_found: no public passport has this slug",
"enum": [
"not_found"
],
"type": "string"
}
},
"required": [
"found"
],
"type": "object"
}
},
{
"description": "Where Ospitario has public passports: every municipality with at least one, its region (Italy) and country, how many passports (and how many of them unclaimed, tier L0), and its list page. Call it when the traveler names an area, before searching: a place not listed has no passport on Ospitario yet; say so instead of searching it. Coverage is still small and grows week by week. Every result is a property with a proven listing (L2/L2c), a verified operator (L3), a right to manage verified by document review (LA) or, marked L0 and unclaimed, facts from the operator's official website with nothing proven; the result names the tier and the date it was reached, and whether the registration number (Italy: CIN) was checked against the public register. Contact is direct with the operator and commission-free, so the traveler pays no platform fee. No result means nothing proven matches; nothing is inferred, estimated or filled in.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"country": {
"description": "ISO 3166-1 alpha-2 country code to list: IT, DE, ES, FR or PT; all when omitted",
"enum": [
"IT",
"DE",
"ES",
"FR",
"PT"
],
"type": "string"
},
"lang": {
"description": "Language of labels in the result; defaults to en",
"enum": [
"it",
"de",
"en",
"es",
"pt",
"fr"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_places",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"places": {
"description": "Every municipality with at least one public passport, by country, region and name",
"items": {
"additionalProperties": false,
"properties": {
"country": {
"description": "ISO 3166-1 alpha-2 country code",
"type": "string"
},
"municipality": {
"type": "string"
},
"pageUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The municipality's list page on ospitario.com (Italy); null where none exists"
},
"passports": {
"description": "Public passports in this municipality, unclaimed ones included",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"province": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Region code as on the passports (IT province, e.g. LE); null when not stated"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Italian region (official name, e.g. Puglia); null outside Italy or when the passport names no province"
},
"unclaimed": {
"description": "Of these, unclaimed passports (tier L0): facts from the operator's website, nothing proven",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"country",
"region",
"municipality",
"province",
"passports",
"unclaimed",
"pageUrl"
],
"type": "object"
},
"type": "array"
},
"total": {
"description": "Public passports in the places listed",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"total",
"places"
],
"type": "object"
}
},
{
"description": "Find passports by property name: exact or prefix match, at least 3 characters, at most 10 results, exact match first, then alphabetical. Optionally limited to a municipality. Every result is a property with a proven listing (L2/L2c), a verified operator (L3), a right to manage verified by document review (LA) or, marked L0 and unclaimed, facts from the operator's official website with nothing proven; the result names the tier and the date it was reached, and whether the registration number (Italy: CIN) was checked against the public register. Contact is direct with the operator and commission-free, so the traveler pays no platform fee. No result means nothing proven matches; nothing is inferred, estimated or filled in.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"lang": {
"description": "Language of labels in the result; defaults to en",
"enum": [
"it",
"de",
"en",
"es",
"pt",
"fr"
],
"type": "string"
},
"municipality": {
"description": "Exact municipality name",
"maxLength": 80,
"minLength": 2,
"type": "string"
},
"name": {
"description": "Property name or its beginning, at least 3 characters",
"maxLength": 80,
"minLength": 3,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "lookup_by_name",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"results": {
"items": {
"additionalProperties": false,
"properties": {
"contactPageUrl": {
"description": "Page with the passport and the operator's direct contact; give this link to the traveler",
"type": "string"
},
"municipality": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"type": {
"description": "Accommodation type as stated by the operator",
"type": "string"
},
"verification": {
"additionalProperties": false,
"properties": {
"date": {
"description": "Date the tier was reached, YYYY-MM-DD",
"type": "string"
},
"label": {
"description": "Human-readable name of the tier",
"type": "string"
},
"tier": {
"description": "Verification tier (docs: ADR 0012, 0017, 0024, 0025). L0 unclaimed: facts read from the operator's official website, nothing proven, the operator has not claimed the page; contact only through send_inquiry. L2 listing verified: the operator proved control of the platform listing (calendar export link with the listing id, platform email with a valid DKIM signature, or channel manager); since 2026-11-07 also their right to manage the property (LA or L3), and earlier L2 stands as it was reached. L2c listing calendar proven (Booking, Vrbo): the operator blocked a random date Ospitario named in that platform's calendar export within 48 hours; no new L2c since 2026-11-07. LA right-to-manage documents reviewed: Ospitario's admin checked documents tying the operator to this property (registration record, deed, lease, mandate or company register); a person found them consistent, without eID, so it does not prove who holds the account and never proves a platform listing. L3 operator verified: the operator's eID identity (SPID/CIE) matches the CIN holder in the national register's PDF. L4 document verified (automated check): an ownership, lease or mandate document is consistent with that identity and the property; it states consistency, not authenticity. L5 manually verified: a reviewer checked the document (an optional upgrade; it does not affect search order).",
"enum": [
"L0",
"L2",
"L2c",
"LA",
"L3",
"L4",
"L5"
],
"type": "string"
}
},
"required": [
"tier",
"label",
"date"
],
"type": "object"
}
},
"required": [
"slug",
"name",
"municipality",
"type",
"verification",
"contactPageUrl"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"results"
],
"type": "object"
}
},
{
"description": "Resolve a listing link (Airbnb, Booking, Vrbo) to the operator's Ospitario passport, e.g. when a traveler wants to book a place they know directly. Exact match on the listing's own L2/L2c proof or found:false; never a list; a property verified only as an operator (L3) or an unclaimed passport (L0) is never returned for a link. The link is only parsed, never opened. Insurance status and safety equipment are host-declared, not verified: Ospitario has seen no policy and no device. Every result is a property with a proven listing (L2/L2c), a verified operator (L3), a right to manage verified by document review (LA) or, marked L0 and unclaimed, facts from the operator's official website with nothing proven; the result names the tier and the date it was reached, and whether the registration number (Italy: CIN) was checked against the public register. Contact is direct with the operator and commission-free, so the traveler pays no platform fee. No result means nothing proven matches; nothing is inferred, estimated or filled in.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"lang": {
"description": "Language of labels in the result; defaults to en",
"enum": [
"it",
"de",
"en",
"es",
"pt",
"fr"
],
"type": "string"
},
"url": {
"description": "Link to a listing on Airbnb, Booking or Vrbo",
"maxLength": 2000,
"minLength": 10,
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "lookup_by_url",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"contactPageUrl": {
"description": "Page with the passport and the operator's direct contact; give this link to the traveler",
"type": "string"
},
"found": {
"type": "boolean"
},
"property": {
"additionalProperties": false,
"properties": {
"amenities": {
"description": "Amenities in the operator's own words",
"items": {
"type": "string"
},
"type": "array"
},
"availability": {
"additionalProperties": false,
"properties": {
"lastSync": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Last successful calendar sync, ISO timestamp"
},
"status": {
"description": "calendar: blocked dates come from the operator's calendar, synced recently (lastSync); unblocked nights are not confirmed free; on_request: the operator answers availability on request, no dates are published; unknown: no current calendar, ask the operator. Availability is a hint, never a booking commitment: a night not blocked in the operator's synced calendar may already be taken, since the calendar is a copy that can lag behind; only the operator confirms availability, and Ospitario holds or books nothing.",
"enum": [
"calendar",
"on_request",
"unknown"
],
"type": "string"
}
},
"required": [
"status",
"lastSync"
],
"type": "object"
},
"bathrooms": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Bathrooms; a half bath counts 0.5. null: not stated."
},
"bedrooms": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"beds": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bunk": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"double": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"single": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"sofa": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"double",
"single",
"sofa",
"bunk"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Beds by kind as the operator states them; null: not stated"
},
"blocked": {
"description": "Blocked date ranges from the operator's calendar as last synced; a night not listed is not confirmed free",
"items": {
"additionalProperties": false,
"properties": {
"from": {
"description": "First blocked night, YYYY-MM-DD",
"type": "string"
},
"to": {
"description": "Checkout day, YYYY-MM-DD (exclusive)",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"type": "array"
},
"booking": {
"additionalProperties": false,
"description": "What a traveler can do with this passport: contact the operator, never book through Ospitario. Availability is separate (availability, blocked)",
"properties": {
"bookable": {
"const": false,
"description": "Always false: Ospitario takes no bookings and no payment. A result, a free night or a sent inquiry reserves nothing; the operator confirms dates and price",
"type": "boolean"
},
"contact": {
"description": "direct: the operator's own channels are in contact, and send_inquiry mails the operator; relay_only: unclaimed, write with send_inquiry (the official website in contact.site is the operator's own page, not an inquiry channel of Ospitario). send_inquiry may still refuse, with a reason",
"enum": [
"direct",
"relay_only"
],
"type": "string"
}
},
"required": [
"bookable",
"contact"
],
"type": "object"
},
"cancellation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"capacity": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Maximum number of guests"
},
"checkinFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Check-in from, HH:MM local time; null: not stated"
},
"checkoutUntil": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Checkout until, HH:MM local time; null: not stated (a stated 00:00, usually 12:00 AM typed for noon, counts as not stated)"
},
"childrenAllowed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether children are welcome, as the operator states it; null: not stated"
},
"cleaningFee": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"description": "Per stay, as stated; 0: none",
"type": "number"
},
"currency": {
"const": "EUR",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cleaning fee per stay as the operator states it; null: not stated (which is not the same as none; see extraCosts)"
},
"contact": {
"additionalProperties": false,
"description": "Direct contact of the operator; no commission and no intermediary",
"properties": {
"email": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"site": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"whatsapp": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phone",
"whatsapp",
"email",
"site"
],
"type": "object"
},
"country": {
"description": "ISO 3166-1 alpha-2 country code",
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"eventsAllowed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether parties or events are allowed, as the operator states it; null: not stated"
},
"extraCosts": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Costs beyond the nightly price in the operator's words (cleaning, tourist tax, linen, energy); null: not stated, which is not the same as none (a bare number without what or currency counts as not stated)"
},
"facilities": {
"additionalProperties": false,
"description": "true: there, false: stated absent, null: not stated. The operator's yes/no wins; otherwise read from the amenity lines by fixed patterns, as for the pool",
"properties": {
"airConditioning": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"balcony": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"bbq": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "A barbecue or outdoor grill"
},
"crib": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "A cot for a baby"
},
"elevator": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"fireplace": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"heating": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"hotTub": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"kitchen": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"microwave": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"parking": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"tv": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"washingMachine": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"wifi": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"workspace": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "A place to work (desk); not a statement about the internet speed"
}
},
"required": [
"parking",
"workspace",
"airConditioning",
"heating",
"wifi",
"kitchen",
"washingMachine",
"tv",
"bbq",
"crib",
"elevator",
"hotTub",
"fireplace",
"balcony",
"microwave"
],
"type": "object"
},
"floorArea": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Living area in square metres as the operator states it; null: not stated"
},
"houseRules": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"languages": {
"description": "Languages the operator speaks, as written on their website (unclaimed passports)",
"items": {
"type": "string"
},
"type": "array"
},
"liabilityInsurance": {
"anyOf": [
{
"additionalProperties": false,
"description": "Liability insurance (RC). Insurance status and safety equipment are host-declared, not verified: Ospitario has seen no policy and no device. null: the operator said nothing. The traveler should ask the operator for the policy before booking; platform guarantees (e.g. AirCover) do not cover direct bookings.",
"properties": {
"insurer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Insurer as named by the operator"
},
"label": {
"type": "string"
},
"status": {
"description": "declared: the operator states a liability insurance (RC) policy; none: the operator states there is none",
"enum": [
"declared",
"none"
],
"type": "string"
},
"validUntil": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "End of the policy as stated by the operator, YYYY-MM-DD"
}
},
"required": [
"status",
"insurer",
"validUntil",
"label"
],
"type": "object"
},
{
"type": "null"
}
]
},
"location": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"streetAddress": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"latitude",
"longitude",
"streetAddress",
"postalCode"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Exact location and address, only when the operator chose to publish them; never for an unclaimed passport"
},
"locationNotes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"minNights": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Minimum stay in nights as the operator states it; null: not stated, ask the operator"
},
"municipality": {
"type": "string"
},
"name": {
"type": "string"
},
"petsAllowed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether pets are allowed, as the operator states it; null: not stated, ask the operator."
},
"placeKind": {
"anyOf": [
{
"enum": [
"entire",
"private_room",
"shared_room"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "What the guest rents: the entire place, a private room or a shared room. Declared by the operator; null: not stated."
},
"pool": {
"additionalProperties": false,
"description": "The pool, facet by facet; null: not stated. Never inferred.",
"properties": {
"access": {
"anyOf": [
{
"enum": [
"private",
"shared"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "null: not stated, or the lines disagree"
},
"heated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "true: a heated or heatable pool. It does not say the pool is heated on given dates: see heatedSeason and heating. null: not stated"
},
"heatedSeason": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Days the pool is heated every year, MM-DD to MM-DD; null: not declared, or several periods (see heatedSeasons)"
},
"heatedSeasons": {
"description": "Every period the pool is heated each year; empty: not declared",
"items": {
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
"type": "array"
},
"heating": {
"anyOf": [
{
"enum": [
"none",
"included",
"surcharge",
"on_request"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "As the operator declares it: no heating, heating included, heating for a surcharge, heating on request (notice in notes); null: not declared"
},
"notes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Conditions in the operator's words: surcharge, notice for heating, hours, age rules"
},
"present": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "true: the operator declares a pool, or a line names a pool of the house; false: declared or stated absent; null: not stated"
},
"season": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Days the pool is open every year, MM-DD to MM-DD inclusive (may run across New Year); null when several periods are declared (see seasons); null: not declared, ask the operator"
},
"seasons": {
"description": "Every period the pool is open each year, as the operator declares them; empty: not declared, ask the operator",
"items": {
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
"type": "array"
},
"setting": {
"anyOf": [
{
"enum": [
"indoor",
"outdoor"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "null: not stated"
},
"source": {
"anyOf": [
{
"enum": [
"operator",
"amenity_text"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "operator: declared in the passport's pool fields; amenity_text: read from the amenity lines by fixed patterns in six languages, a line that places the pool elsewhere (public, nearby) does not count; null: nothing about a pool"
}
},
"required": [
"present",
"access",
"setting",
"heated",
"heating",
"season",
"heatedSeason",
"seasons",
"heatedSeasons",
"notes",
"source"
],
"type": "object"
},
"priceFrom": {
"anyOf": [
{
"additionalProperties": false,
"description": "Indicative price per night. Prices are indicative, stated by the host (on an unclaimed passport: taken from the official website), negotiated directly with the host; there is no booking through Ospitario. null: the operator gave no price.",
"properties": {
"currency": {
"enum": [
"EUR"
],
"type": "string"
},
"label": {
"description": "e.g. \"da 120 €/notte\"",
"type": "string"
},
"nightlyFrom": {
"description": "Lowest nightly price among the current and future periods",
"type": "number"
},
"seasons": {
"description": "Current and future periods; ended ones are left out",
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"enum": [
"EUR"
],
"type": "string"
},
"label": {
"type": "string"
},
"nightlyFrom": {
"description": "Lowest nightly price the operator states for this period",
"type": "number"
},
"seasonLabel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Season name in the operator's words"
},
"validFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "First day of the period, YYYY-MM-DD; null: no start given"
},
"validTo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Last day of the period, YYYY-MM-DD; null: no end given"
}
},
"required": [
"nightlyFrom",
"currency",
"seasonLabel",
"validFrom",
"validTo",
"label"
],
"type": "object"
},
"type": "array"
},
"updatedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When the operator last changed the prices, YYYY-MM-DD"
}
},
"required": [
"nightlyFrom",
"currency",
"label",
"seasons",
"updatedAt"
],
"type": "object"
},
{
"type": "null"
}
]
},
"propertyKind": {
"anyOf": [
{
"enum": [
"apartment",
"house",
"villa",
"farmhouse",
"trullo",
"cottage",
"chalet",
"other"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Kind of building from a fixed list (farmhouse: masseria, casale; trullo: Apulian trullo); type keeps the operator's own word. null: not stated"
},
"provenance": {
"additionalProperties": false,
"description": "Where the passport's facts come from; a proof level is about the operator and the listings, not about the house's features",
"properties": {
"facts": {
"description": "Who states the description, capacity, rooms, amenities, pool, rules and price: the operator through their account, or (unclaimed) the operator's official website as read by Ospitario",
"enum": [
"operator",
"official_website"
],
"type": "string"
},
"factsUpdatedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Last change of these facts, ISO timestamp; null: unknown. Calendar sync and verification have their own dates (availability.lastSync, verification.date)"
},
"register": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"license": {
"const": "CC BY 4.0",
"type": "string"
},
"page": {
"description": "The dataset's page",
"type": "string"
},
"recordDate": {
"description": "Last change of the register record, YYYY-MM-DD",
"type": "string"
},
"source": {
"description": "The register and its publisher, as the licence asks to name them",
"type": "string"
}
},
"required": [
"source",
"license",
"page",
"recordDate"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Unclaimed only: the regional register completed facts the website does not state (CIN, municipality, category, beds, rooms); null: none from a register"
},
"verified": {
"const": false,
"description": "These facts are not checked by Ospitario. What is checked is named elsewhere: verification, references and trust (who may rent, which listings), registration.status (the number against the register)",
"type": "boolean"
}
},
"required": [
"facts",
"verified",
"factsUpdatedAt",
"register"
],
"type": "object"
},
"province": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Region code, ISO 3166-2 without the country prefix: IT/ES province (LE, GR), FR département (75), DE Land (HH), PT distrito (11)"
},
"references": {
"description": "Platform listings proven to belong to this operator, each with its own tier, date and passed proofs",
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"domain": {
"type": "string"
},
"label": {
"type": "string"
},
"listingId": {
"description": "The platform's own listing id (Booking: country/slug)",
"type": "string"
},
"proofs": {
"description": "Passed proofs only, with method and date",
"items": {
"additionalProperties": false,
"properties": {
"date": {
"description": "Last passed check, YYYY-MM-DD",
"type": "string"
},
"label": {
"type": "string"
},
"method": {
"description": "How listing control was proven. airbnb_calendar: the operator's Airbnb calendar export link carries the listing id; date_challenge: Ospitario named a random date, and the operator blocked it in the platform's calendar export within 48 hours (not used for new proofs since 2026-11-07); platform_email: a platform email to the operator with a valid DKIM signature; channel_manager: the operator's channel manager lists the listing.",
"enum": [
"airbnb_calendar",
"date_challenge",
"platform_email",
"channel_manager"
],
"type": "string"
}
},
"required": [
"method",
"label",
"date"
],
"type": "object"
},
"type": "array"
},
"tier": {
"enum": [
"L2",
"L2c"
],
"type": "string"
}
},
"required": [
"domain",
"listingId",
"tier",
"label",
"date",
"proofs"
],
"type": "object"
},
"type": "array"
},
"registration": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"checkedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Day the number was last found in the official source (YYYY-MM-DD); a match of the code, never a check of the operator's identity"
},
"label": {
"type": "string"
},
"number": {
"description": "The registration number as the operator declared it (Italy: CIN); checked only as far as status says",
"type": "string"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The official source that confirmed the number, with its licence; null when none did"
},
"status": {
"description": "unchecked: the operator declared the country's short-term rental registration number (Italy: CIN), not yet checked against the public register; exists: the number is in the register; missing: the register no longer lists it.",
"enum": [
"unchecked",
"exists",
"missing"
],
"type": "string"
}
},
"required": [
"number",
"status",
"label",
"checkedAt",
"source"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Registration number status; null if the operator gave none"
},
"safety": {
"description": "Safety equipment the operator states is present. Insurance status and safety equipment are host-declared, not verified: Ospitario has seen no policy and no device. An item not listed is absent or not stated: see safetyStated.",
"items": {
"enum": [
"smokeDetector",
"gasDetector",
"coDetector",
"fireExtinguisher"
],
"type": "string"
},
"type": "array"
},
"safetyStated": {
"additionalProperties": false,
"description": "Each safety item: true present, false stated absent, null not stated. Insurance status and safety equipment are host-declared, not verified: Ospitario has seen no policy and no device.",
"properties": {
"coDetector": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"fireExtinguisher": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"gasDetector": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"smokeDetector": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"smokeDetector",
"gasDetector",
"coDetector",
"fireExtinguisher"
],
"type": "object"
},
"securityDeposit": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"description": "Per stay, as stated; 0: none",
"type": "number"
},
"currency": {
"const": "EUR",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Security deposit per stay as the operator states it; null: not stated"
},
"slug": {
"type": "string"
},
"smokingAllowed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether smoking is allowed inside, as the operator states it; null: not stated"
},
"stepFreeAccess": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether the home can be entered without steps, as the operator states it; null: not stated. Not an accessibility certification"
},
"summary": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"generated": {
"const": true,
"type": "boolean"
},
"text": {
"type": "string"
}
},
"required": [
"text",
"generated"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Two neutral sentences composed automatically from the facts of an unclaimed passport; not the operator's words"
},
"trust": {
"additionalProperties": false,
"description": "What Ospitario verified, by area: the managing account, authority over the property, platform listings",
"properties": {
"managedByHost": {
"description": "A host account with a confirmed email manages this passport; false for an unclaimed (L0) passport. A confirmed email proves nothing about the property",
"type": "boolean"
},
"propertyAuthority": {
"description": "Proofs that this operator may represent the property; empty when none. Independent of platform listings",
"items": {
"additionalProperties": false,
"properties": {
"date": {
"description": "YYYY-MM-DD",
"type": "string"
},
"method": {
"description": "operator_eid: eID identity matched to the registration holder (L3, Italy); document_review: documents checked by Ospitario's admin (LA)",
"enum": [
"operator_eid",
"document_review"
],
"type": "string"
}
},
"required": [
"method",
"date"
],
"type": "object"
},
"type": "array"
},
"verifiedListings": {
"description": "Platform listings with their own listing-control proof (see references); 0 is normal for a property without platforms",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"managedByHost",
"propertyAuthority",
"verifiedListings"
],
"type": "object"
},
"type": {
"description": "Accommodation type as stated by the operator",
"type": "string"
},
"unclaimed": {
"description": "true: an unclaimed passport (tier L0) built from the operator's official website; email and phone are not shown, write with send_inquiry",
"type": "boolean"
},
"unitCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Separately rentable homes this passport describes; 1: one home; more: ask the operator which unit the facts are for; null: not stated"
},
"verification": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"date": {
"description": "Date the tier was reached, YYYY-MM-DD",
"type": "string"
},
"label": {
"description": "Human-readable name of the tier",
"type": "string"
},
"tier": {
"description": "Verification tier (docs: ADR 0012, 0017, 0024, 0025). L0 unclaimed: facts read from the operator's official website, nothing proven, the operator has not claimed the page; contact only through send_inquiry. L2 listing verified: the operator proved control of the platform listing (calendar export link with the listing id, platform email with a valid DKIM signature, or channel manager); since 2026-11-07 also their right to manage the property (LA or L3), and earlier L2 stands as it was reached. L2c listing calendar proven (Booking, Vrbo): the operator blocked a random date Ospitario named in that platform's calendar export within 48 hours; no new L2c since 2026-11-07. LA right-to-manage documents reviewed: Ospitario's admin checked documents tying the operator to this property (registration record, deed, lease, mandate or company register); a person found them consistent, without eID, so it does not prove who holds the account and never proves a platform listing. L3 operator verified: the operator's eID identity (SPID/CIE) matches the CIN holder in the national register's PDF. L4 document verified (automated check): an ownership, lease or mandate document is consistent with that identity and the property; it states consistency, not authenticity. L5 manually verified: a reviewer checked the document (an optional upgrade; it does not affect search order).",
"enum": [
"L0",
"L2",
"L2c",
"LA",
"L3",
"L4",
"L5"
],
"type": "string"
}
},
"required": [
"tier",
"label",
"date"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Strongest current tier of the property and its listings"
}
},
"required": [
"slug",
"name",
"municipality",
"province",
"country",
"type",
"capacity",
"bedrooms",
"amenities",
"pool",
"placeKind",
"bathrooms",
"floorArea",
"petsAllowed",
"checkinFrom",
"checkoutUntil",
"location",
"minNights",
"beds",
"extraCosts",
"childrenAllowed",
"stepFreeAccess",
"unitCount",
"propertyKind",
"smokingAllowed",
"eventsAllowed",
"cleaningFee",
"securityDeposit",
"facilities",
"description",
"locationNotes",
"houseRules",
"cancellation",
"contact",
"verification",
"registration",
"references",
"availability",
"blocked",
"liabilityInsurance",
"priceFrom",
"unclaimed",
"summary",
"languages",
"safety",
"safetyStated",
"trust",
"provenance",
"booking"
],
"type": "object"
},
"reason": {
"description": "not_found: no operator holds a listing-control proof (L2/L2c) on this listing; unsupported_url: not a listing link Ospitario understands",
"enum": [
"not_found",
"unsupported_url"
],
"type": "string"
}
},
"required": [
"found"
],
"type": "object"
}
},
{
"description": "Find vacation rentals in a municipality or region (Italy, Germany, Spain, France, Portugal) for a number of guests. Where: municipality, province, (Italy) region, or a radius around an Italian municipality (near) or a point (latitude/longitude), each hit with its straight-line distance; the order stays tier, then name, sort by distance yourself. Criteria: capacity, bedrooms, bathrooms, amenities (a fixed table of names incl. pool facets such as private or heated, otherwise exact), what is rented, pets allowed, highest indicative price and, with from/to, dates not blocked in the operator's synced calendar. A stated fact that contradicts a criterion always leaves the property out. Each hit lists the criteria a stated fact meets in matched and says match (every criterion met) or possible, with the open points in unknown: by default only availability on request and a heated pool's heating on the requested dates; with include_possible also any fact the operator did not state (no current calendar is never read as free). Ask the operator about every point in unknown before relying on it. At most 20 results, ordered by the strongest free tier, then name (with include_possible matches first); the paid tier L5 does not change the order. No ranking by anything else, no fuzzy matching. Each result has priceFrom (indicative, negotiated directly, no booking) and the next window not blocked in the operator's calendar. Availability is a hint, never a booking commitment: a night not blocked in the operator's synced calendar may already be taken, since the calendar is a copy that can lag behind; only the operator confirms availability, and Ospitario holds or books nothing. Prices are indicative, stated by the host (on an unclaimed passport: taken from the official website), negotiated directly with the host; there is no booking through Ospitario. Every result is a property with a proven listing (L2/L2c), a verified operator (L3), a right to manage verified by document review (LA) or, marked L0 and unclaimed, facts from the operator's official website with nothing proven; the result names the tier and the date it was reached, and whether the registration number (Italy: CIN) was checked against the public register. Contact is direct with the operator and commission-free, so the traveler pays no platform fee. No result means nothing proven matches; nothing is inferred, estimated or filled in.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"amenities": {
"description": "Every listed amenity must be present. These names match the operator's wording in any of the six languages through a fixed table: pool, wifi, parking, airConditioning (ac), garden, seaView, terrace, kitchen, washingMachine (washerDryer), bbq (outdoorGrill), heating, fireplace, balcony, tv, hotTub, elevator, crib, microwave, workspace. A pool can be asked with its facets: \"private pool\", \"shared pool\", \"heated pool\", \"indoor pool\", \"outdoor pool\" (or the same words in Italian, German, Spanish, Portuguese, French); a facet the operator did not state is unknown, not a match. Any other word must match an amenity exactly (case-insensitive).",
"items": {
"maxLength": 60,
"minLength": 1,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"bathrooms": {
"description": "Minimum number of bathrooms; a half bath counts 0.5",
"maximum": 20,
"minimum": 0,
"multipleOf": 0.5,
"type": "number"
},
"bedrooms": {
"description": "Minimum number of bedrooms",
"maximum": 30,
"minimum": 0,
"type": "integer"
},
"children": {
"const": true,
"description": "true: only properties whose operator states that children are welcome",
"type": "boolean"
},
"country": {
"description": "ISO 3166-1 alpha-2 country code: IT, DE, ES, FR or PT",
"enum": [
"IT",
"DE",
"ES",
"FR",
"PT"
],
"type": "string"
},
"from": {
"description": "Check-in date YYYY-MM-DD; requires to",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"guests": {
"description": "Number of guests; properties with a lower capacity are left out. Optional since 1.14.0: without it, capacity is not a criterion",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"include_possible": {
"description": "true: also return possible matches, where a requested fact is not stated (capacity, bedrooms, an amenity or pool facet, pets, price, current calendar) and nothing stated contradicts the request; each hit names the open points in unknown. Default false: only hits that meet every criterion, plus availability on request.",
"type": "boolean"
},
"lang": {
"description": "Language of labels in the result; defaults to en",
"enum": [
"it",
"de",
"en",
"es",
"pt",
"fr"
],
"type": "string"
},
"latitude": {
"description": "Point to search around, WGS 84 degrees; with longitude and radiusKm, instead of near",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Point to search around, WGS 84 degrees; with latitude",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"maxPrice": {
"description": "Highest indicative price per night in EUR: properties whose lowest current or future priceFrom is above it, or that gave no price, are left out",
"maximum": 100000,
"minimum": 1,
"type": "integer"
},
"municipality": {
"description": "Exact municipality name, e.g. Lecce",
"maxLength": 80,
"minLength": 2,
"type": "string"
},
"near": {
"description": "Italian municipality to search around, by name (e.g. Lecce); with radiusKm. A name several municipalities carry needs nearProvince",
"maxLength": 80,
"minLength": 2,
"type": "string"
},
"nearProvince": {
"description": "Province code of near when the name is ambiguous (e.g. LE)",
"maxLength": 2,
"minLength": 2,
"type": "string"
},
"pets": {
"const": true,
"description": "true: only properties whose operator states that pets are allowed",
"type": "boolean"
},
"placeKind": {
"description": "entire, private_room or shared_room; properties that did not state it are left out",
"enum": [
"entire",
"private_room",
"shared_room"
],
"type": "string"
},
"propertyKind": {
"description": "Kind of building: apartment, house, villa, farmhouse, trullo, cottage, chalet, other; a property that did not state it is open (unknown: propertyKind), another kind leaves it out",
"enum": [
"apartment",
"house",
"villa",
"farmhouse",
"trullo",
"cottage",
"chalet",
"other"
],
"type": "string"
},
"province": {
"description": "Region code within the country, ISO 3166-2 without the prefix: IT/ES province (LE), FR département (75), DE Land (HH), PT distrito (11)",
"maxLength": 3,
"minLength": 1,
"type": "string"
},
"radiusKm": {
"description": "Radius around near or latitude/longitude in km, straight line, default 20. A passport counts at its published exact location, else at its municipality's centre (computed from Istat's boundaries), so a home just inside a municipality can lie a few km off; every hit names its distance and basis. Municipality centres computed by Ospitario from Istat, Confini delle unità amministrative a fini statistici al 1° gennaio 2026 (CC BY 4.0)",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"region": {
"description": "Italian region, by its Italian name or slug (Abruzzo, Basilicata, Calabria, Campania, Emilia-Romagna, Friuli-Venezia Giulia, Lazio, Liguria, Lombardia, Marche, Molise, Piemonte, Puglia, Sardegna, Sicilia, Toscana, Trentino-Alto Adige, Umbria, Valle d’Aosta, Veneto); the usual English, German, French, Spanish and Portuguese names are understood too (Apulia, Toskana). Italy only; matches the passport's province",
"maxLength": 40,
"minLength": 2,
"type": "string"
},
"stepFree": {
"const": true,
"description": "true: only properties whose operator states step-free access",
"type": "boolean"
},
"to": {
"description": "Checkout date YYYY-MM-DD; requires from",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
}
},
"type": "object"
},
"name": "search_properties",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"results": {
"items": {
"additionalProperties": false,
"properties": {
"amenities": {
"description": "Amenities in the operator's own words",
"items": {
"type": "string"
},
"type": "array"
},
"availability": {
"additionalProperties": false,
"properties": {
"lastSync": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Last successful calendar sync, ISO timestamp"
},
"status": {
"description": "calendar: blocked dates come from the operator's calendar, synced recently (lastSync); unblocked nights are not confirmed free; on_request: the operator answers availability on request, no dates are published; unknown: no current calendar, ask the operator. Availability is a hint, never a booking commitment: a night not blocked in the operator's synced calendar may already be taken, since the calendar is a copy that can lag behind; only the operator confirms availability, and Ospitario holds or books nothing.",
"enum": [
"calendar",
"on_request",
"unknown"
],
"type": "string"
}
},
"required": [
"status",
"lastSync"
],
"type": "object"
},
"bathrooms": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Bathrooms; a half bath counts 0.5. null: not stated."
},
"bedrooms": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"booking": {
"additionalProperties": false,
"description": "What a traveler can do with this passport: contact the operator, never book through Ospitario. Availability is separate (availability, blocked)",
"properties": {
"bookable": {
"const": false,
"description": "Always false: Ospitario takes no bookings and no payment. A result, a free night or a sent inquiry reserves nothing; the operator confirms dates and price",
"type": "boolean"
},
"contact": {
"description": "direct: the operator's own channels are in contact, and send_inquiry mails the operator; relay_only: unclaimed, write with send_inquiry (the official website in contact.site is the operator's own page, not an inquiry channel of Ospitario). send_inquiry may still refuse, with a reason",
"enum": [
"direct",
"relay_only"
],
"type": "string"
}
},
"required": [
"bookable",
"contact"
],
"type": "object"
},
"capacity": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Maximum number of guests"
},
"childrenAllowed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether children are welcome, as the operator states it; null: not stated"
},
"contactPageUrl": {
"description": "Page with the passport and the operator's direct contact; give this link to the traveler",
"type": "string"
},
"country": {
"description": "ISO 3166-1 alpha-2 country code",
"type": "string"
},
"distance": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"from": {
"description": "location: the exact location the operator published; municipality_centre: the centre of the passport's municipality (Istat boundaries), the home itself may lie a few km off",
"enum": [
"location",
"municipality_centre"
],
"type": "string"
},
"km": {
"description": "Straight-line distance in whole km; not a driving distance",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"km",
"from"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "From the requested point (near: that municipality's centre) to the passport; null without near or latitude/longitude"
},
"match": {
"description": "match: every criterion is met by a stated fact; possible: nothing stated contradicts the request, but the points in unknown are open. Properties that contradict a criterion are never returned",
"enum": [
"match",
"possible"
],
"type": "string"
},
"matched": {
"description": "Criteria of this request that a stated fact meets, named as in unknown: country, municipality, province, region, near (within radiusKm), guests, bedrooms, bathrooms, an amenity word as asked, \"pool open on the requested dates\", \"pool heating on the requested dates\", placeKind, pets, children, stepFree, minNights, price, availability (free in a current calendar). Computed from the passport's data, never generated",
"items": {
"type": "string"
},
"type": "array"
},
"minNights": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Minimum stay in nights as the operator states it; null: not stated, ask the operator"
},
"municipality": {
"type": "string"
},
"name": {
"type": "string"
},
"nextFreeWindow": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"from": {
"description": "First free night, YYYY-MM-DD",
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Checkout day when the next blocked night begins, YYYY-MM-DD; null: free to the end of the calendar horizon"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "First span not blocked in the operator's synced calendar from the requested check-in (or today) that is at least as long as the requested stay; null when the calendar is not current or on request. Not a booking commitment: ask the operator to confirm."
},
"petsAllowed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether pets are allowed, as the operator states it; null: not stated, ask the operator."
},
"placeKind": {
"anyOf": [
{
"enum": [
"entire",
"private_room",
"shared_room"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "What the guest rents: the entire place, a private room or a shared room. Declared by the operator; null: not stated."
},
"pool": {
"additionalProperties": false,
"description": "The pool, facet by facet; null: not stated. Never inferred.",
"properties": {
"access": {
"anyOf": [
{
"enum": [
"private",
"shared"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "null: not stated, or the lines disagree"
},
"heated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "true: a heated or heatable pool. It does not say the pool is heated on given dates: see heatedSeason and heating. null: not stated"
},
"heatedSeason": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Days the pool is heated every year, MM-DD to MM-DD; null: not declared, or several periods (see heatedSeasons)"
},
"heatedSeasons": {
"description": "Every period the pool is heated each year; empty: not declared",
"items": {
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
"type": "array"
},
"heating": {
"anyOf": [
{
"enum": [
"none",
"included",
"surcharge",
"on_request"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "As the operator declares it: no heating, heating included, heating for a surcharge, heating on request (notice in notes); null: not declared"
},
"notes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Conditions in the operator's words: surcharge, notice for heating, hours, age rules"
},
"present": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "true: the operator declares a pool, or a line names a pool of the house; false: declared or stated absent; null: not stated"
},
"season": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Days the pool is open every year, MM-DD to MM-DD inclusive (may run across New Year); null when several periods are declared (see seasons); null: not declared, ask the operator"
},
"seasons": {
"description": "Every period the pool is open each year, as the operator declares them; empty: not declared, ask the operator",
"items": {
"additionalProperties": false,
"properties": {
"from": {
"description": "MM-DD",
"type": "string"
},
"until": {
"description": "MM-DD, inclusive",
"type": "string"
}
},
"required": [
"from",
"until"
],
"type": "object"
},
"type": "array"
},
"setting": {
"anyOf": [
{
"enum": [
"indoor",
"outdoor"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "null: not stated"
},
"source": {
"anyOf": [
{
"enum": [
"operator",
"amenity_text"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "operator: declared in the passport's pool fields; amenity_text: read from the amenity lines by fixed patterns in six languages, a line that places the pool elsewhere (public, nearby) does not count; null: nothing about a pool"
}
},
"required": [
"present",
"access",
"setting",
"heated",
"heating",
"season",
"heatedSeason",
"seasons",
"heatedSeasons",
"notes",
"source"
],
"type": "object"
},
"priceFrom": {
"anyOf": [
{
"additionalProperties": false,
"description": "Indicative price per night. Prices are indicative, stated by the host (on an unclaimed passport: taken from the official website), negotiated directly with the host; there is no booking through Ospitario. null: the operator gave no price.",
"properties": {
"currency": {
"enum": [
"EUR"
],
"type": "string"
},
"label": {
"description": "e.g. \"da 120 €/notte\"",
"type": "string"
},
"nightlyFrom": {
"description": "Lowest nightly price among the current and future periods",
"type": "number"
},
"seasons": {
"description": "Current and future periods; ended ones are left out",
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"enum": [
"EUR"
],
"type": "string"
},
"label": {
"type": "string"
},
"nightlyFrom": {
"description": "Lowest nightly price the operator states for this period",
"type": "number"
},
"seasonLabel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Season name in the operator's words"
},
"validFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "First day of the period, YYYY-MM-DD; null: no start given"
},
"validTo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Last day of the period, YYYY-MM-DD; null: no end given"
}
},
"required": [
"nightlyFrom",
"currency",
"seasonLabel",
"validFrom",
"validTo",
"label"
],
"type": "object"
},
"type": "array"
},
"updatedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When the operator last changed the prices, YYYY-MM-DD"
}
},
"required": [
"nightlyFrom",
"currency",
"label",
"seasons",
"updatedAt"
],
"type": "object"
},
{
"type": "null"
}
]
},
"province": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Region code, ISO 3166-2 without the country prefix: IT/ES province (LE, GR), FR département (75), DE Land (HH), PT distrito (11)"
},
"slug": {
"type": "string"
},
"stepFreeAccess": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether the home can be entered without steps, as the operator states it; null: not stated. Not an accessibility certification"
},
"type": {
"description": "Accommodation type as stated by the operator",
"type": "string"
},
"unclaimed": {
"description": "true: an unclaimed passport (tier L0) built from the operator's official website; email and phone are not shown, write with send_inquiry",
"type": "boolean"
},
"unknown": {
"description": "Criteria no stated fact settles, e.g. guests, bedrooms, availability, pets, price, an amenity word, \"pool heating on the requested dates\"; ask the operator about these before relying on them",
"items": {
"type": "string"
},
"type": "array"
},
"verification": {
"additionalProperties": false,
"properties": {
"date": {
"description": "Date the tier was reached, YYYY-MM-DD",
"type": "string"
},
"label": {
"description": "Human-readable name of the tier",
"type": "string"
},
"tier": {
"description": "Verification tier (docs: ADR 0012, 0017, 0024, 0025). L0 unclaimed: facts read from the operator's official website, nothing proven, the operator has not claimed the page; contact only through send_inquiry. L2 listing verified: the operator proved control of the platform listing (calendar export link with the listing id, platform email with a valid DKIM signature, or channel manager); since 2026-11-07 also their right to manage the property (LA or L3), and earlier L2 stands as it was reached. L2c listing calendar proven (Booking, Vrbo): the operator blocked a random date Ospitario named in that platform's calendar export within 48 hours; no new L2c since 2026-11-07. LA right-to-manage documents reviewed: Ospitario's admin checked documents tying the operator to this property (registration record, deed, lease, mandate or company register); a person found them consistent, without eID, so it does not prove who holds the account and never proves a platform listing. L3 operator verified: the operator's eID identity (SPID/CIE) matches the CIN holder in the national register's PDF. L4 document verified (automated check): an ownership, lease or mandate document is consistent with that identity and the property; it states consistency, not authenticity. L5 manually verified: a reviewer checked the document (an optional upgrade; it does not affect search order).",
"enum": [
"L0",
"L2",
"L2c",
"LA",
"L3",
"L4",
"L5"
],
"type": "string"
}
},
"required": [
"tier",
"label",
"date"
],
"type": "object"
}
},
"required": [
"slug",
"name",
"municipality",
"province",
"type",
"capacity",
"bedrooms",
"amenities",
"placeKind",
"petsAllowed",
"availability",
"priceFrom",
"unclaimed",
"country",
"pool",
"minNights",
"childrenAllowed",
"stepFreeAccess",
"bathrooms",
"booking",
"match",
"matched",
"unknown",
"verification",
"distance",
"nextFreeWindow",
"contactPageUrl"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"results"
],
"type": "object"
}
},
{
"description": "Send one inquiry from a traveler to the operator of a passport, by email through Ospitario (no booking, no payment, no commission). Two steps, and only with the traveler's consent: first call without code; Ospitario mails a six-digit code and a confirmation link to guest_email. Ask the traveler for the code, then call again with challengeId and code; if the traveler confirmed with the link instead, the inquiry is already sent and that call answers refused with reason used. The operator replies to the traveler's address directly. For an unclaimed passport (L0) this is the only way to write. Limits: 3 per traveler email and day, 10 per operator and day, identical messages once. When sent, the answer carries a reference that the operator's mail names too; give it to the traveler.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"challengeId": {
"description": "From step 1; send it with code in step 2",
"maxLength": 40,
"minLength": 10,
"type": "string"
},
"code": {
"description": "The six-digit code the traveler received by email, for step 2",
"pattern": "^\\d{6}$",
"type": "string"
},
"from": {
"description": "Check-in date YYYY-MM-DD; requires to",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"guest_email": {
"description": "The traveler's email address; the operator replies there",
"format": "email",
"maxLength": 200,
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"guests": {
"description": "Number of guests",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"lang": {
"description": "Language of labels in the result; defaults to en",
"enum": [
"it",
"de",
"en",
"es",
"pt",
"fr"
],
"type": "string"
},
"message": {
"description": "The traveler's message to the operator, in the traveler's words",
"maxLength": 2000,
"minLength": 10,
"type": "string"
},
"slug": {
"description": "Passport slug from a search or lookup result",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$",
"type": "string"
},
"to": {
"description": "Checkout date YYYY-MM-DD; requires from",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
}
},
"required": [
"slug",
"guests",
"message",
"guest_email"
],
"type": "object"
},
"name": "send_inquiry",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"challengeId": {
"type": "string"
},
"reason": {
"description": "Why nothing was sent: limits (3 per traveler and day, 10 per operator and day), the operator opted out, a repeated identical message, a wrong or expired code, used: already sent through the mail's confirmation link, delivery_failed: the mail server refused the mail (step 1: no code went out; step 2: the inquiry is recorded under reference but did not go out, the traveler may send it again), rate_limited: too many calls, try again in a minute",
"enum": [
"not_found",
"opted_out",
"guest_daily",
"recipient_daily",
"global_daily",
"duplicate",
"codes_daily",
"no_recipient",
"expired",
"used",
"too_many",
"wrong",
"invalid",
"delivery_failed",
"rate_limited"
],
"type": "string"
},
"reference": {
"description": "With sent, or refused for delivery_failed: the inquiry's reference, also named in the operator's mail; quote it to the traveler and in any follow-up. Opaque, carries no personal data.",
"type": "string"
},
"status": {
"description": "code_sent: the code was handed to the mail server for guest_email; ask the traveler for it, then call again with challengeId and code (the traveler may confirm with the mail's link instead). sent: the inquiry was handed to the mail server for the operator, Reply-To the traveler; it is not a sign the operator read or answered it, and answers go to guest_email, not to Ospitario. Calling step 2 again with the same challengeId and code returns the same reference. refused: see reason",
"enum": [
"code_sent",
"sent",
"refused"
],
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:5e377c616df59978625e70e8d489e5b71ffefc1f4768320461a7a34957350e77 | sha256sum