Checkin

Get the guest check-in snapshot for a booking

GET

/checkin/{code}

Public endpoint. Returns the booking, property, and already-registered guests for the given booking code so the guest-facing check-in form can render.

Get the guest check-in snapshot for a booking › path Parameters

code

string · required

Booking channel code (the public identifier given to the guest)

Get the guest check-in snapshot for a booking › Responses

Check-in snapshot

CheckinResponse

PropertyInfo · required

from

string · required

to

string · required

guests_number

integer · required

booking_code

string · required

Guest[] · required

checkin_completed

boolean · required

checkin_closed

boolean · required

GET/checkin/{code}

curl --request GET \
  --url /checkin/:code

shell

Example Responses

{
  "property": {
    "name": "name",
    "address": "address",
    "city": "city",
    "zip_code": "zip_code",
    "cover_image_url": "cover_image_url"
  },
  "from": "from",
  "to": "to",
  "guests_number": 0,
  "booking_code": "booking_code",
  "guests": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "booking_id": "00000000-0000-0000-0000-000000000000",
      "property_id": "00000000-0000-0000-0000-000000000000",
      "first_name": "first_name",
      "last_name": "last_name",
      "second_last_name": "second_last_name",
      "nationality": {
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "name",
        "name_es": "name_es",
        "alpha_2": "alpha_2",
        "alpha_3": "alpha_3"
      },
      "date_of_birth": "date_of_birth",
      "sex": "sex",
      "residence_country": {
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "name",
        "name_es": "name_es",
        "alpha_2": "alpha_2",
        "alpha_3": "alpha_3"
      },
      "residence_province": {
        "id": "00000000-0000-0000-0000-000000000000",
        "country_id": "00000000-0000-0000-0000-000000000000",
        "name": "name",
        "code_iso_3166_2": "code_iso_3166_2",
        "ine_code_pro": "ine_code_pro"
      },
      "residence_city": {
        "id": "00000000-0000-0000-0000-000000000000",
        "country_id": "00000000-0000-0000-0000-000000000000",
        "province_id": "00000000-0000-0000-0000-000000000000",
        "name": "name",
        "ine_code": "ine_code",
        "ine_code_mun": "ine_code_mun"
      },
      "residence_city_name": "residence_city_name",
      "residence_address": "residence_address",
      "residence_postal_code": "residence_postal_code",
      "document_type": "document_type",
      "document_number": "document_number",
      "document_support_number": "document_support_number",
      "email": "email",
      "phone": "phone",
      "phone_prefix": "phone_prefix",
      "relationship_code": "relationship_code"
    }
  ],
  "checkin_completed": true,
  "checkin_closed": true
}

json

application/json

Register a guest on a booking

POST

/checkin/{code}/guests

Public endpoint. Persists one guest against the booking and returns the updated snapshot. SES Hospedajes validation rules are enforced by GuestRegistrationRequest.validate().

Register a guest on a booking › path Parameters

code

string · required

Booking channel code

Register a guest on a booking › Request Body

GuestRegistrationRequest

first_name

string · required

last_name

string · required

nationality_country_code

string · required

date_of_birth

string · required

sex

string · required

second_last_name

string | null

document_type

string | null

document_number

string | null

document_support_number

string | null

residence_address

string | null

residence_country_code

string | null

residence_province_id

string | null · uuid

residence_city_id

string | null · uuid

residence_city

string | null

residence_postal_code

string | null

phone_prefix

string | null

phone

string | null

email

string | null

Register a guest on a booking › Responses

Updated check-in snapshot including the new guest

CheckinResponse

PropertyInfo · required

from

string · required

to

string · required

guests_number

integer · required

booking_code

string · required

Guest[] · required

checkin_completed

boolean · required

checkin_closed

boolean · required

POST/checkin/{code}/guests

curl --request POST \
  --url /checkin/:code/guests \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "first_name",
  "last_name": "last_name",
  "second_last_name": "second_last_name",
  "nationality_country_code": "nationality_country_code",
  "date_of_birth": "date_of_birth",
  "sex": "sex",
  "document_type": "document_type",
  "document_number": "document_number",
  "document_support_number": "document_support_number",
  "residence_address": "residence_address",
  "residence_country_code": "residence_country_code",
  "residence_province_id": "00000000-0000-0000-0000-000000000000",
  "residence_city_id": "00000000-0000-0000-0000-000000000000",
  "residence_city": "residence_city",
  "residence_postal_code": "residence_postal_code",
  "phone_prefix": "phone_prefix",
  "phone": "phone",
  "email": "email"
}
'

