Guests

List guests registered under the caller's account

GET

/guests

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

List guests registered under the caller's account › 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 registered under the caller's account › Responses

Paginated guests with hydrated booking/property context

GuestsResponse

Guest[] · required

page

integer | null

size

integer | null

total

integer | null

GET/guests

curl --request GET \
  --url /guests

shell

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

Geo Integrations

Kasify API

Guests

List guests registered under the caller's account

GET

/guests

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

List guests registered under the caller's account › 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 registered under the caller's account › Responses

Paginated guests with hydrated booking/property context

GuestsResponse

Guest[] · required

page

integer | null

size

integer | null

total

integer | null

GET/guests

curl --request GET \
  --url /guests

shell

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

Geo Integrations