Skip to main content
API docs by Redocly

Autohost API (1)

Download OpenAPI specification:Download

Private API for Autohost customers.

Contact Sales to open an account.

My account

Return current user account information. This is often used to validate authentication.

header Parameters
x-api-key
required
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "email": "user@example.com",
  • "phone": "string",
  • "is_active": true,
  • "is_suspended": true,
  • "last_login": "2019-08-24T14:15:22Z",
  • "created_at": "2019-08-24T14:15:22Z",
  • "company": {
    },
  • "billing": {
    }
}

Reseller accounts list

Paginated list of user accounts belonging to a reseller profile.

query Parameters
from
number

Pagination control

size
number

Number of items to return

header Parameters
x-api-key
required
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "from": 0,
  • "size": 0,
  • "total": 0,
  • "items": [
    ]
}

Reseller API keys

List of API keys for all accounts owned by a reseller.

header Parameters
x-api-key
required
string

API Authentication Key

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create new API key

Create a new API key for the authenticated user.

header Parameters
x-api-key
required
string

API Authentication Key

Request Body schema: application/json

API key creation request

description
string

Description for the API key

sdk
boolean
Default: false

Whether this is an SDK API key

Responses

Request samples

Content type
application/json
Example
{
  • "description": "My API Key",
  • "sdk": false
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "description": "string",
  • "value": "string",
  • "enabled": true,
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "sdk": true
}

Update API key

Update an existing API key's description.

path Parameters
key
required
string

The API key ID

header Parameters
x-api-key
required
string

API Authentication Key

Request Body schema: application/json

API key update request

description
required
string

New description for the API key

Responses

Request samples

Content type
application/json
{
  • "description": "Updated API Key Description"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "description": "string",
  • "value": "string",
  • "enabled": true,
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "sdk": true
}

Delete API key

Delete an existing API key.

path Parameters
key
required
string

The API key ID

header Parameters
x-api-key
required
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "message": "Key removed"
}

Reseller new account

Register a new account under a channel profile. This is used by resellers and channel partners to create Autohost user accounts.

header Parameters
x-api-key
required
string

API Authentication Key

Request Body schema: application/json

JSON object with user account details

name
string
email
string <email>
phone
string
password
string
object

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "email": "user@example.com",
  • "phone": "string",
  • "password": "string",
  • "company": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "email": "user@example.com",
  • "phone": "string",
  • "is_active": true,
  • "is_suspended": true,
  • "last_login": "2019-08-24T14:15:22Z",
  • "created_at": "2019-08-24T14:15:22Z",
  • "company": {
    },
  • "billing": {
    }
}

Reseller update account

Update a channel account. This is used by resellers and channel partners to update Autohost user accounts.

path Parameters
id
required
string

Autohost user ID

query Parameters
suspended
string
Enum: "true" "false"

Suspend or unsuspend the account

status
string
Enum: "active" "disabled"

Enable or disable the account

header Parameters
x-api-key
required
string

API Authentication Key

Request Body schema: application/json

JSON object with user account details

name
string
email
string <email>
phone
string
password
string
object

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "email": "user@example.com",
  • "phone": "string",
  • "password": "string",
  • "company": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "email": "user@example.com",
  • "phone": "string",
  • "is_active": true,
  • "is_suspended": true,
  • "last_login": "2019-08-24T14:15:22Z",
  • "created_at": "2019-08-24T14:15:22Z",
  • "company": {
    },
  • "billing": {
    }
}

Reseller signup link

Generate a self-signup link for a given PMS. This is used by resellers and channel partners to create registration links they can send to their customers.

query Parameters
pms
required
string (QueryParamPMS)
Enum: "api" "apaleo" "beds24" "booking" "cloudbeds" "guesty" "hostaway" "hostfully" "inforhms" "impala" "lavanda" "myvr" "opera" "smartbnb" "stayntouch" "streamline" "trackhs"

PMS integration name

redirect
string

URL to redirect to after signup

hidepw
string

Hide password screen during user signup

header Parameters
x-api-key
required
string

API Authentication Key

Responses

Response samples

Content type
application/json
{}

Account create webhook

Register a new webhook. This is used by platforms such as Zapier to register webhooks.

header Parameters
x-api-key
required
string

API Authentication Key

Request Body schema: application/json

JSON object with webhook details

webhook_url
string <uri>
webhook_key
string
Enum: "guest_portal_webhook_url" "screening_webhook_url" "stargate_webhook_url" "reservation_webhook_url" "listing_webhook_url" "account_webhook_url"

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "message": "string"
}

Account remove webhook

Delete an existing webhook. This is used by platforms such as Zapier to unregister webhooks.

header Parameters
x-api-key
required
string

API Authentication Key

Request Body schema: application/json

JSON object with webhook details

webhook_url
string <uri>
webhook_key
string
Enum: "guest_portal_webhook_url" "screening_webhook_url" "stargate_webhook_url" "reservation_webhook_url" "listing_webhook_url" "account_webhook_url"

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "message": "string"
}

Update Guest Portal screen settings for an account

Update your own account settings, or update another user's account Guest Portal screen settings if you have the necessary permissions.

path Parameters
id
string

Autohost user ID (optional — defaults to the authenticated user)

header Parameters
x-api-key
required
string

API Authentication Key

Request Body schema: application/json

JSON object with account settings

config_key
string
Enum: "guest_portal_screens_for_repeat_guests" "guest_portal_screens_by_source"

Configuration key

Array of items

Configuration data for each source

Responses

Request samples

Content type
application/json
Example
{
  • "config_key": "guest_portal_screens_for_repeat_guests",
  • "config_data": [
    ]
}

Response samples

Content type
application/json
Example
{
  • "config_key": "guest_portal_screens_for_repeat_guests",
  • "config_data": [
    ]
}

Retrieve account settings

Fetch your own account settings, or another user's account settings if you have the necessary permissions.

path Parameters
id
string

Autohost user ID (optional — defaults to the authenticated user)

key
required
string

Setting key

header Parameters
x-api-key
required
string

API Authentication Key

Responses

Response samples

Content type
application/json
Example
{
  • "config_key": "guest_portal_screens_for_repeat_guests",
  • "config_data": [
    ]
}

Retrieve usage agreement template settings

Fetch resolved usage agreement template settings for your account, with optional reservation or listing overrides. Channel accounts may fetch settings for child accounts by passing the target user ID in the path.

path Parameters
id
string

