item

Your Checkfront inventory is made up of ‘items‘ that are added to bookings, and have complex availability controls and rules defining their stock and prices.

When no dates are passed in the API call, a full list of enabled items in the inventory is displayed, without specific availability and pricing.

However, if you pass in the relevant booking dates (and optionally parameters, discount codes, etc), the API will return a “rated” response that includes pricing and availablity, as well as a “SLIP” that will be used to add the item to a session.

SLIP

The item SLIP is an encoded string returned when making a rated query to a specific item. The slip contains the information needed to make a booking. Don’t attempt to reverse engineer this, as the format changes. It must be optioned via a rated API call.

Booking Parameters

Booking parameters are defined globally in your system, and can be configured on a per item basis. Your parameters specify the number of items to book, for example Child and Adult. These are completely configurable in your Checkfront account under Manage / Settings / Configure.

To query specific pricing and availability, you need to pass the appropriate parameters in your API call (using the parameter IDs as specified in your configuration).

Say for instance you have 2 parameters configured: Adults (id: adults), and Children (id: children). To get pricing for 2 adults and one child you would pass: param[adults]=2&param[children]=1 in your API call.

Booking parameters have many options, and can be configured to control inventory in very specific ways. See the Checkfront support centre or ask us for more information.

Request

GET /api/3.0/item

Retrieve a list of the enabled items in the system.

Query Parameters:
 
  • start_date (date) – (rated) Booking start date.
  • end_date (date) – (rated) Booking end date.
  • date (date) – (rated) Alias of start date (for same-day bookings).
  • start_time (date) – (rated) Start time (used in hourly bookings).
  • end_time (date) – (rated) End time (used in hourly bookings).
  • category_id (integer) – Filter items by category.
  • packages (boolean) – Show package options.
  • available (integer) – (rated) Filter to items with at least this many left in stock.
  • keyword (string) – Filter to items with a name containing this keyword.
  • item_id (string) – A comma-seperated list of items to filter to.
  • discount_code (string) – (rated) The discount code to apply to the price.
  • rules (string) – ‘soft’ will prevent triggering date based rule errors, or ‘off’ will disable rule checking.
  • param (array) – (rated) See Booking Parameters.
GET /api/3.0/item/{item_id}

Retrieve details for a single item. Shares same params as above for rated requests.

Parameters:
  • item_id (string) – The unique item_id of the item to query, as found in a response or your Checkfront panel.
GET /api/3.0/item/{item_id}/cal

Retrieve calendar availability for a single item.

Parameters:
  • item_id (string) – The unique item_id of the item to query.
Query Parameters:
 
  • start_date (date) – Availability range start date.
  • end_date (date) – Availability range start date.
GET /api/3.0/item/cal

Retrieve calendar availability for a set of items.

Query Parameters:
 
  • item_id (array|integer) – The unique item_id of the item to query, or an array of item IDs
  • category_id (integer) – A category of items to filter to.
  • start_date (date) – Availability range start date.
  • end_date (date) – Availability range start date.

Unrated Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
{
    "version": "3.0",
    "account_id": 1,
    "host_id": "your-company.checkfront.com",
    "name": "Your Company",
    "locale": {
        "id": "en_US",
        "lang": "_en",
        "currency": "CAD"
    },
    "request": {
        "id": "17",
        "resource": "item",
        "method": "get",
        "records": 0,
        "status": "OK",
        "limit": 0,
        "page": 1,
        "pages": 1,
        "time": 0.0011
    },
    "query": false,
    "item": {
        "unit": "N",
        "item_id": 17,
        "sku": "overwaterbun",
        "url": "",
        "lock": 1,
        "visibility": "*",
        "name": "Overwater Room",
        "pos": 0,
        "summary": "Nightly accommodation in one of our exclusive \"over-water\" bungalows.\r\n\r\nLocated over the turquoise waters of the Pearl of the Pacific and nicely decorated with wooden materials, each bungalow offers direct access to the lagoon and romantic views over Mount Otemanu.",
        "details": "The Signature overwater bungalow at the Checkfront Polynesian Resort offers the unique experience of a breathtaking glass floor, the largest on the island of Bora Bora.\r\n\r\nEntirely renovated in 2010-2011 and combining contemporary and Polynesian designs, the new look of the bungalows embraces the three core values of the resort: chic, cultured & discovery.\r\n\r\nThe 50m² (540sqft) overwater bungalow features :flat screen TV with video on demand and music channel, telephone, mini bar, air conditioning, Wifi, safety box, tea & coffee facilities, furnished terrace, sofa bed.",
        "unlimited": 0,
        "video": {
            "id": "http://youtu.be/x6qpO4bt4cY",
            "start": 0
        },
        "image": {
            "1": {
                "date": 1392784780,
                "title": "Outer Bungalow Interior View",
                "src": "17-1--1392784780",
                "src@2x": "17-1@2x--1392784780"
            },
            "2": {
                "date": 1392784781,
                "title": false,
                "src": "17-2--1392784781",
                "src@2x": "17-2@2x--1392784781"
            },
            "3": {
                "date": 1392784781,
                "title": false,
                "src": "17-3--1392784781",
                "src@2x": "17-3@2x--1392784781"
            },
            "4": {
                "date": 1392784781,
                "title": false,
                "src": "17-4--1392784781",
                "src@2x": "17-4@2x--1392784781"
            }
        },
        "category_id": 2,
        "rated": 1
    }
}

