Admin

Platform overview metrics for the admin dashboard (admin)

GET

/v1/admin/overview

Returns platform-wide counts (properties, users, bookings, guests), SES Hospedajes submission health, and integration/booking-code totals. Admin only.

Platform overview metrics for the admin dashboard (admin) › Responses

Platform overview snapshot

AdminOverviewResponse

generated_at

string · required

CountWithMonthlyDelta · required

SesOverview · required

IntegrationsOverview · required

List all users across accounts (admin)

GET

/v1/admin/users

List all users across accounts (admin) › query Parameters

page

string

Zero-based page index (default 0)

size

string

Page size (max 100)

query

string

Free-text across user name, last name and email

List all users across accounts (admin) › Responses

Paginated users

AdminUsersPageResponse

User[] · required

page

integer | null

size

integer | null

total

integer | null

List all properties with their owner (admin)

GET

/v1/admin/properties

List all properties with their owner (admin) › query Parameters

page

string

Zero-based page index (default 0)

size

string

Page size (max 100)

query

string

Free-text across property name/city and owner name/email

List all properties with their owner (admin) › Responses

Paginated properties with the user that created each

AdminPropertiesPageResponse

AdminProperty[] · required

page

integer | null

size

integer | null

total

integer | null

GET/v1/admin/properties

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

Example Responses

{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "account_id": "00000000-0000-0000-0000-000000000000",
      "name": "name",
      "address": "address",
      "city": "city",
      "zip_code": "zip_code",
      "rooms_count": 0,
      "has_internet": true,
      "ses_establishment_code": "ses_establishment_code",
      "cover_image_url": "cover_image_url",
      "created_at": "created_at",
      "owner": {
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "name",
        "last_name": "last_name",
        "email": "email"
      }
    }
  ],
  "page": 0,
  "size": 0,
  "total": 0
}

json

application/json

List all bookings across accounts (admin)

GET

/v1/admin/bookings

List all bookings across accounts (admin) › query Parameters

page

string

Zero-based page index (default 0)

size

string

Page size (max 100)

from

string

Filter by stay overlap range start (YYYY-MM-DD)

to

string

Filter by stay overlap range end (YYYY-MM-DD)

property_id

string

Restrict to a single property

query

string

Free-text across guest name, channel_id, ses_lote

channel

string

Filter by booking channel (Airbnb, Booking, Vrbo, Google, Direct)

List all bookings across accounts (admin) › Responses

Paginated bookings

AdminBookingsPageResponse

Booking[] · required

page

integer | null

size

integer | null

total

integer | null

GET/v1/admin/bookings

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

Example Responses