Autohost user ID (optional — defaults to the authenticated user)

query Parameters
reservationId
string

Resolve the reservation-level template override for this reservation

listingId
string

Resolve the listing-level template override for this listing

header Parameters
x-api-key
required
string

API Authentication Key

Responses

Response samples

Content type
application/json
Example
{
  • "user": {
    },
  • "sources": [
    ],
  • "reservations": [
    ],
  • "listings": [
    ]
}

Update usage agreement template settings

Save (merge) usage agreement template settings for your account. All top-level fields are optional — only provided fields are upserted. Channel accounts may update settings for child accounts by passing the target user ID in the path.

path Parameters
id
string

Autohost user ID (optional — defaults to the authenticated user)

header Parameters
x-api-key
required
string

API Authentication Key

Request Body schema: application/json

Partial usage agreement settings to upsert

object

User-level agreement template

Array of objects

Source-specific templates (upserted by name)

Array of objects

Reservation-level template overrides

Array of objects

Listing-level template overrides

Responses

Request samples

Content type
application/json
Example
{
  • "user": {
    }
}

Response samples

Content type
application/json
Example
{
  • "user": {
    },
  • "sources": [
    ],
  • "reservations": [
    ],
  • "listings": [
    ]
}

Background Check - Submit

Start a background check

query Parameters
type
string
Enum: "globalcheck" "usa_criminal"

Background check type (default is globalcheck)

header Parameters
x-api-key
required
string

API Authentication Key

Request Body schema: application/json

JSON object with candidate details

first_name
required
string

First name

last_name
required
string

Last name

middle_name
string

Middle name (optional)

country
required
string = 2 characters

ISO 3166-1 alpha-2 country code

state
string >= 2 characters

ISO 3166-2 state code (e.g. US-NY)

city
string

City

street
string

Street address

gender
string
Enum: "M" "F" "X"

Gender type (optional)

phone
string

E.164 phone number (e.g. +15555555555)

email
required
string <email>

Email address

year_of_birth
integer [ 1900 .. 2100 ]

Year of birth (e.g. 1990)

date_of_birth
required
string <date>

ISO 8601 date (e.g. 1990-01-01)

reservation_id
string

Autohost reservation ID for additional context (recommended if available)

Responses

Request samples

Content type
application/json
{
  • "first_name": "John",
  • "last_name": "Doe",
  • "middle_name": "Smith",
  • "country": "US",
  • "state": "CA",
  • "city": "Los Angeles",
  • "email": "user@example.com",
  • "phone": "+14155555555",
  • "date_of_birth": "1985-12-31"
}

Response samples

Content type
application/json
{
  • "id": "98efb578c68591e90f8a05d0d52224a7c70df4fbd3faabc92bb011ab28ac5e7d",
  • "start_date": "2023-07-30T18:25:56.536Z",
  • "status": "PENDING",
  • "type": "globalcheck"
}

Background Check - Results

Get background check results

path Parameters
id
required
string

Background check report ID

header Parameters
x-api-key
required
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "id": "98efb578c68591e90f8a05d0d52224a7c70df4fbd3faabc92bb011ab28ac5e7d",
  • "start_date": "2023-07-30T18:25:56.536Z",
  • "stop_date": "2023-07-30T18:29:56.536Z",
  • "status": "FINISHED",
  • "risk_status": "CLEARED",
  • "type": "globalcheck",
  • "pdf": "https://www.example.com/report.pdf",
  • "report_items": [
    ]
}

Global Watchlist sources

Retrieve a list of sources available in the Global Watchlist

header Parameters
x-api-key
required
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "sources": [
    ]
}

ID verification upload

Upload base64-encoded photo for analysis and verification

path Parameters
id
required
string

Autohost reservation ID

step
required
string

Document side (front, back, selfie)

type
required
string

Document type (drivers, passport, id)

query Parameters
pms
string (QueryParamPMS)
Enum: "api" "apaleo" "beds24" "booking" "cloudbeds" "guesty" "hostaway" "hostfully" "inforhms" "impala" "lavanda" "myvr" "opera" "smartbnb" "stayntouch" "streamline" "trackhs"

PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code.

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

JSON object with DataURL or base64-encoded image

imageBase64
string

Responses

Request samples

Content type
application/json
Example
{
  • "imageBase64": "data:image/jpeg;base64,<base64-encoded image>"
}

Response samples

Content type
application/json
{
  • "code": "string",
  • "error": "string",
  • "card": {
    }
}

ID verification status

Get verification results for photos that you uploaded

path Parameters
id
required
string

Autohost reservation ID

query Parameters
pms
string (QueryParamPMS)
Enum: "api" "apaleo" "beds24" "booking" "cloudbeds" "guesty" "hostaway" "hostfully" "inforhms" "impala" "lavanda" "myvr" "opera" "smartbnb" "stayntouch" "streamline" "trackhs"

PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code.

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
Example
{
  • "status": "passed"
}

ID verification image

Get uploaded image for identification document on a reservation

path Parameters
id
required
string

Autohost reservation ID

step
required
string

Document side (front, back, selfie)

query Parameters
pms
string (QueryParamPMS)
Enum: "api" "apaleo" "beds24" "booking" "cloudbeds" "guesty" "hostaway" "hostfully" "inforhms" "impala" "lavanda" "myvr" "opera" "smartbnb" "stayntouch" "streamline" "trackhs"

PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code.

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "base64Image": "data:image/jpeg;base64,<base64-encoded image>"
}

Listing details

Get details object for a given listing.

path Parameters
id
required
string

Autohost listing ID

query Parameters
pms
string (QueryParamPMS)
Enum: "api" "apaleo" "beds24" "booking" "cloudbeds" "guesty" "hostaway" "hostfully" "inforhms" "impala" "lavanda" "myvr" "opera" "smartbnb" "stayntouch" "streamline" "trackhs"

PMS integration name. If supplied, the API will perform a lookup using the PMS listing ID or the identifier supplied in my_id

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "my_id": "string",
  • "user_id": "string",
  • "status": "string",
  • "name": "string",
  • "nickname": "string",
  • "property_type": "string",
  • "accommodates": 0,
  • "bedrooms": 0,
  • "bathrooms": 0,
  • "beds": 0,
  • "check_in_time": 0,
  • "check_out_time": 0,
  • "location": {
    },
  • "created_at": "string",
  • "updated_at": "string"
}

Listing update

Update a given listing in your account.

