booking/index

GET /api/3.0/booking/index

Retrieve a listing of bookings in the system.

Query timestamps may be Date strings or unix timestamps, and can be prefixed with ‘<’ or ‘>’ to match before or after a date.

Query Parameters:
 
  • status_id (string) – The current status of a booking.
  • customer_id (integer) – The customer id associated with the booking.
  • customer_email (string) – The customer email associated with the booking.
  • start_date (string/timestamp) – The date the booking starts on (i.e. check-in).
  • end_date (string/timestamp) – The date the booking ends on (i.e. check-out).
  • last_modified (string/timestamp) – The date the booking was last changed. Useful for getting bookings added or changed since your last call.
  • limit (integer) – The limit of bookings to return per page (default: 100).
  • page (integer) – The page of results to return.
Response JSON Array of Objects:
 
  • booking_id (integer) – The internal index of a booking.
  • code (string) – The unique booking reference code.
  • status_id (string) – The status code of the booking.
  • status_name (string) – The display name of the booking status.
  • created_date (timestamp) – The date/time the booking was created.
  • total (float) – The full value of the booking.
  • tax_total (float) – The sum of the taxes applied to the booking.
  • paid_total (float) – The amount the customer has paid on the booking.
  • customer_name (string) – The full name of the booking contact.
  • customer_email (string) – The email address of the booking contact.
  • summary (string) – A brief description of the contents of the booking.
  • date_desc (string) – A string describing the booked dates/times.
  • token (string) – A customer token for the booking, can be used to build links to customer portions of the reservation system.
 
 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
{
    "version": "3.0",
    "account_id": 1,
    "host_id": "your-company.checkfront.com",
    "name": "Your Company",
    "locale": {
        "id": "en_US",
        "lang": "_en",
        "currency": "CAD"
    },
    "request": {
        "status": "OK",
        "resource": "booking",
        "id": "index",
        "method": "get",
        "records": 1,
        "total_records": 1,
        "limit": 100,
        "page": 1,
        "pages": 1,
        "time": 0.0003
    },
    "booking/index": {
        "3149": {
            "booking_id": 3149,
            "code": "PVCA-050314",
            "status_id": "PAID",
            "status_name": "Paid",
            "created_date": 1394079749,
            "total": "141.90",
            "tax_total": "12.90",
            "paid_total": "141.90",
            "customer_name": "Your Customer",
            "customer_email": "support@checkfront.com",
            "summary": "Islands Snorkeling Tour",
            "date_desc": "Wed Mar  5, 2014",
            "token": "57c2ac0a58dc02a72df50a8841b1c8a190627ff69a2435060a3ed3d469819477"
        }
    }
}