{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "property": {
        "id": "00000000-0000-0000-0000-000000000000",
        "account_id": "00000000-0000-0000-0000-000000000000",
        "name": "name",
        "address": "address",
        "city": "city",
        "zip_code": "zip_code",
        "country": "country",
        "country_id": "00000000-0000-0000-0000-000000000000",
        "country_code": "country_code",
        "province_id": "00000000-0000-0000-0000-000000000000",
        "city_id": "00000000-0000-0000-0000-000000000000",
        "checkin_time": "checkin_time",
        "checkout_time": "checkout_time",
        "ses_establishment_code": "ses_establishment_code",
        "ses_establishment_type": "ses_establishment_type",
        "has_internet": true,
        "rooms_count": 0,
        "default_cleaner": {
          "id": "00000000-0000-0000-0000-000000000000",
          "name": "name",
          "last_name": "last_name",
          "email": "email",
          "access_level": "access_level",
          "service": "service"
        },
        "cover_image_url": "cover_image_url",
        "role": "role",
        "calendars": [
          {
            "channel": "channel",
            "url": "url",
            "syncIntervalMinutes": 0,
            "lastSyncAt": "2024-08-25",
            "lastError": "lastError"
          }
        ],
        "smart_locks": [
          {
            "id": "00000000-0000-0000-0000-000000000000",
            "vendor": "vendor",
            "name": "name"
          }
        ],
        "team": [
          {
            "id": "00000000-0000-0000-0000-000000000000",
            "name": "name",
            "last_name": "last_name",
            "email": "email",
            "access_level": "access_level",
            "service": "service"
          }
        ]
      },
      "from": "from",
      "to": "to",
      "channel": "channel",
      "channel_id": "channel_id",
      "checkin_code": "checkin_code",
      "status": "status",
      "payment_type": "payment_type",
      "notes": "notes",
      "guest_first_name": "guest_first_name",
      "guest_last_name": "guest_last_name",
      "guest_email": "guest_email",
      "guest_phone": "guest_phone",
      "adults_count": 0,
      "children_count": 0,
      "infants_count": 0,
      "special_requests": "special_requests",
      "arrival_time": "arrival_time",
      "departure_time": "departure_time",
      "checkin_time": "checkin_time",
      "checkout_time": "checkout_time",
      "created_at": "created_at",
      "checkin_completed_at": "checkin_completed_at",
      "last_sync_at": "last_sync_at",
      "ses_communications": [
        {
          "id": "00000000-0000-0000-0000-000000000000",
          "type": "type",
          "operation": "operation",
          "status": "status",
          "lote": "lote",
          "codigo_comunicacion": "codigo_comunicacion",
          "estado": "estado",
          "estado_desc": "estado_desc",
          "submitted_at": "submitted_at",
          "last_attempt_at": "last_attempt_at",
          "last_error": "last_error"
        }
      ],
      "access_codes": [
        {
          "id": "00000000-0000-0000-0000-000000000000",
          "access_code": "access_code",
          "smartlock_id": "00000000-0000-0000-0000-000000000000",
          "smartlock_name": "smartlock_name"
        }
      ],
      "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"
        }
      ],
      "cleaning_task": {
        "id": "00000000-0000-0000-0000-000000000000",
        "property": {
          "id": "00000000-0000-0000-0000-000000000000",
          "account_id": "00000000-0000-0000-0000-000000000000",
          "name": "name",
          "address": "address",
          "city": "city",
          "zip_code": "zip_code",
          "country": "country",
          "country_id": "00000000-0000-0000-0000-000000000000",
          "country_code": "country_code",
          "province_id": "00000000-0000-0000-0000-000000000000",
          "city_id": "00000000-0000-0000-0000-000000000000",
          "checkin_time": "checkin_time",
          "checkout_time": "checkout_time",
          "ses_establishment_code": "ses_establishment_code",
          "ses_establishment_type": "ses_establishment_type",
          "has_internet": true,
          "rooms_count": 0,
          "default_cleaner": {
            "id": "00000000-0000-0000-0000-000000000000",
            "name": "name",
            "last_name": "last_name",
            "email": "email",
            "access_level": "access_level",
            "service": "service"
          },
          "cover_image_url": "cover_image_url",
          "role": "role",
          "calendars": [
            {
              "channel": "channel",
              "url": "url",
              "syncIntervalMinutes": 0,
              "lastSyncAt": "2024-08-25",
              "lastError": "lastError"
            }
          ],
          "smart_locks": [
            {
              "id": "00000000-0000-0000-0000-000000000000",
              "vendor": "vendor",
              "name": "name"
            }
          ],
          "team": [
            {
              "id": "00000000-0000-0000-0000-000000000000",
              "name": "name",
              "last_name": "last_name",
              "email": "email",
              "access_level": "access_level",
              "service": "service"
            }
          ]
        },
        "booking_id": "00000000-0000-0000-0000-000000000000",
        "task_type": "task_type",
        "status": "pending",
        "assigned_to": "00000000-0000-0000-0000-000000000000",
        "assigned_to_name": "assigned_to_name",
        "notes": "notes",
        "job_report": "job_report",
        "from": "from",
        "to": "to",
        "created_at": "created_at",
        "started_at": "started_at",
        "completed_at": "completed_at",
        "cancelled_at": "cancelled_at",
        "next_booking": null,
        "access": "access",
        "public_token": "public_token"
      }
    }
  ],
  "page": 0,
  "size": 0,
  "total": 0
}