path Parameters
id
required
string

Autohost listing ID

query Parameters
callback
string (QueryParamCallback)

Webhook URL to POST the list object.

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

JSON object with listing details

id
string

Autohost listing ID. Used for updating an existing listing.

my_id
required
string

Your unique identifier for this listing. Alphanumeric characters only, no spaces or special characters.

status
required
string
Enum: "ACTIVE" "INACTIVE"

Listing status. Must be ACTIVE or INACTIVE.

name
required
string

Public-facing name for the listing.

nickname
string

Internal nickname for the listing. Defaults to the value of name if not provided.

property_type
string
Enum: "Apartment" "House" "Loft" "Boat" "Camper/RV" "Condominium" "Serviced Apartment" "Cottage" "Chalet" "Bed&Breakfast" "Villa" "Tent" "Other" "Cabin" "Townhouse" "Bungalow" "Hut" "Dorm" "Parking Space" "Plane" "Treehouse" "Yurt" "Tipi" "Igloo" "Earth House" "Island" "Cave" "Castle" "Studio" "Hotel"

Type of property for risk assessment.

accommodates
number

Maximum number of guests. Defaults to 2.

bedrooms
number

Number of bedrooms. Defaults to 1.

bathrooms
number

Number of bathrooms. Defaults to 1.

beds
number

Number of beds. Defaults to 1.

check_in_time
number

Check-in hour (0-24). Defaults to 16.

check_out_time
number

Check-out hour (0-24). Defaults to 11.

required
object

Listing location. Required fields: street, city, country, state, zipcode. Timezone is derived automatically if not provided (from geo coordinates first, then via address geocoding as a deprecated fallback). Providing timezone or geo coordinates directly will be required soon.

object

Listing images. If not provided on creation, default images are used.

Responses

Request samples

Content type
application/json
Example
{
  • "my_id": "UNIT100",
  • "status": "ACTIVE",
  • "name": "Beautiful Downtown View for Two",
  • "location": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "my_id": "string",
  • "user_id": "string",
  • "status": "string",
  • "name": "string",
  • "nickname": "string",
  • "property_type": "string",
  • "accommodates": 0,
  • "bedrooms": 0,
  • "bathrooms": 0,
  • "beds": 0,
  • "check_in_time": 0,
  • "check_out_time": 0,
  • "location": {
    },
  • "created_at": "string",
  • "updated_at": "string"
}

Listing create

Create a new listing in your account.

query Parameters
callback
string (QueryParamCallback)

Webhook URL to POST the list object.

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

JSON object with listing details

id
string

Autohost listing ID. Used for updating an existing listing.

my_id
required
string

Your unique identifier for this listing. Alphanumeric characters only, no spaces or special characters.

status
required
string
Enum: "ACTIVE" "INACTIVE"

Listing status. Must be ACTIVE or INACTIVE.

name
required
string

Public-facing name for the listing.

nickname
string

Internal nickname for the listing. Defaults to the value of name if not provided.

property_type
string
Enum: "Apartment" "House" "Loft" "Boat" "Camper/RV" "Condominium" "Serviced Apartment" "Cottage" "Chalet" "Bed&Breakfast" "Villa" "Tent" "Other" "Cabin" "Townhouse" "Bungalow" "Hut" "Dorm" "Parking Space" "Plane" "Treehouse" "Yurt" "Tipi" "Igloo" "Earth House" "Island" "Cave" "Castle" "Studio" "Hotel"

Type of property for risk assessment.

accommodates
number

Maximum number of guests. Defaults to 2.

bedrooms
number

Number of bedrooms. Defaults to 1.

bathrooms
number

Number of bathrooms. Defaults to 1.

beds
number

Number of beds. Defaults to 1.

check_in_time
number

Check-in hour (0-24). Defaults to 16.

check_out_time
number

Check-out hour (0-24). Defaults to 11.

required
object

Listing location. Required fields: street, city, country, state, zipcode. Timezone is derived automatically if not provided (from geo coordinates first, then via address geocoding as a deprecated fallback). Providing timezone or geo coordinates directly will be required soon.

object

Listing images. If not provided on creation, default images are used.

Responses

Request samples

Content type
application/json
Example
{
  • "my_id": "UNIT100",
  • "status": "ACTIVE",
  • "name": "Beautiful Downtown View for Two",
  • "location": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "my_id": "string",
  • "user_id": "string",
  • "status": "string",
  • "name": "string",
  • "nickname": "string",
  • "property_type": "string",
  • "accommodates": 0,
  • "bedrooms": 0,
  • "bathrooms": 0,
  • "beds": 0,
  • "check_in_time": 0,
  • "check_out_time": 0,
  • "location": {
    },
  • "created_at": "string",
  • "updated_at": "string"
}

Listing property types

Return a static list of supported property types. This list is used to populate the property_type field when creating a new listing object.

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
[
  • "Apartment",
  • "Cottage",
  • "Condominium",
  • "House",
  • "Hotel",
  • "Boat",
  • "Camper/RV",
  • "Other"
]

Listing manage SuperHog connection

Connect or disconnect your listings from SuperHog.

path Parameters
id
required
string

Autohost listing ID

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

JSON object with listing details

action
string
Enum: "connect" "disconnect"

Responses

Request samples

Content type
application/json
Example
{
  • "action": "connect"
}

Response samples

Content type
application/json
Example
{
  • "autohost_id": "xyxyxyxyxyxyx",
  • "superhog_id": "abcd1234"
}

Predict guest loyalty for a reservation

Predict guest rebooking probability and lifetime value for short-term rentals. Returns rebooking probability score (0-100) with loyalty tier, and predicted Guest Lifetime Value (USD) with value tier.

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

Guest loyalty features for prediction

booking_month
number [ 1 .. 12 ]
Default: 6

Month of booking (1-12)

booking_dow
number [ 0 .. 6 ]
Default: 3

Day of week for booking (0=Mon, 6=Sun)

booking_hour
number [ 0 .. 23 ]
Default: 12

Hour of day booking was made (0-23)

checkin_dow
number [ 0 .. 6 ]
Default: 4

Day of week for check-in (0=Mon, 6=Sun)

checkin_month
number [ 1 .. 12 ]
Default: 6

Month of check-in (1-12)

email_domain_rank
number >= 0
Default: 0

Email domain frequency rank (lower = more common)

risk_color_encoded
number [ 0 .. 4 ]
Default: 0