Rated Response

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
{
    "version": "3.0",
    "account_id": 1,
    "host_id": "your-company.checkfront.com",
    "name": "Your Company",
    "locale": {
        "id": "en_US",
        "lang": "_en",
        "currency": "CAD"
    },
    "request": {
        "start_date": "next month",
        "end_date": "next month  2days",
        "param": {
            "guests": "2"
        },
        "id": "17",
        "resource": "item",
        "method": "get",
        "records": 0,
        "status": "OK",
        "limit": 0,
        "page": 1,
        "pages": 1,
        "time": 0.0027
    },
    "query": {
        "start_date": "20140408",
        "discount_code": false,
        "giftcert_code": false,
        "end_date": "20140410",
        "exclude": false,
        "param": {
            "guests": 2
        },
        "local_end_date": "04/10/2014",
        "local_start_date": "04/08/2014"
    },
    "item": {
        "unit": "N",
        "item_id": 17,
        "sku": "overwaterbun",
        "url": "",
        "lock": 1,
        "visibility": "*",
        "name": "Overwater Room",
        "pos": 0,
        "summary": "Nightly accommodation in one of our exclusive \"over-water\" bungalows.\r\n\r\nLocated over the turquoise waters of the Pearl of the Pacific and nicely decorated with wooden materials, each bungalow offers direct access to the lagoon and romantic views over Mount Otemanu.",
        "details": "The Signature overwater bungalow at the Checkfront Polynesian Resort offers the unique experience of a breathtaking glass floor, the largest on the island of Bora Bora.\r\n\r\nEntirely renovated in 2010-2011 and combining contemporary and Polynesian designs, the new look of the bungalows embraces the three core values of the resort: chic, cultured & discovery.\r\n\r\nThe 50m² (540sqft) overwater bungalow features :flat screen TV with video on demand and music channel, telephone, mini bar, air conditioning, Wifi, safety box, tea & coffee facilities, furnished terrace, sofa bed.",
        "unlimited": 0,
        "video": {
            "id": "http://youtu.be/x6qpO4bt4cY",
            "start": 0
        },
        "image": {
            "1": {
                "date": 1392784780,
                "title": "Outer Bungalow Interior View",
                "src": "17-1--1392784780",
                "src@2x": "17-1@2x--1392784780"
            },
            "2": {
                "date": 1392784781,
                "title": false,
                "src": "17-2--1392784781",
                "src@2x": "17-2@2x--1392784781"
            },
            "3": {
                "date": 1392784781,
                "title": false,
                "src": "17-3--1392784781",
                "src@2x": "17-3@2x--1392784781"
            },
            "4": {
                "date": 1392784781,
                "title": false,
                "src": "17-4--1392784781",
                "src@2x": "17-4@2x--1392784781"
            }
        },
        "category_id": 2,
        "rated": 1,
        "param": {
            "guests": {
                "group": 0,
                "lock": "1",
                "price": 1,
                "lbl": "Guests",
                "def": 1,
                "req": 1,
                "hide": null,
                "range": 1,
                "qty": 2
            }
        },
        "times": null,
        "times_days": null,
        "rate": {
            "status": "AVAILABLE",
            "available": 4,
            "slip": "17.20140408X2-guests.2",
            "summary": {
                "title": "4 Available",
                "details": "<strong>Guests:</strong> 2 x  2 Nights  @  $190.00",
                "price": {
                    "total": "$760.00",
                    "title": "$190.00",
                    "unit": "per night",
                    "param": {
                        "guests": "$190.00"
                    }
                },
                "span_desc": null,
                "date": "Tue Apr  8 2014 - Wed Apr  9 2014"
            },
            "sub_total": "760.00",
            "event": [
                {
                    "guests": {
                        "amount": "190.00",
                        "days": 2
                    }
                }
            ],
            "end_date": "20140409",
            "start_date": "20140408",
            "dates": {
                "20140408": {
                    "status": "A",
                    "price": {
                        "guests": "190.00"
                    },
                    "dow": "2",
                    "stock": {
                        "T": 5,
                        "B": 1,
                        "A": 4
                    },
                    "rate": 0
                },
                "20140409": {
                    "status": "A",
                    "price": {
                        "guests": "190.00"
                    },
                    "dow": "3",
                    "stock": {
                        "T": 5,
                        "B": 1,
                        "A": 4
                    },
                    "rate": 0
                }
            }
        },
        "days": 2,
        "discount": null,
        "discount_id": null,
        "len": "0",
        "stock": 5,
        "gprice": "",
        "local_start_date": "04/08/2014",
        "local_end_date": "04/10/2014"
    }
}