Archived

This project has been archived by its maintainers, and is no longer receiving any updates.

Cloudbeds PMS V1.2

Welcome to the documentation for Cloudbeds API Version v1.2! If you are looking to learn how to use the Cloudbeds API to access guest information, reservations, or similar data for your Cloudbeds customers, then you've come to the right place.

In this document you will find all the API methods we provide along with explanations for parameters and response examples.

If you have questions about different implementation steps (e.g. how to implement OAuth 2.0), please refer to our Integrations Portal.

Be sure to subscribe to the monthly Cloudbeds API announcement mailing list to receive information on new additions and improvements to the Cloudbeds API and related developer tools.

Endpoint: https://api.cloudbeds.com/api/v1.2/{method}

HTTPS: Our API requires HTTPS. We'll respond with an appropriate error if you're not using it.

Request Format: HTTP GET, POST and PUT (Content-Type: application/x-www-form-urlencoded)

Response Format: JSON

Response Header: X-Request-ID is added to response headers in all calls to help accelerate support and troubleshooting.

\"Run use this link to access our Public collection in Postman.

The cloudbeds_pms_v1_2 package is automatically generated by the OpenAPI Generator project:

  • API version: v1.2
  • Package version: 1.3.0
  • Generator version: 7.11.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen

Requirements.

Python 3.8+

Installation & Usage

This python library package is generated without supporting files like setup.py or requirements files

To be able to use it, you will need these dependencies in your own package that uses this library:

  • urllib3 >= 1.25.3, < 3.0.0
  • python-dateutil >= 2.8.2
  • pydantic >= 2
  • typing-extensions >= 4.7.1

Getting Started

In your own code, to use this library to connect and interact with Cloudbeds PMS V1.2, you can run the following:

import cloudbeds_pms_v1_2
from cloudbeds_pms_v1_2.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.cloudbeds.com/api/v1.2
# See configuration.py for a list of all supported configuration parameters.
configuration = cloudbeds_pms_v1_2.Configuration(
    host = "https://api.cloudbeds.com/api/v1.2"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

configuration.access_token = os.environ["ACCESS_TOKEN"]

# Configure API key authorization: api_key
configuration.api_key['api_key'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['api_key'] = 'Bearer'


# Enter a context with an instance of the API client
with cloudbeds_pms_v1_2.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = cloudbeds_pms_v1_2.AdjustmentApi(api_client)
    reservation_id = 'reservation_id_example' # str | Reservation identifier
    adjustment_id = 'adjustment_id_example' # str | Adjustment identifier
    property_id = 'property_id_example' # str | Property ID (optional)

    try:
        # deleteAdjustment
        api_response = api_instance.delete_adjustment_delete(reservation_id, adjustment_id, property_id=property_id)
        print("The response of AdjustmentApi->delete_adjustment_delete:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling AdjustmentApi->delete_adjustment_delete: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.cloudbeds.com/api/v1.2

Class Method HTTP request Description
AdjustmentApi delete_adjustment_delete DELETE /deleteAdjustment deleteAdjustment
AdjustmentApi post_adjustment_post POST /postAdjustment postAdjustment
AllotmentBlocksApi create_allotment_block_notes_post POST /createAllotmentBlockNotes createAllotmentBlockNotes
AllotmentBlocksApi create_allotment_block_post POST /createAllotmentBlock createAllotmentBlock
AllotmentBlocksApi delete_allotment_block_post POST /deleteAllotmentBlock deleteAllotmentBlock
AllotmentBlocksApi get_allotment_blocks_get GET /getAllotmentBlocks getAllotmentBlocks
AllotmentBlocksApi list_allotment_block_notes_get GET /listAllotmentBlockNotes listAllotmentBlockNotes
AllotmentBlocksApi update_allotment_block_notes_post POST /updateAllotmentBlockNotes updateAllotmentBlockNotes
AllotmentBlocksApi update_allotment_block_post POST /updateAllotmentBlock updateAllotmentBlock
AppSettingsApi delete_app_property_settings_post POST /deleteAppPropertySettings deleteAppPropertySettings
AppSettingsApi get_app_property_settings_get GET /getAppPropertySettings getAppPropertySettings
AppSettingsApi post_app_property_settings_post POST /postAppPropertySettings postAppPropertySettings
AppSettingsApi put_app_property_settings_post POST /putAppPropertySettings putAppPropertySettings
AuthenticationApi access_token_post POST /access_token access_token
AuthenticationApi oauth_metadata_get GET /oauth/metadata metadata
AuthenticationApi userinfo_get GET /userinfo userinfo
CurrencyApi get_currency_settings_get GET /getCurrencySettings getCurrencySettings
CustomFieldsApi get_custom_fields_get GET /getCustomFields getCustomFields
CustomFieldsApi post_custom_field_post POST /postCustomField postCustomField
DashboardApi get_dashboard_get GET /getDashboard getDashboard
EmailsApi get_email_schedule_get GET /getEmailSchedule getEmailSchedule
EmailsApi get_email_templates_get GET /getEmailTemplates getEmailTemplates
EmailsApi post_email_schedule_post POST /postEmailSchedule postEmailSchedule
EmailsApi post_email_template_post POST /postEmailTemplate postEmailTemplate
GroupsApi get_group_notes_get GET /getGroupNotes getGroupNotes
GroupsApi get_groups_get GET /getGroups getGroups
GroupsApi patch_group_post POST /patchGroup patchGroup
GroupsApi post_group_note_post POST /postGroupNote postGroupNote
GroupsApi put_group_post POST /putGroup putGroup
GuestApi delete_guest_note_delete DELETE /deleteGuestNote deleteGuestNote
GuestApi get_guest_get GET /getGuest getGuest
GuestApi get_guest_list_get GET /getGuestList getGuestList
GuestApi get_guest_notes_get GET /getGuestNotes getGuestNotes
GuestApi get_guests_by_filter_get GET /getGuestsByFilter getGuestsByFilter
GuestApi get_guests_by_status_get GET /getGuestsByStatus getGuestsByStatus
GuestApi get_guests_modified_get GET /getGuestsModified getGuestsModified
GuestApi post_guest_document_post POST /postGuestDocument postGuestDocument
GuestApi post_guest_note_post POST /postGuestNote postGuestNote
GuestApi post_guest_photo_post POST /postGuestPhoto postGuestPhoto
GuestApi post_guest_post POST /postGuest postGuest
GuestApi post_guests_to_room_post POST /postGuestsToRoom postGuestsToRoom
GuestApi put_guest_note_put PUT /putGuestNote putGuestNote
GuestApi put_guest_put PUT /putGuest putGuest
HotelApi get_files_get GET /getFiles getFiles
HotelApi get_hotel_details_get GET /getHotelDetails getHotelDetails
HotelApi get_hotels_get GET /getHotels getHotels
HotelApi post_file_post POST /postFile postFile
HouseAccountApi get_house_account_list_get GET /getHouseAccountList getHouseAccountList
HouseAccountApi post_new_house_account_post POST /postNewHouseAccount postNewHouseAccount
HouseAccountApi put_house_account_status_put PUT /putHouseAccountStatus putHouseAccountStatus
HousekeepingApi get_housekeepers_get GET /getHousekeepers getHousekeepers
HousekeepingApi get_housekeeping_status_get GET /getHousekeepingStatus getHousekeepingStatus
HousekeepingApi post_housekeeper_post POST /postHousekeeper postHousekeeper
HousekeepingApi post_housekeeping_assignment_post POST /postHousekeepingAssignment postHousekeepingAssignment
HousekeepingApi post_housekeeping_status_post POST /postHousekeepingStatus postHousekeepingStatus
HousekeepingApi put_housekeeper_put PUT /putHousekeeper putHousekeeper
IntegrationApi delete_webhook_delete DELETE /deleteWebhook deleteWebhook
IntegrationApi get_app_settings_get GET /getAppSettings getAppSettings
IntegrationApi get_app_state_get GET /getAppState getAppState
IntegrationApi get_webhooks_get GET /getWebhooks getWebhooks
IntegrationApi post_app_error_post POST /postAppError postAppError
IntegrationApi post_app_state_post POST /postAppState postAppState
IntegrationApi post_government_receipt_post POST /postGovernmentReceipt postGovernmentReceipt
IntegrationApi post_webhook_post POST /postWebhook postWebhook
InvoicesApi get_invoice_get GET /getInvoice getInvoice
InvoicesApi patch_invoice_post POST /patchInvoice patchInvoice
ItemApi append_custom_item_post POST /appendCustomItem appendCustomItem
ItemApi get_item_categories_get GET /getItemCategories getItemCategories
ItemApi get_item_get GET /getItem getItem
ItemApi get_items_get GET /getItems getItems
ItemApi post_custom_item_post POST /postCustomItem postCustomItem
ItemApi post_item_category_post POST /postItemCategory postItemCategory
ItemApi post_item_post POST /postItem postItem
ItemApi post_items_to_inventory_post POST /postItemsToInventory postItemsToInventory
ItemApi post_void_item_post POST /postVoidItem postVoidItem
ItemApi put_item_to_inventory_put PUT /putItemToInventory putItemToInventory
PackageApi get_package_names_get GET /getPackageNames getPackageNames
PackageApi get_packages_get GET /getPackages getPackages
PaymentApi get_payment_methods_get GET /getPaymentMethods getPaymentMethods
PaymentApi get_payments_capabilities_get GET /getPaymentsCapabilities getPaymentsCapabilities
PaymentApi post_charge_post POST /postCharge postCharge
PaymentApi post_credit_card_post POST /postCreditCard postCreditCard
PaymentApi post_custom_payment_method_post POST /postCustomPaymentMethod postCustomPaymentMethod
PaymentApi post_payment_post POST /postPayment postPayment
PaymentApi post_void_payment_post POST /postVoidPayment postVoidPayment
RateApi get_rate_get GET /getRate getRate
RateApi get_rate_jobs_get GET /getRateJobs getRateJobs
RateApi get_rate_plans_get GET /getRatePlans getRatePlans
RateApi patch_rate_post POST /patchRate patchRate
RateApi put_rate_post POST /putRate putRate
ReservationApi delete_reservation_note_delete DELETE /deleteReservationNote deleteReservationNote
ReservationApi get_reservation_assignments_get GET /getReservationAssignments getReservationAssignments
ReservationApi get_reservation_get GET /getReservation getReservation
ReservationApi get_reservation_invoice_information_get GET /getReservationInvoiceInformation getReservationInvoiceInformation
ReservationApi get_reservation_notes_get GET /getReservationNotes getReservationNotes
ReservationApi get_reservations_get GET /getReservations getReservations
ReservationApi get_reservations_with_rate_details_get GET /getReservationsWithRateDetails getReservationsWithRateDetails
ReservationApi get_sources_get GET /getSources getSources
ReservationApi post_reservation_document_post POST /postReservationDocument postReservationDocument
ReservationApi post_reservation_note_post POST /postReservationNote postReservationNote
ReservationApi post_reservation_post POST /postReservation postReservation
ReservationApi put_reservation_note_put PUT /putReservationNote putReservationNote
ReservationApi put_reservation_put PUT /putReservation putReservation
RoomApi delete_room_block_delete DELETE /deleteRoomBlock deleteRoomBlock
RoomApi get_available_room_types_get GET /getAvailableRoomTypes getAvailableRoomTypes
RoomApi get_reservation_room_details_get GET /getReservationRoomDetails getReservationRoomDetails
RoomApi get_room_blocks_get GET /getRoomBlocks getRoomBlocks
RoomApi get_room_types_get GET /getRoomTypes getRoomTypes
RoomApi get_rooms_fees_and_taxes_get GET /getRoomsFeesAndTaxes getRoomsFeesAndTaxes
RoomApi get_rooms_get GET /getRooms getRooms
RoomApi get_rooms_unassigned_get GET /getRoomsUnassigned getRoomsUnassigned
RoomApi post_room_assign_post POST /postRoomAssign postRoomAssign
RoomApi post_room_block_post POST /postRoomBlock postRoomBlock
RoomApi post_room_check_in_post POST /postRoomCheckIn postRoomCheckIn
RoomApi post_room_check_out_post POST /postRoomCheckOut postRoomCheckOut
RoomApi put_room_block_put PUT /putRoomBlock putRoomBlock
TaxesAndFeesApi get_taxes_and_fees_get GET /getTaxesAndFees getTaxesAndFees
UserApi get_users_get GET /getUsers getUsers

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

api_key

  • Type: API key
  • API key parameter name: x-api-key
  • Location: HTTP header

OAuth2

  • Type: OAuth
  • Flow: accessCode
  • Authorization URL:
  • Scopes:
  • delete:adjustment: delete:adjustment
  • delete:appPropertySettings: delete:appPropertySettings
  • delete:roomblock: delete:roomblock
  • read:allotmentBlock: read:allotmentBlock
  • read:appPropertySettings: read:appPropertySettings
  • read:communication: read:communication
  • read:currency: read:currency
  • read:customFields: read:customFields
  • read:dashboard: read:dashboard
  • read:group: read:group
  • read:guest: read:guest
  • read:hotel: read:hotel
  • read:houseAccount: read:houseAccount
  • read:housekeeping: read:housekeeping
  • read:item: read:item
  • read:package: read:package
  • read:payment: read:payment
  • read:rate: read:rate
  • read:reservation: read:reservation
  • read:room: read:room
  • read:roomblock: read:roomblock
  • read:taxesAndFees: read:taxesAndFees
  • read:user: read:user
  • write:adjustment: write:adjustment
  • write:allotmentBlock: write:allotmentBlock
  • write:appError: write:appError
  • write:appPropertySettings: write:appPropertySettings
  • write:communication: write:communication
  • write:customFields: write:customFields
  • write:group: write:group
  • write:guest: write:guest
  • write:hotel: write:hotel
  • write:houseAccount: write:houseAccount
  • write:housekeeping: write:housekeeping
  • write:item: write:item
  • write:payment: write:payment
  • write:rate: write:rate
  • write:reservation: write:reservation
  • write:room: write:room
  • write:roomblock: write:roomblock

Author

Project links

Data verified by PyPI on Apr 17, 2025
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
  • Archived:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for artifacts from gravatar.com artifacts

Credits

Author: Cloudbeds

GitHub Statistics

Data verified by PyPI on Apr 17, 2025
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

Provenance

Data verified by PyPI on Apr 17, 2025
Data provided by the project maintainers and verified by PyPI at the time of upload.

Full provenance

Both files in this release have provenance metadata.

View provenance details

License

MIT License (The MIT License)

Requires

Python >=3.8

Provides Extra

testing

Classifiers

Metadata

Project links

Data verified by PyPI on Apr 17, 2025
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
  • Archived:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for artifacts from gravatar.com artifacts

Credits

Author: Cloudbeds

GitHub Statistics

Data verified by PyPI on Apr 17, 2025
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

Provenance

Data verified by PyPI on Apr 17, 2025
Data provided by the project maintainers and verified by PyPI at the time of upload.

Full provenance

Both files in this release have provenance metadata.

View provenance details

License

MIT License (The MIT License)

Requires

Python >=3.8

Provides Extra

testing

Classifiers

Release files for cloudbeds-pms-v1-2 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cloudbeds-pms-v1-2 1.3.0
File Size Uploaded Provenance Actions
cloudbeds_pms_v1_2-1.3.0.tar.gz 312.3 kB With provenance Details for cloudbeds_pms_v1_2-1.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cloudbeds-pms-v1-2 1.3.0
File Interpreter ABI Platform Actions
cloudbeds_pms_v1_2-1.3.0-py3-none-any.whl 1.5 MB With provenance Python 3 none any Details for cloudbeds_pms_v1_2-1.3.0-py3-none-any.whl

Total release size: 1.8 MB

Release files / cloudbeds_pms_v1_2-1.3.0.tar.gz

Download URL cloudbeds_pms_v1_2-1.3.0.tar.gz
Size 312.3 kB
Tags Source
SHA-256 checksum
How to use checksums 		5602e34b97a3781af945fa30e3e5e78f36c4df6db9213548bf6301a83eb0e686
BLAKE2b-256 checksum
How to use checksums 		ede253b242aee480897d43b73938ab7ba04686cb2cb4b1560019fd2d3d23b3ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 17, 2025.

Transparency log
Identity
Publishing platform
GitHub Actions
Publishing repository
github.com/cloudbeds/cloudbeds-api-python
Publishing commit
github.com/cloudbeds/cloudbeds-api-python/tree/a6c5e6fd8b84c7236158373d148714ac9188f8ce
Workflow
Publishing configuration
github.com/cloudbeds/cloudbeds-api-python/blob/a6c5e6fd8b84c7236158373d148714ac9188f8ce/.github/workflows/publish.yaml
Publishing logs
github.com/cloudbeds/cloudbeds-api-python/actions/runs/14514210637/attempts/1
Artifact
Subject
cloudbeds_pms_v1_2-1.3.0.tar.gz
SHA-256 checksum
5602e34b97a3781af945fa30e3e5e78f36c4df6db9213548bf6301a83eb0e686 Verifying attestations

Release files / cloudbeds_pms_v1_2-1.3.0-py3-none-any.whl

Download URL cloudbeds_pms_v1_2-1.3.0-py3-none-any.whl
Size 1.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums 		03fc7f5dfe69100e0d89d922417337f8fed51d04c928fc034d3256840b459ac2
BLAKE2b-256 checksum
How to use checksums 		534564d952870364fe52d5254d52789f82f2ad2cd828e0bad4b57913304de8af
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 17, 2025.

Transparency log
Identity
Publishing platform
GitHub Actions
Publishing repository
github.com/cloudbeds/cloudbeds-api-python
Publishing commit
github.com/cloudbeds/cloudbeds-api-python/tree/a6c5e6fd8b84c7236158373d148714ac9188f8ce
Workflow
Publishing configuration
github.com/cloudbeds/cloudbeds-api-python/blob/a6c5e6fd8b84c7236158373d148714ac9188f8ce/.github/workflows/publish.yaml
Publishing logs
github.com/cloudbeds/cloudbeds-api-python/actions/runs/14514210637/attempts/1
Artifact
Subject
cloudbeds_pms_v1_2-1.3.0-py3-none-any.whl
SHA-256 checksum
03fc7f5dfe69100e0d89d922417337f8fed51d04c928fc034d3256840b459ac2 Verifying attestations

Security for cloudbeds-pms-v1-2 1.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for cloudbeds_pms_v1_2-1.3.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 17, 2025.

Transparency log
Identity
Publishing platform
GitHub Actions
Publishing repository
github.com/cloudbeds/cloudbeds-api-python
Publishing commit
github.com/cloudbeds/cloudbeds-api-python/tree/a6c5e6fd8b84c7236158373d148714ac9188f8ce
Workflow
Publishing configuration
github.com/cloudbeds/cloudbeds-api-python/blob/a6c5e6fd8b84c7236158373d148714ac9188f8ce/.github/workflows/publish.yaml
Publishing logs
github.com/cloudbeds/cloudbeds-api-python/actions/runs/14514210637/attempts/1
Artifact
Subject
cloudbeds_pms_v1_2-1.3.0.tar.gz
SHA-256 checksum
5602e34b97a3781af945fa30e3e5e78f36c4df6db9213548bf6301a83eb0e686 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page