Risk color encoding (0=green, 1=yellow, 2=orange, 3=red, 4=black)

city_rank
number >= 0
Default: 0

City frequency rank (lower = more common)

lead_time_days
number [ -365 .. 730 ]
Default: 14

Days between booking and check-in

nights
number [ 0 .. 365 ]
Default: 2

Length of stay in nights

total_price
number >= 0
Default: 300

Total booking price in USD

average_daily_rate
number >= 0
Default: 150

Average price per night

number_of_guests
number [ 0 .. 50 ]
Default: 2

Number of guests

price_tier
number [ 0 .. 5 ]
Default: 2

Price tier category (0-5, higher = more expensive)

revenue_per_guest_night
number >= 0
Default: 75

Revenue per guest per night

bedrooms
number [ 0 .. 20 ]
Default: 1

Number of bedrooms in listing

guest_density
number >= 0
Default: 2

Guests per bedroom

prior_bookings_30d
number >= 0
Default: 0

Prior bookings by this guest in last 30 days

prior_bookings_90d
number >= 0
Default: 0

Prior bookings by this guest in last 90 days

prior_bookings_365d
number >= 0
Default: 0

Prior bookings by this guest in last 365 days

prior_revenue_total
number >= 0
Default: 0

Total revenue from prior bookings

prior_bookings_same_pm
number >= 0
Default: 0

Prior bookings with the same property manager

days_since_last_booking
number >= 0
Default: 0

Days since guest's last booking (0 if first booking)

booking_intensity
number >= 0
Default: 0

Booking frequency score

max_guests
number [ 0 .. 50 ]
Default: 4

Maximum guests allowed at listing

capacity_utilization
number [ 0 .. 1 ]
Default: 0.5

Ratio of guests to max capacity

payment_success_count
number >= 0
Default: 0

Successful payment count

payment_failure_count
number >= 0
Default: 0

Failed payment count

distinct_cards
number >= 0
Default: 0

Number of distinct payment cards used

payment_success_ratio
number [ 0 .. 1 ]
Default: 0

Ratio of successful to total payment attempts

idv_attempt_count
number >= 0
Default: 0

ID verification attempt count

idv_success_count
number >= 0
Default: 0

Successful ID verification count

idv_success_ratio
number [ 0 .. 1 ]
Default: 0

ID verification success rate

portal_started
number >= 0
Default: 0

Guest portal started count

portal_completed
number >= 0
Default: 0

Guest portal completed count

screens_count
number >= 0
Default: 0

Number of portal screens viewed

total_activity_events
number >= 0
Default: 0

Total activity log events

portal_completion_rate
number [ 0 .. 1 ]
Default: 0

Portal completion rate

distinct_fingerprints
number >= 0
Default: 0

Number of distinct device fingerprints

distinct_ips
number >= 0
Default: 0

Number of distinct IP addresses

total_fingerprint_events
number >= 0
Default: 0

Total fingerprint events

avg_confidence
number [ 0 .. 1 ]
Default: 0

Average fingerprint confidence score

incident_count
number >= 0
Default: 0

Total incident count for guest

is_direct_booking
number [ 0 .. 1 ]
Default: 0

1 if direct booking, 0 otherwise

is_ota_booking
number [ 0 .. 1 ]
Default: 0

1 if OTA booking (Airbnb, VRBO, etc.)

is_free_email
number [ 0 .. 1 ]
Default: 0

1 if using free email provider (gmail, yahoo, etc.)

is_booking_guest
number [ 0 .. 1 ]
Default: 1

1 if guest made the booking themselves

is_long_stay
number [ 0 .. 1 ]
Default: 0

1 if stay is 7+ nights

has_prior_booking
number [ 0 .. 1 ]
Default: 0

1 if guest has prior bookings

has_idv_enabled
number [ 0 .. 1 ]
Default: 0

1 if ID verification was enabled for this booking

has_payment_data
number [ 0 .. 1 ]
Default: 0

1 if payment data available

has_payment_issues
number [ 0 .. 1 ]
Default: 0

1 if any payment issues occurred

has_idv_data
number [ 0 .. 1 ]
Default: 0

1 if ID verification data available

idv_completed
number [ 0 .. 1 ]
Default: 0

1 if ID verification was completed

has_payment_failure
number [ 0 .. 1 ]
Default: 0

1 if any payment failures

has_activity_data
number [ 0 .. 1 ]
Default: 0

1 if activity log data available

has_multiple_devices
number [ 0 .. 1 ]
Default: 0

1 if multiple devices detected

has_fingerprint_data
number [ 0 .. 1 ]
Default: 0

1 if fingerprint data available

has_chargeback_incident
number [ 0 .. 1 ]
Default: 0

1 if guest has chargeback history

has_fraud_warning
number [ 0 .. 1 ]
Default: 0

1 if fraud warning on record

has_creditcard_incident
number [ 0 .. 1 ]
Default: 0

1 if credit card incident on record

has_any_incident
number [ 0 .. 1 ]
Default: 0

1 if any incident on record

is_verified
number [ 0 .. 1 ]
Default: 0

1 if guest identity is verified

guestportal_completed_flag
number [ 0 .. 1 ]
Default: 0

1 if guest portal was completed

Responses

Request samples

Content type
application/json
Example
{
  • "lead_time_days": 7,
  • "nights": 3,
  • "number_of_guests": 2,
  • "total_price": 450
}

Response samples

Content type
application/json
Example
{
  • "rebooking_score": 75.5,
  • "rebooking_tier": "high_loyalty",
  • "rebooking_tier_description": "Top prospects for re-engagement",
  • "predicted_glv": 2500,
  • "glv_tier": "high_value",
  • "glv_tier_description": "VIP treatment candidates",
  • "threshold_info": {
    }
}

Look up RFM segments for multiple guests (batch)

Look up RFM segments for multiple guests (max 100). Returns found results and list of not-found guest IDs.

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

Batch lookup request with guest IDs

guest_ids
required
Array of strings

Max 100 guest IDs per request

Responses

Request samples

Content type
application/json
{
  • "guest_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "not_found": [
    ],
  • "total_requested": 2,
  • "total_found": 1
}

Look up RFM segment for a guest

Look up RFM segment for a guest. The segment path parameter accepts a guest ID (email address or phone number). Optionally filter by property manager.

path Parameters
segment
required
string