shell

Example Request Body

{
  "first_name": "first_name",
  "last_name": "last_name",
  "second_last_name": "second_last_name",
  "nationality_country_code": "nationality_country_code",
  "date_of_birth": "date_of_birth",
  "sex": "sex",
  "document_type": "document_type",
  "document_number": "document_number",
  "document_support_number": "document_support_number",
  "residence_address": "residence_address",
  "residence_country_code": "residence_country_code",
  "residence_province_id": "00000000-0000-0000-0000-000000000000",
  "residence_city_id": "00000000-0000-0000-0000-000000000000",
  "residence_city": "residence_city",
  "residence_postal_code": "residence_postal_code",
  "phone_prefix": "phone_prefix",
  "phone": "phone",
  "email": "email"
}

json

Example Responses

{
  "property": {
    "name": "name",
    "address": "address",
    "city": "city",
    "zip_code": "zip_code",
    "cover_image_url": "cover_image_url"
  },
  "from": "from",
  "to": "to",
  "guests_number": 0,
  "booking_code": "booking_code",
  "guests": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "booking_id": "00000000-0000-0000-0000-000000000000",
      "property_id": "00000000-0000-0000-0000-000000000000",
      "first_name": "first_name",
      "last_name": "last_name",
      "second_last_name": "second_last_name",
      "nationality": {
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "name",
        "name_es": "name_es",
        "alpha_2": "alpha_2",
        "alpha_3": "alpha_3"
      },
      "date_of_birth": "date_of_birth",
      "sex": "sex",
      "residence_country": {
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "name",
        "name_es": "name_es",
        "alpha_2": "alpha_2",
        "alpha_3": "alpha_3"
      },
      "residence_province": {
        "id": "00000000-0000-0000-0000-000000000000",
        "country_id": "00000000-0000-0000-0000-000000000000",
        "name": "name",
        "code_iso_3166_2": "code_iso_3166_2",
        "ine_code_pro": "ine_code_pro"
      },
      "residence_city": {
        "id": "00000000-0000-0000-0000-000000000000",
        "country_id": "00000000-0000-0000-0000-000000000000",
        "province_id": "00000000-0000-0000-0000-000000000000",
        "name": "name",
        "ine_code": "ine_code",
        "ine_code_mun": "ine_code_mun"
      },
      "residence_city_name": "residence_city_name",
      "residence_address": "residence_address",
      "residence_postal_code": "residence_postal_code",
      "document_type": "document_type",
      "document_number": "document_number",
      "document_support_number": "document_support_number",
      "email": "email",
      "phone": "phone",
      "phone_prefix": "phone_prefix",
      "relationship_code": "relationship_code"
    }
  ],
  "checkin_completed": true,
  "checkin_closed": true
}

json

application/json

Calendar Geo

Get the guest check-in snapshot for a booking

GET

/checkin/{code}

Public endpoint. Returns the booking, property, and already-registered guests for the given booking code so the guest-facing check-in form can render.

Get the guest check-in snapshot for a booking › path Parameters

code

string · required

Booking channel code (the public identifier given to the guest)

Get the guest check-in snapshot for a booking › Responses

Check-in snapshot

CheckinResponse

PropertyInfo · required

from

string · required

to

string · required

guests_number

integer · required

booking_code

string · required

Guest[] · required

checkin_completed

boolean · required

checkin_closed

boolean · required

POST

/checkin/{code}/guests

Public endpoint. Persists one guest against the booking and returns the updated snapshot. SES Hospedajes validation rules are enforced by GuestRegistrationRequest.validate().

Register a guest on a booking › path Parameters

code

string · required

Booking channel code

Register a guest on a booking › Request Body

GuestRegistrationRequest

first_name

string · required

last_name

string · required

nationality_country_code

string · required

date_of_birth

string · required

sex

string · required

second_last_name

string | null

document_type

string | null

document_number

string | null

document_support_number

string | null

residence_address

string | null

residence_country_code

string | null

residence_province_id

string | null · uuid

residence_city_id

string | null · uuid

residence_city

string | null

residence_postal_code

string | null

phone_prefix

string | null

phone

string | null

email

string | null

Register a guest on a booking › Responses

Updated check-in snapshot including the new guest

CheckinResponse

PropertyInfo · required

from

string · required

to

string · required

guests_number

integer · required

booking_code

string · required

Guest[] · required

checkin_completed

boolean · required

checkin_closed

boolean · required