Guests

List guests

GET

/v1/guests

Returns guests registered across bookings, optionally filtered by property or free-text query.

List guests › query Parameters

property_id

string

Restrict results to guests of this property

query

string

Free-text search across guest name, document, etc.

page

string

Zero-based page index (default 0)

size

string

Page size (max 100)

List guests › Responses

Paginated guests with hydrated booking/property context

GuestsResponse

Guest[] · required

page

integer | null

size

integer | null

total

integer | null

GET/v1/guests

curl /v1/guests \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "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"
    }
  ],
  "page": 0,
  "size": 0,
  "total": 0
}

json

application/json

Delete guest (owner-side)

DELETE

/v1/guests/{id}

Authenticated, Owner/Manager only. Permanently removes the guest. Blocked once the booking has been submitted to SES Hospedajes, since that data must be retained for legal compliance.

Delete guest (owner-side) › path Parameters

id

string · required

Guest id

Delete guest (owner-side) › Responses

The guest was deleted

No data returned

Update guest (owner-side)

PATCH

/v1/guests/{id}

Authenticated, Owner/Manager only. Replaces all editable fields with the values in the request.

Update guest (owner-side) › path Parameters

id

string · required

Guest id

Update guest (owner-side) › 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

relationship_code

string | null

Update guest (owner-side) › Responses

The updated guest

Guest

id

string · uuid · required

booking_id

string · uuid · required

property_id

string · uuid · required

first_name

string · required

last_name

string · required

second_last_name

string | null

date_of_birth

string | null

sex

string | null

residence_city_name

string | null

residence_address

string | null

residence_postal_code

string | null

document_type

string | null

document_number

string | null

document_support_number

string | null

email

string | null

phone

string | null

phone_prefix

string | null

relationship_code

string | null

PATCH/v1/guests/{id}

curl /v1/guests/:id \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --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",
  "relationship_code": "relationship_code"
}'

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",
  "relationship_code": "relationship_code"
}

json

Example Responses

{
  "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"
}

json

application/json

Register guest on a booking (owner-side)

POST

/v1/bookings/{id}/guests

Authenticated, Owner/Manager only. Same SES Hospedajes validation as the public flow.

Register guest on a booking (owner-side) › path Parameters

id

string · required

Booking id

Register guest on a booking (owner-side) › 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

relationship_code

string | null

Register guest on a booking (owner-side) › Responses

The created guest

Guest

id

string · uuid · required

booking_id

string · uuid · required

property_id

string · uuid · required

first_name

string · required

last_name

string · required

second_last_name

string | null

date_of_birth

string | null

sex

string | null

residence_city_name

string | null

residence_address

string | null

residence_postal_code

string | null

document_type

string | null

document_number

string | null

document_support_number

string | null

email

string | null

phone

string | null

phone_prefix

string | null

relationship_code

string | null

POST/v1/bookings/{id}/guests

curl /v1/bookings/:id/guests \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --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",
  "relationship_code": "relationship_code"
}'

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",
  "relationship_code": "relationship_code"
}

json

Example Responses

{
  "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"
}

json

application/json

Geo Integrations

List guests

GET

/v1/guests

Returns guests registered across bookings, optionally filtered by property or free-text query.

List guests › query Parameters

property_id

string

Restrict results to guests of this property

query

string

Free-text search across guest name, document, etc.

page

string

Zero-based page index (default 0)

size

string

Page size (max 100)

List guests › Responses

Paginated guests with hydrated booking/property context

GuestsResponse

Guest[] · required

page

integer | null

size

integer | null

total

integer | null

Delete guest (owner-side)

DELETE

/v1/guests/{id}

Authenticated, Owner/Manager only. Permanently removes the guest. Blocked once the booking has been submitted to SES Hospedajes, since that data must be retained for legal compliance.

Delete guest (owner-side) › path Parameters

id

string · required

Guest id

Delete guest (owner-side) › Responses

The guest was deleted

No data returned

Update guest (owner-side)

PATCH

/v1/guests/{id}

Authenticated, Owner/Manager only. Replaces all editable fields with the values in the request.

Update guest (owner-side) › path Parameters

id

string · required

Guest id

Update guest (owner-side) › 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

relationship_code

string | null

Update guest (owner-side) › Responses

The updated guest

Guest

id

string · uuid · required

booking_id

string · uuid · required

property_id

string · uuid · required

first_name

string · required

last_name

string · required

second_last_name

string | null

date_of_birth

string | null

sex

string | null

residence_city_name

string | null

residence_address

string | null

residence_postal_code

string | null

document_type

string | null

document_number

string | null

document_support_number

string | null

email

string | null

phone

string | null

phone_prefix

string | null

relationship_code

string | null

POST

/v1/bookings/{id}/guests

Authenticated, Owner/Manager only. Same SES Hospedajes validation as the public flow.

Register guest on a booking (owner-side) › path Parameters

id

string · required

Booking id

Register guest on a booking (owner-side) › 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

relationship_code

string | null

Register guest on a booking (owner-side) › Responses

The created guest

Guest

id

string · uuid · required

booking_id

string · uuid · required

property_id

string · uuid · required

first_name

string · required

last_name

string · required

second_last_name

string | null

date_of_birth

string | null

sex

string | null

residence_city_name

string | null

residence_address

string | null

residence_postal_code

string | null

document_type

string | null

document_number

string | null

document_support_number

string | null

email

string | null

phone

string | null

phone_prefix

string | null

relationship_code

string | null