Guest ID (email address or phone number)

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "guest_id": "guest@example.com",
  • "timestamp": "2026-01-15T10:30:00Z",
  • "segment": {
    },
  • "rfm_scores": {
    },
  • "metrics": {
    },
  • "data_quality": {
    },
  • "top_factors": [
    ],
  • "flags": {
    }
}

Reservation details

Get reservation details object.

path Parameters
id
required
string

Autohost reservation ID

query Parameters
pms
string (QueryParamPMS)
Enum: "api" "apaleo" "beds24" "booking" "cloudbeds" "guesty" "hostaway" "hostfully" "inforhms" "impala" "lavanda" "myvr" "opera" "smartbnb" "stayntouch" "streamline" "trackhs"

PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code.

usepmsid
string

Assume id is the PMS reservation ID. Must be used with pms. (Default: false)

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_id": "string",
  • "confirmation_code": "string",
  • "status": "string",
  • "source": "string",
  • "listing_id": "string",
  • "listing_nickname": "string",
  • "listing_timezone_name": "string",
  • "number_of_guests": 0,
  • "nights": 0,
  • "total_price": 0,
  • "average_daily_rate": 0,
  • "check_in_date": "string",
  • "check_out_date": "string",
  • "guest_portal_url": "string",
  • "guest": {
    },
  • "identification": {
    },
  • "created_at": "string",
  • "updated_at": "string"
}

Reservation update

Update reservation object

path Parameters
id
required
string

Autohost reservation ID

query Parameters
callback
string (QueryParamCallback)

Webhook URL to post data back to once Screening AI finished analyzing the reservation.

sync
boolean (QueryParamSync)
Enum: 1 true

Execution is asynchronous by default and the response, including reservation ID, will be returned via webhook when you supply the callback parameter. You can enable synchronous execution by setting sync=1, but it is discouraged when sending large amounts of requests.

skip_gp
boolean (QueryParamSkipGP)
Enum: 1 true

Verification analysis to proceed without dependence on Guest Portal completion. To be included for all reservations where the guest is not expected to complete the portal.

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

JSON object with reservation details

status
required
string
Enum: "CONFIRMED" "CANCELED" "INQUIRY"
source
required
string
listing_id
required
string
confirmation_code
required
string
number_of_guests
required
number
nights
number
total_price
required
number
check_in_date
required
string <date-time>
check_out_date
required
string <date-time>
created_at
string <date-time>
object
object
object

Inline listing object. Use this to create or update the listing in the same request instead of providing a listing_id. If a listing with the same my_id already exists it will be updated; otherwise a new listing is created.

Responses

Request samples

Content type
application/json
Example
{
  • "guest": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_id": "string",
  • "confirmation_code": "string",
  • "status": "string",
  • "source": "string",
  • "listing_id": "string",
  • "listing_nickname": "string",
  • "listing_timezone_name": "string",
  • "number_of_guests": 0,
  • "nights": 0,
  • "total_price": 0,
  • "average_daily_rate": 0,
  • "check_in_date": "string",
  • "check_out_date": "string",
  • "guest_portal_url": "string",
  • "guest": {
    },
  • "identification": {
    },
  • "created_at": "string",
  • "updated_at": "string"
}

Reservation summary

Get reservation verifications summary and details

path Parameters
id
required
string

Autohost reservation ID

query Parameters
pms
string (QueryParamPMS)
Enum: "api" "apaleo" "beds24" "booking" "cloudbeds" "guesty" "hostaway" "hostfully" "inforhms" "impala" "lavanda" "myvr" "opera" "smartbnb" "stayntouch" "streamline" "trackhs"

PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code.

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "guest_portal_status": "COMPLETED",
  • "guest_portal_last_screen": "IDCheck",
  • "verification_composite_status": "review",
  • "verification_status": "review",
  • "verification_status_reason": "ID Check, Fraud Detection and Business Rules require your attention",
  • "risk_color": "yellow",
  • "top_risks": [
    ],
  • "top_recommendations": [
    ],
  • "loyalty_segments": [
    ],
  • "details": {
    },
  • "supervised_status": null
}

Reservation status

Get reservation status and verification details

path Parameters
id
required
string

Autohost reservation ID

query Parameters
pms
string (QueryParamPMS)
Enum: "api" "apaleo" "beds24" "booking" "cloudbeds" "guesty" "hostaway" "hostfully" "inforhms" "impala" "lavanda" "myvr" "opera" "smartbnb" "stayntouch" "streamline" "trackhs"

PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code.

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "status": "verified",
  • "pms_status": "CONFIRMED",
  • "supervised": "approve",
  • "reason": "string",
  • "guestportal_completed": true,
  • "business_rules": [
    ]
}

Reservation status change

Approve or decline a reservation manually

path Parameters
id
required
string

Autohost reservation ID

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

JSON object with verification details

supervised
string
Enum: "approve" "decline"
notes
string

Responses

Request samples

Content type
application/json
Example
{
  • "supervised": "decline"
}

Response samples

Content type
application/json
{
  • "status": "verified",
  • "pms_status": "CONFIRMED",
  • "supervised": "approve",
  • "reason": "string",
  • "guestportal_completed": true,
  • "business_rules": [
    ]
}

Reservation Guest Portal Screens

Guest Portal screens configuration for a specific reservation.

path Parameters
id
required
string

Autohost reservation ID

query Parameters
pms
string (QueryParamPMS)
Enum: "api" "apaleo" "beds24" "booking" "cloudbeds" "guesty" "hostaway" "hostfully" "inforhms" "impala" "lavanda" "myvr" "opera" "smartbnb" "stayntouch" "streamline" "trackhs"

PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code.

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "AboutYou": "disabled",
  • "AuthorityReporting": "disabled",
  • "BuildingScreen": "disabled",
  • "BackgroundCheck": "disabled",
  • "CreditCheck": "disabled",
  • "IDVerification": "disabled",
  • "IDCollection": "disabled",
  • "SecurityDeposit": "disabled",
  • "UsageAgreement": "disabled",
  • "Coronavirus": "disabled",
  • "CustomScreen": "disabled",
  • "FileUpload": "disabled",
  • "GuestList": "disabled",
  • "HouseRules": "disabled",
  • "LongTerm": "disabled",
  • "PurposeOfStay": "disabled",
  • "TimeInfoEdit": "disabled",
  • "SexOffendersAddon": "disabled",
  • "SocialVerificationAddon": "disabled",
  • "SanctionsSearchAddon": "disabled",
  • "FraudDetectionAddon": "disabled",
  • "AdverseMediaSearchAddon": "disabled"
}

