CLcloudbeds
Items

Get a list of custom items for a specific property.

get/item/v1/custom-items

Request

  • Base URL
    https://api.cloudbeds.com
  • URL
    https://api.cloudbeds.com/item/v1/custom-items
  • Auth
    OAuth 2
    Authorization code: https://api.cloudbeds.com/auth/oauth/authorize
    Token URL: https://api.cloudbeds.com/auth/oauth/token scopes: read:item

Query parameters

limitinteger

The maximum number of items to return in the response. Default is 100.

offsetinteger

The number of items to skip before starting to collect the result set. Used for pagination.

This parameter should be formatted as a list of strings separated by ; Use ; for a literal semicolon inside a value.

{
  "filters": {
    "and": [
      {
        "field": "checkin_date",
        "value": "2023-10-19T00:00:00"
      }
    ],
    "or": [
      {
        "field": "checkin_date",
        "value": "2023-10-19T00:00:00"
      }
    ]
  }
}

Headers

x-property-idstring required
Example:1,2,3

A numeric, comma-separated string representing the property IDs, sent in the header.

Response

List of custom items.

totalinteger required

Total number of items

Example response

{
  "data": [
    {
      "id": "123456",
      "name": "Coffee",
      "propertyId": "123456",
      "sourceId": "123456",
      "sourceName": "Restaurant POS",
      "appItemId": "ITEM-001",
      "sku": "SKU123",
      "categoryName": "Beverages",
      "description": "Fresh brewed coffee"
    }
  ],
  "total": 100
}

Changes

No recorded changes to this operation across all 1 revision of this API.