How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

GuestReady Rentals API

The rentals API from GuestReady — 11 operation(s) for rentals.

GuestReady Rentals API is one of 62 APIs that GuestReady publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Rentals. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and a getting-started guide.

This API exposes 17 operations across 11 paths, and defines 44 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0 (api).

Requests are made against a single base URL, https://pms.rentalready.io/api/v3/.

17 operations 11 paths 44 schemas 2 DELETE5 GET4 PATCH5 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0 (api)
Base URL
https://pms.rentalready.io/api/v3/
Authentication
HTTP Basic, API Key, OAuth 2.0, API Key
Resource Areas
1

Authentication & Security 4

GuestReady Rentals API declares 4 security schemes for authenticating requests. It accepts HTTP basic authentication (basicAuth). An API key is passed in the cookie as sessionid (cookieAuth). It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 52 scopes. An API key is passed in the header as Authorization (tokenAuth).

  • tokenAuth — Token-based authentication with required prefix "Token"

Paths & Operations 17

Across 11 paths, the API surfaces 17 operations — 2 DELETE, 5 GET, 4 PATCH, 5 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

rentals 17
GET
/api/v3/rentals/
Mixin that adds custom-fields GET/POST actions to entity ViewSets.
rentals_list 20 params → 200
POST
/api/v3/rentals/
Create a rental in status onboarding, to fill it with all required data
rentals_create body → 201
GET
/api/v3/rentals/{numero_contrat}/
Mixin that adds custom-fields GET/POST actions to entity ViewSets.
rentals_retrieve 1 param → 200
PUT
/api/v3/rentals/{numero_contrat}/
Update a rental
rentals_update 1 param body → 200
PATCH
/api/v3/rentals/{numero_contrat}/
Update a rental
rentals_partial_update 1 param body → 200
DELETE
/api/v3/rentals/{numero_contrat}/
Mixin that adds custom-fields GET/POST actions to entity ViewSets.
rentals_destroy 1 param → 204
PATCH
/api/v3/rentals/{numero_contrat}/block/
Block calendar
rentals_block_partial_update 1 param body → 200
GET
/api/v3/rentals/{numero_contrat}/custom_fields/
Get the custom-field values set on this object, as a mapping of custom field key to value.
rentals_custom_fields_retrieve 1 param → 200
POST
/api/v3/rentals/{numero_contrat}/custom_fields/
Set custom-field values on this object. Send a mapping of custom field key to value; keys left out keep their current value, and a key with no definition on this account is rejected.
rentals_custom_fields_create 1 param body → 200
POST
/api/v3/rentals/{numero_contrat}/disable/
Disable property
rentals_disable_create 1 param body → 200
POST
/api/v3/rentals/{numero_contrat}/enable/
Disable property
rentals_enable_create 1 param body → 200
GET
/api/v3/rentals/{numero_contrat}/history/
Get property change history
rentals_history_list 4 params → 200
POST
/api/v3/rentals/{numero_contrat}/smart-locks/
Assign a smart lock to a property
rentals_smart_locks_create 1 param body → 201
DELETE
/api/v3/rentals/{numero_contrat}/smart-locks/{smart_lock_id}/
Remove a smart lock from a property
rentals_smart_locks_destroy 2 params → 204
PATCH
/api/v3/rentals/{numero_contrat}/unblock/
Unblock calendar
rentals_unblock_partial_update 1 param body → 200
GET
/api/v3/rentals/{numero_contrat}/upselling_configuration/
Get the upselling configuration assigned to the property.
rentals_upselling_configuration_retrieve 1 param → 200
PATCH
/api/v3/rentals/{numero_contrat}/upselling_configuration/
Update the upselling configuration assigned to the property. The configuration must be one of those connected to the property's office; pass null to clear the assignment.
rentals_upselling_configuration_partial_update 1 param body → 200

Schemas 44

The contract defines 44 schemas that model the data the API accepts and returns. The most detailed are PatchedRental (230 properties), Rental (229 properties), CreateRental (28 properties), GuestControl (10 properties). Each schema is shown below with its type and property counts.

