Partelisto

Creates a new booking (a check-in workflow) for one of the host's properties. Requires the write permission granted separately during sign-in. Ask the host to confirm the property and dates before calling this. Does not email the guest — call send_guest_checkin_link afterwards if a link should go out now.

{
  "type": "object",
  "properties": {
    "propertyId": {
      "description": "The property id, from list_properties.",
      "type": "string"
    },
    "checkIn": {
      "description": "Check-in date, yyyy-MM-dd.",
      "type": "string"
    },
    "checkOut": {
      "description": "Check-out date, yyyy-MM-dd.",
      "type": "string"
    },
    "templateId": {
      "description": "Check-in template id. Omit if the property has exactly one active (non-archived) template — it is picked automatically; otherwise this is required.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "guestName": {
      "description": "Guest name, optional.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "guestEmail": {
      "description": "Guest email, optional.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "guestPhone": {
      "description": "Guest phone, optional.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "propertyId",
    "checkIn",
    "checkOut"
  ]
}

Sends (or resends) the guest check-in link by email for a booking the host owns. This is a real action with a side effect: it emails the guest and, on resend, invalidates the guest's previous link. Requires the write permission granted separately during sign-in. Ask the host to confirm before calling this.

{
  "type": "object",
  "properties": {
    "bookingId": {
      "description": "The booking id.",
      "type": "string"
    },
    "email": {
      "description": "Guest email to send to. Omit to use the email already on the booking.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "guestName": {
      "description": "Guest name, for the email greeting. Omit to keep the name already on the booking.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "bookingId"
  ]
}

SES.HOSPEDAJES (police registration) submission status for a set of bookings the host owns: status, attempts, last error, and the official reference once accepted. Bookings with no submission yet are omitted.

{
  "type": "object",
  "properties": {
    "bookingIds": {
      "description": "Booking ids to check, up to 50.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "bookingIds"
  ]
}

Whether the guest has completed the check-in form for a booking the host owns (None or Submitted). No form content.

{
  "type": "object",
  "properties": {
    "bookingId": {
      "description": "The booking id.",
      "type": "string"
    }
  },
  "required": [
    "bookingId"
  ]
}

Lists the signed-in host's bookings (newest first), paged. Returns id, property id, check-in/check-out dates, status, and whether a check-in link and guest contact exist — never the guest's email, phone, or documents.

{
  "type": "object",
  "properties": {
    "skip": {
      "description": "Rows to skip, for paging. Defaults to 0.",
      "type": "integer",
      "default": 0
    },
    "take": {
      "description": "Rows to return, max 50. Defaults to 20.",
      "type": "integer",
      "default": 20
    }
  }
}

Scans the signed-in host's most recent bookings (up to 50) and returns only what needs action right now: stays that are imminent or under way where the guest has not completed check-in, and bookings whose SES.HOSPEDAJES submission failed. Empty list means nothing needs attention within the window. No guest PII.

{
  "type": "object",
  "properties": {
    "arrivalWindowDays": {
      "description": "How many days ahead counts as \"imminent\" (a negative gap means the stay already started). Defaults to 3.",
      "type": "integer",
      "default": 3
    }
  }
}

Lists the signed-in host's properties: id, name, address, municipality/province, and whether it is archived. No guest data.

{
  "type": "object",
  "properties": {
    "includeArchived": {
      "description": "Include archived properties. Defaults to false.",
      "type": "boolean",
      "default": false
    }
  }
}

The signed-in host's plan tier, trial status, and this month's usage against plan limits (properties, templates, bookings).

{
  "type": "object",
  "properties": {}
}