json

application/json

List all guests across accounts (admin)

GET

/v1/admin/guests

List all guests across accounts (admin) › query Parameters

page

string

Zero-based page index (default 0)

size

string

Page size (max 100)

property_id

string

Restrict to a single property

query

string

Free-text across guest first/last name and email

List all guests across accounts (admin) › Responses

Paginated guests with property and owner context

AdminGuestsPageResponse

AdminGuest[] · required

page

integer | null

size

integer | null

total

integer | null

GET/v1/admin/guests

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

Example Responses

{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "booking_id": "00000000-0000-0000-0000-000000000000",
      "property_id": "00000000-0000-0000-0000-000000000000",
      "property_name": "property_name",
      "property_city": "property_city",
      "owner_name": "owner_name",
      "first_name": "first_name",
      "last_name": "last_name",
      "second_last_name": "second_last_name",
      "nationality_alpha_2": "nationality_alpha_2",
      "nationality_name": "nationality_name",
      "date_of_birth": "date_of_birth",
      "document_type": "document_type",
      "document_number": "document_number",
      "email": "email",
      "phone": "phone",
      "phone_prefix": "phone_prefix"
    }
  ],
  "page": 0,
  "size": 0,
  "total": 0
}

json

application/json

Admin · SES Other endpoints

Platform overview metrics for the admin dashboard (admin)

GET

/v1/admin/overview

Returns platform-wide counts (properties, users, bookings, guests), SES Hospedajes submission health, and integration/booking-code totals. Admin only.

Platform overview metrics for the admin dashboard (admin) › Responses

Platform overview snapshot

AdminOverviewResponse

generated_at

string · required

CountWithMonthlyDelta · required

SesOverview · required

IntegrationsOverview · required

List all users across accounts (admin)

GET

/v1/admin/users

List all users across accounts (admin) › query Parameters

page

string

Zero-based page index (default 0)

size

string

Page size (max 100)

query

string

Free-text across user name, last name and email

List all users across accounts (admin) › Responses

Paginated users

AdminUsersPageResponse

User[] · required

page

integer | null

size

integer | null

total

integer | null

List all properties with their owner (admin)

GET

/v1/admin/properties

List all properties with their owner (admin) › query Parameters

page

string

Zero-based page index (default 0)

size

string

Page size (max 100)

query

string

Free-text across property name/city and owner name/email

List all properties with their owner (admin) › Responses

Paginated properties with the user that created each

AdminPropertiesPageResponse

AdminProperty[] · required

page

integer | null

size

integer | null

total

integer | null

List all bookings across accounts (admin)

GET

/v1/admin/bookings

List all bookings across accounts (admin) › query Parameters

page

string

Zero-based page index (default 0)

size

string

Page size (max 100)

from

string

Filter by stay overlap range start (YYYY-MM-DD)

to

string

Filter by stay overlap range end (YYYY-MM-DD)

property_id

string

Restrict to a single property

query

string

Free-text across guest name, channel_id, ses_lote

channel

string

Filter by booking channel (Airbnb, Booking, Vrbo, Google, Direct)

List all bookings across accounts (admin) › Responses

Paginated bookings

AdminBookingsPageResponse

Booking[] · required

page

integer | null

size

integer | null

total

integer | null

List all guests across accounts (admin)

GET

/v1/admin/guests

List all guests across accounts (admin) › query Parameters

page

string

Zero-based page index (default 0)

size

string

Page size (max 100)

property_id

string

Restrict to a single property

query

string

Free-text across guest first/last name and email

List all guests across accounts (admin) › Responses

Paginated guests with property and owner context

AdminGuestsPageResponse

AdminGuest[] · required

page

integer | null

size

integer | null

total

integer | null