Reservation notes

Get list of notes for a reservation

path Parameters
id
required
string

Autohost reservation ID

query Parameters
pms
string (QueryParamPMS)
Enum: "api" "apaleo" "beds24" "booking" "cloudbeds" "guesty" "hostaway" "hostfully" "inforhms" "impala" "lavanda" "myvr" "opera" "smartbnb" "stayntouch" "streamline" "trackhs"

PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code.

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Reservation payments

Payment details for a reservation. Includes Security Deposit, Damage Waiver and Payment Validation.

path Parameters
id
required
string

Autohost reservation ID

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "security_deposit": {
    },
  • "payment_validation": {
    },
  • "damage_waiver": {
    },
  • "extra_services": {
    }
}

Reservation messages

List of queued and sent Stargate messages for a given reservation.

path Parameters
id
required
string

Autohost reservation ID

header Parameters
x-api-key
required
string

API Authentication Key

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Reservation Guest Portal

Guest Portal details for a reservation

path Parameters
id
required
string

Autohost reservation ID

query Parameters
pms
string (QueryParamPMS)
Enum: "api" "apaleo" "beds24" "booking" "cloudbeds" "guesty" "hostaway" "hostfully" "inforhms" "impala" "lavanda" "myvr" "opera" "smartbnb" "stayntouch" "streamline" "trackhs"

PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code.

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "full_name": "string",
  • "phone": "string",
  • "email": "user@example.com",
  • "name_on_card": "string",
  • "security_deposit": true,
  • "last_step": "string",
  • "completed": true,
  • "completed_at": "string",
  • "updated_at": "string",
  • "guests": [
    ]
}

Reservation creation

Create new reservation object

query Parameters
callback
string (QueryParamCallback)

Webhook URL to post data back to once Screening AI finished analyzing the reservation.

sync
boolean (QueryParamSync)
Enum: 1 true

Execution is asynchronous by default and the response, including reservation ID, will be returned via webhook when you supply the callback parameter. You can enable synchronous execution by setting sync=1, but it is discouraged when sending large amounts of requests.

skip_gp
boolean (QueryParamSkipGP)
Enum: 1 true

Verification analysis to proceed without dependence on Guest Portal completion. To be included for all reservations where the guest is not expected to complete the portal.

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

JSON object with reservation details

status
required
string
Enum: "CONFIRMED" "CANCELED" "INQUIRY"
source
required
string
listing_id
required
string
confirmation_code
required
string
number_of_guests
required
number
nights
number
total_price
required
number
check_in_date
required
string <date-time>
check_out_date
required
string <date-time>
created_at
string <date-time>
object
object
object

Inline listing object. Use this to create or update the listing in the same request instead of providing a listing_id. If a listing with the same my_id already exists it will be updated; otherwise a new listing is created.

Responses

Request samples

Content type
application/json
Example
{
  • "guest": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_id": "string",
  • "confirmation_code": "string",
  • "status": "string",
  • "source": "string",
  • "listing_id": "string",
  • "listing_nickname": "string",
  • "listing_timezone_name": "string",
  • "number_of_guests": 0,
  • "nights": 0,
  • "total_price": 0,
  • "average_daily_rate": 0,
  • "check_in_date": "string",
  • "check_out_date": "string",
  • "guest_portal_url": "string",
  • "guest": {
    },
  • "identification": {
    },
  • "created_at": "string",
  • "updated_at": "string"
}

Reservation payment event

Record a payment event belonging to a reservation for fraud analysis and business rules.

The following parameters are optional, but highly recommended:

  • card_country
  • card_provider
  • card_expiry_month
  • card_expiry_year
  • three_d_secure
  • billing_email
  • billing_phone
  • ip_address

If you are using Adyen, see this guide for more information on how to get the required parameters.

Examples of how to map the webhook events from common providers:

path Parameters
id
required
string

Autohost reservation ID

header Parameters
x-api-key
required
string

API Authentication Key

Request Body schema: application/json

JSON object with payment event details

reservation_id
required
string

Autohost reservation ID

event_source
required
string
Enum: "adyen" "stripe" "other"

Payment processor

event_id
required
string

Unique event ID from payment processor

event_type
required
string
Enum: "authorization" "charge" "refund" "dispute" "chargeback"

Type of the event

event_status
required
string
Enum: "info" "warning" "success" "failure"

Status of the event

customer_id
string

Unique customer ID from payment processor or your system

processor_status_code
string

Status code from the payment processor

processor_message
string

Message from the payment processor

network_status_code
string
Enum: "approved_by_network" "declined_by_network" "not_sent_to_network" "reversed_after_approval"

Network status code

three_d_secure
string
Enum: "attempt_acknowledged" "authenticated" "exempted" "failed" "not_supported" "processing_error"

3D Secure status (if applicable)

amount
number >= 0

Amount in major currency units (e.g. 1.25)

currency
string = 3 characters

ISO 4217 currency code (e.g. usd)

charge_descriptor
string

Short description of the charge

name_on_card
string

Name on the card

payment_method
string
Enum: "card" "ach"

Payment method

card_type
string
Enum: "credit" "debit" "prepaid"

Card type (credit, debit, prepaid)

card_provider
string
Enum: "visa" "mastercard" "amex" "discover" "jcb" "diners" "maestro" "unionpay" "other"

Issuer of the card

card_country
string = 2 characters

The country where the card was issued in ISO 3166-1 alpha-2 format (e.g. US)

card_iin
string [ 4 .. 6 ] characters

Issuer Identification Number

card_last4
string = 4 characters

Last 4 digits of the card number

card_expiry_month
string = 2 characters

Expiry month of the card

card_expiry_year
string = 4 characters

Expiry year of the card

card_fingerprint
string

Unique card fingerprint provided by payment processor (if available)

card_cvc_check
string
Enum: "pass" "fail" "unavailable"

Card security code check

card_postal_code_check
string
Enum: "pass" "fail" "unavailable"

Card postal code check

card_line1_check
string
Enum: "pass" "fail" "unavailable"

Card address line 1 check

billing_country_code
string = 2 characters

Country code of the billing address in ISO 3166-1 alpha-2 format

billing_address
string

Billing street address

billing_city
string

Billing city

billing_state_code
string

Billing state code in ISO 3166-2 format

billing_postal_code
string

Billing postal code

billing_phone
string