RentalPhoto
object
1 property 1 required
RentalInvoiceDetails
object
8 properties 6 required
BuildingConstructionPeriodEnum
string
BEFORE1949 - before 1949 FROM1949TO1974 - from 1949 to 1974 FROM1975TO1989 - from 1975 to 1989 FROM1989TO2005 - from 1989 to 2005 AFTER2005 - after 2005
RentalCategoryEnum
string
SHORT-TERM - Short-term MID-TERM - Mid-term LONG-TERM - Long-term
SecurityDepositChargingMethodEnum
string
NONE - No security deposit SWIKLY - Swikly STRIPE - Stripe
RentalUpsellingConfiguration
object
1 property
DisableProperty
object
1 property 1 required
PaginatedRentalHistoryList
object
5 properties 2 required
BuildingLegalStatusEnum
string
INDIVIDUAL - Individual ownership CONDOMINIUM - Condominium regime
PropertyTypeEnum
string
PRIMARY - Primary residence OTHER - Non-residential property (commercial/guest-room) SECONDARY - Secondary residence UNKNOWN - Unknown
RentalListing
object
5 properties 1 required
RentalHistoryTypeEnum
string
+ - + ~ - ~ - - -
TypeD5dEnum
string
InstantBookingChoicesEnum
string
OFF - No one EVERYONE - Everyone
KeyStrategyEnum
string
PADLOCK - Lockbox/Padlock KEYNEST - Keynest IGLOOHOMEKEYBOX - Igloohome KeyBox IGLOOHOMELOCK - Igloohome Lock OFFICE - Office pick-up NUKILOCK - Nuki lock SEAM…
Status075Enum
string
ACTIVE - ACTIVE INACTIVE - INACTIVE PENDINGDEACTIVATION - PENDINGDEACTIVATION PREONBOARDING - PREONBOARDING
CommissionCalculationEnum
string
PROPERTYMANAGER - Property Manager commission OWNER - Owner commission
RentalHistoryChange
object
4 properties 4 required
CreateRental
object
28 properties 11 required
CleaningFeeInvoicedToEnum
string
GUEST - Guest HOST - Owner
PublishedStatusEnum
string
NEW - New PENDING - Pending activation APPROVED - Activated
CancellationPolicyCategoryEnum
string
flexible - Flexible moderate - Moderate strict - Strict firm - Firm
RentalHistory
object
4 properties 4 required
StarsEnum
integer
0 - No Stars 1 - 1 Star 2 - 2 Stars 3 - 3 Stars 4 - 4 Stars 5 - 5 Stars
MultiUnitRoleEnum
string
ROOMTYPE - Room type INVENTORY - Inventory PARENT - Parent CHILD - Child
RentalCheckoutOptionTypes
object
9 properties
PaginatedRentalList
object
5 properties 2 required
SmartLockAssign
object
1 property 1 required
CurrencyValueEnum
string
AED - AED AUD - AUD BRL - BRL CAD - CAD CHF - CHF CZK - CZK EUR - EUR GBP - GBP HKD - HKD IDR - IDR ILS - ILS JPY - JPY KRW - KRW MAD - MAD MYR - MYR PLN - PLN…
SecurityDepositChargingRuleEnum
string
NEVER - Never charge a security deposit HIGHRISK - Only charge a security deposit in high-risk bookings ALWAYS - Always charge a security deposit
GuestControl
object
10 properties
BlankEnum
SelfCheckinEnum
string
FORBIDDEN - FORBIDDEN POSSIBLE - POSSIBLE ALWAYS - ALWAYS RECEPTION - RECEPTION
Rental
object
Renders custom-field values under customfields, skipped on list actions.
229 properties 51 required
PatchedUnblockRentalCalendar
object
2 properties
BlockRentalCalendar
object
4 properties 2 required
PatchedRentalUpsellingConfiguration
object
1 property
FrenchHotelNatureCategoryEnum
1 - Palace 2 - Tourist hotel 3 - Tourist residence 4 - Furnished tourism accommodation 5 - Holiday village 6 - Bed and breakfast 7 - Camping-car area or touris…
PremiumClassEnum
string
DIAMOND - Diamond GOLD - Gold SILVER - Silver BRONZE - Bronze CLASSIC - Classic
NullEnum
RentalSmartLock
object
4 properties 4 required
TurnoverDaysEnum
integer
0 - 0 1 - 1 2 - 2
PatchedRental
object
Renders custom-field values under customfields, skipped on list actions.
230 properties
PatchedBlockRentalCalendar
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

guestready-rentals-api-openapi.yml Raw ↑

Other APIs GuestReady publishes across the network.

GuestReady Accounting Invoices API
GuestReady Amenities API
GuestReady Bathrooms API
GuestReady Bed Types API
GuestReady Bedrooms API
GuestReady Blacklist API
GuestReady Calendar API
GuestReady Check In Steps API
GuestReady Cities API
GuestReady City Tax Rules API
GuestReady Conversations API
GuestReady Countries API
Where this information came from

This is an independent, third-party profile of GuestReady Rentals API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.