Billing phone number in E.164 format (e.g. +15555555555)

billing_email
string <email>

Billing email address

billing_name
string

Billing name

ip_address
string <ipv4>

IP address of the customer

user_agent
string

User agent of the customer

timestamp
string <date-time>

Timestamp of the event in ISO 8601 format (e.g. 2022-05-22T18:06:20.352Z)

Responses

Request samples

Content type
application/json
Example
{
  • "event_source": "adyen",
  • "event_id": "123456789",
  • "event_type": "charge",
  • "event_status": "failure",
  • "customer_id": "123456789",
  • "processor_status_code": "111",
  • "processor_message": "Invalid BankCountryCode specified",
  • "network_status_code": "declined_by_network",
  • "three_d_secure": "exempted",
  • "amount": 101.5,
  • "currency": "usd",
  • "charge_descriptor": "PRE-AUTH Security Deposit",
  • "name_on_card": "John Doe",
  • "payment_method": "card",
  • "card_type": "credit",
  • "card_provider": "visa",
  • "card_iin": "41111",
  • "card_last4": "1111",
  • "card_expiry_month": "12",
  • "card_expiry_year": "2025",
  • "billing_country_code": "US",
  • "billing_address": "123 Main St",
  • "billing_city": "New York",
  • "billing_state_code": "NY",
  • "billing_postal_code": "10001",
  • "billing_phone": "+15555555555",
  • "billing_email": "user@example.com",
  • "billing_name": "John Doe",
  • "ip_address": "8.8.8.8",
  • "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/69.0.3497.100 Safari/537.36",
  • "timestamp": "2022-05-22T18:06:20.352Z"
}

Response samples

Content type
application/json
{
  • "message": "string"
}

Download a reservation report

Download a report PDF for a specific reservation. Currently supports usage-agreement reports — returns a pre-signed URL to the signed usage agreement PDF. The caller must own the reservation, or be a channel account whose child account owns it.

path Parameters
reservationId
required
string

Autohost reservation ID

reportType
required
string
Value: "usage-agreement"

Type of report to download

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Lookup phone number

Lookup line type and carrier

path Parameters
number
required
string

URL-encoded phone number in international format (e.g. +441234567890)

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "countryCode": "US",
  • "phoneNumber": "+1234567890",
  • "nationalFormat": "(123) 456-7890",
  • "carrier": {
    }
}

Lookup social accounts

Lookup social accounts by email and phone number to Check users are not using fake profiles by validating they have online social accounts

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

Transaction details object

email
string <email>
phoneNumber
string

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com",
  • "phoneNumber": "string"
}

Response samples

Content type
application/json
{
  • "phoneNumber": {
    },
  • "email": { }
}

Lookup breaches by email

Discover how many times a user has been compromised

path Parameters
email
required
string

URL encoded email address

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Lookup whois records by domain

Discover who owns a domain

path Parameters
domain
required
string

domain name (e.g. google.com)

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Lookup company details by domain

Find company details by domain

path Parameters
domain
required
string

domain name (e.g. oracle.com)

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
[]

Lookup geo-location by IP

Find location details by IP address

path Parameters
ip
required
string

IP Address

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "country_code": "US",
  • "country_name": "United States",
  • "city": "Mountain View",
  • "postal_code": "94043",
  • "time_zone_name": "America/Los_Angeles",
  • "latitude": 37.4192,
  • "longitude": -122.0574
}

Lookup sex offenders

Search sex offenders in the USA

query Parameters
fname
required
string

First name

lname
required
string

Last name

dob
required
string

Date of birth (YYYY-MM-DD)

state
required
string

State (e.g. CA)

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "from": 0,
  • "size": 0,
  • "total": 0,
  • "items": [
    ]
}

Lookup postal address

Lookup or verify billing and shipping addresses

path Parameters
address
required
string

Street or mailing address (URL-encoded)

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "address": "123 Main St",
  • "street": "123 Main St",
  • "city": "Mountain View",
  • "state": "CA",
  • "country": "US",
  • "country_code": "US",
  • "zipcode": "94043",
  • "timezone": "America/Los_Angeles",
  • "geo": {
    }
}

Lookup IP Threats

Lookup threat reports associated with an IP address

path Parameters
ip
required
string

IP Address

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Adverse Media Report

View results of an adverse media search for a person or company

path Parameters
id
required
string

Report ID

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "id": "ab48405329f526a3f43f6e9c711466f503395f86a18110641ae246df544e56f1",
  • "status": "FINISHED",
  • "startDate": "2023-01-01T00:00:00.000Z",
  • "stopDate": "2023-01-01T00:10:00.000Z",
  • "riskCategories": [
    ],
  • "findings": []
}

Validate phone number

Ensure that the phone number is valid

path Parameters
number
required
string

URL-encoded phone number in international format (e.g. +441234567890)

query Parameters
country
string (QueryParamCountry)

ISO country code (two letters)

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
Example
{
  • "countryCode": "US",
  • "phoneNumber": "+1234567890",
  • "nationalFormat": "(123) 456-7890"
}

Validate email address

Ensure that the email address is valid

path Parameters
email
required
string

URL encoded email address

header Parameters
x-api-key
string

API Authentication Key

Responses

Response samples

Content type
application/json
Example
{
  • "status": "VALID",
  • "result": {
    }
}

Analyze a transaction for fraud

Send object with transaction parameters to the fraud endpoint

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

Transaction details object

sessionToken
string
productToken
string
email
string <email>
phoneNumber
string
phoneCountry
string
ipAddress
string
billingCountry
string
billingZip
string

Responses

Request samples

Content type
application/json
{
  • "sessionToken": "string",
  • "productToken": "string",
  • "email": "user@example.com",
  • "phoneNumber": "string",
  • "phoneCountry": "string",
  • "ipAddress": "string",
  • "billingCountry": "string",
  • "billingZip": "string"
}

Response samples

Content type
application/json
{
  • "score": 0,
  • "status": "pass",
  • "cacheKey": "string"
}

Predict fraud risk for a reservation

Analyzes reservation features using a trained ML model and returns a fraud probability score with risk tier classification. All input features are optional with sensible defaults. The model performs best when more features are provided.

header Parameters
x-api-key
string

API Authentication Key

Request Body schema: application/json

Reservation features for fraud prediction

lead_time_days
number [ -365 .. 730 ]
Default: 0

Days between booking and check-in

nights
number [ 0 .. 365 ]
Default: 1

Length of stay in nights

guests_count
number [ 0 .. 50 ]
Default: 1

Number of guests

booking_hour
number [ 0 .. 23 ]
Default: 12

Hour of day booking was made (0-23)

is_weekend_booking
number [ 0 .. 1 ]
Default: 0

1 if booked on weekend, 0 otherwise

price_total
number >= 0
Default: 0

Total booking price

has_phone
number [ 0 .. 1 ]
Default: 0

1 if phone number provided

name_word_count
number [ 0 .. 20 ]
Default: 2

Words in guest name

risk_color_numeric
number [ 0 .. 4 ]
Default: 0

Risk color (0=green, 1=yellow, 2=orange, 3=red, 4=black)

stripe_fraud_numeric
number [ 0 .. 2 ]
Default: 0

Stripe fraud level (0-2)

blacklist_count
number >= 0
Default: 0

Blacklist match count

verification_status_numeric
number [ 0 .. 2 ]
Default: 0

Verification status (0-2)

stripe_decline_count
number >= 0
Default: 0

Prior Stripe declines

idv_attempt_count
number >= 0
Default: 0

ID verification attempts

idv_success_count
number >= 0
Default: 0

Successful ID verification attempts

idv_failure_count
number >= 0
Default: 0

Failed ID verification attempts

idv_success_ratio
number [ 0 .. 1 ]
Default: 0

ID verification success rate

blurred_front_count
number >= 0
Default: 0

Blurred front ID scans

blurred_back_count
number >= 0
Default: 0

Blurred back ID scans

payment_event_count
number >= 0
Default: 0

Total payment events

payment_success_count
number >= 0
Default: 0

Successful payments

payment_failure_count
number >= 0
Default: 0

Failed payments

payment_failure_ratio
number [ 0 .. 1 ]
Default: 0

Payment failure rate

distinct_cards
number >= 0
Default: 0

Distinct cards used

has_chargeback
number [ 0 .. 1 ]
Default: 0

1 if has chargeback

has_dispute
number [ 0 .. 1 ]
Default: 0

1 if has dispute

has_refund
number [ 0 .. 1 ]
Default: 0

1 if has refund

has_stolen_card_flag
number [ 0 .. 1 ]
Default: 0

1 if stolen card detected

has_fraudulent_flag
number [ 0 .. 1 ]
Default: 0

1 if fraudulent flag

has_lost_card_flag
number [ 0 .. 1 ]
Default: 0

1 if lost card detected

has_highest_risk_flag
number [ 0 .. 1 ]
Default: 0

1 if highest risk

has_blocklist_flag
number [ 0 .. 1 ]
Default: 0

1 if on blocklist

insufficient_funds_count
number >= 0
Default: 0

Insufficient funds events

do_not_honor_count
number >= 0
Default: 0

Do not honor events

fingerprint_count
number >= 0
Default: 0

Total fingerprints

distinct_fingerprints
number >= 0
Default: 0

Distinct fingerprints

distinct_ips
number >= 0
Default: 0

Distinct IP addresses

has_stripe_fp
number [ 0 .. 1 ]
Default: 0

Has Stripe fingerprint

has_fpjspro_fp
number [ 0 .. 1 ]
Default: 0

Has FPJSPro fingerprint

has_default_fp
number [ 0 .. 1 ]
Default: 0

Has default fingerprint

prior_res_same_email_30d
number >= 0
Default: 0

Prior bookings same email (30 days)

prior_res_same_email_90d
number >= 0
Default: 0

Prior bookings same email (90 days)

distinct_listings_90d
number >= 0
Default: 0

Distinct listings booked (90 days)

has_booking_data
number [ 0 .. 1 ]
Default: 1

Has booking data

has_idv_data
number [ 0 .. 1 ]
Default: 0

Has ID verification data

has_payment_data
number [ 0 .. 1 ]
Default: 0

Has payment data

has_fingerprint_data
number [ 0 .. 1 ]
Default: 0

Has fingerprint data

has_velocity_data
number [ 0 .. 1 ]
Default: 0

Has velocity data

email_domain_freq
number >= 0
Default: 0

Email domain frequency encoding

booking_source_freq
number >= 0
Default: 0

Booking source frequency encoding

first_idv_status_freq
number >= 0
Default: 0

First IDV status encoding

last_idv_status_freq
number >= 0
Default: 0

Last IDV status encoding

first_recognition_status_STAGE_VALID
number [ 0 .. 1 ]
Default: 0
first_recognition_status_UNCERTAIN
number [ 0 .. 1 ]
Default: 0
first_recognition_status_VALID
number [ 0 .. 1 ]
Default: 0
first_recognition_status_unknown
number [ 0 .. 1 ]
Default: 0
last_recognition_status_STAGE_VALID
number [ 0 .. 1 ]
Default: 0
last_recognition_status_UNCERTAIN
number [ 0 .. 1 ]
Default: 0
last_recognition_status_VALID
number [ 0 .. 1 ]
Default: 0
last_recognition_status_unknown
number [ 0 .. 1 ]
Default: 0
earliest_fp_engine_fpjspro
number [ 0 .. 1 ]
Default: 0
earliest_fp_engine_guesty
number [ 0 .. 1 ]
Default: 0
earliest_fp_engine_stripe
number [ 0 .. 1 ]
Default: 0
earliest_fp_engine_unknown
number [ 0 .. 1 ]
Default: 0
price_per_night
number >= 0
Default: 0

Price per night

has_idv_failure
number [ 0 .. 1 ]
Default: 0

Has IDV failure

payment_risk_score
number >= 0
Default: 0

Composite payment risk score

high_velocity_flag
number [ 0 .. 1 ]
Default: 0

High booking velocity

multiple_cards_flag
number [ 0 .. 1 ]
Default: 0

Multiple cards used

Responses

Request samples

Content type
application/json
Example
{
  • "lead_time_days": 7,
  • "nights": 3,
  • "guests_count": 2,
  • "price_total": 450
}

Response samples

Content type
application/json
Example
{
  • "fraud_probability": 0.065,
  • "risk_tier": "auto_approve",
  • "action": "Automatic approval - low risk",
  • "threshold_info": {
    }
}

Tenant Evictions sources

Retrieve a list of sources available in the Tenant Evictions list

header Parameters
x-api-key
required
string

API Authentication Key

Responses

Response samples

Content type
application/json
{
  • "sources": [
    ]
}