List bookings

Endpoints

GET List bookings GET Get booking by ID GET Get booking by reference

GET /bookings

Try it

Returns a paginated collection of bookings available to the authenticated KennelBooker business.

Filter the collection with the optional request.* query parameters documented below.

Send the business API key in the X-Api-Key header.

Example request

cURL

curl --request GET \
  --url "https://api.kennelbooker.com/api/v1/bookings?request.status=new&request.bookingType=boarding&request.page=1&request.pageSize=25" \
  --header "X-Api-Key: kb_live_your_api_key" \
  --header "Accept: application/json"

using System.Net.Http;
using System.Net.Http.Headers;

using (var client = new HttpClient())
{
    client.DefaultRequestHeaders.Add(
        "X-Api-Key",
        "kb_live_your_api_key");

    client.DefaultRequestHeaders.Accept.Add(
        new MediaTypeWithQualityHeaderValue("application/json"));

    HttpResponseMessage response = await client.GetAsync(
        "https://api.kennelbooker.com/api/v1/bookings?request.status=new&request.bookingType=boarding&request.page=1&request.pageSize=25");

    response.EnsureSuccessStatusCode();
    string json = await response.Content.ReadAsStringAsync();
}

JavaScript

const response = await fetch("https://api.kennelbooker.com/api/v1/bookings?request.status=new&request.bookingType=boarding&request.page=1&request.pageSize=25", {
  method: "GET",
  headers: {
    "X-Api-Key": "kb_live_your_api_key",
    "Accept": "application/json"
  }
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

const result = await response.json();

Request contract

Booking query parameters

Every query parameter is optional. Parameter names include the request. prefix used by the API model binder.

Query parameter	Request property	Type	Example	Description
`request.from`	`From`	`date-time`	`2026-05-01T00:00:00Z`	The lower boundary of the requested booking date range.
`request.to`	`To`	`date-time`	`2026-05-31T23:59:59Z`	The upper boundary of the requested booking date range.
`request.bookingType`	`BookingType`	`string`	`boarding`	Filters results by booking type.
`request.status`	`Status`	`string`	`new`	Filters results by booking status.
`request.customerId`	`CustomerId`	`integer`	`165`	Returns bookings belonging to one customer.
`request.serviceId`	`ServiceId`	`integer`	`1`	Returns bookings associated with one service.
`request.search`	`Search`	`string`	`KB000229`	Applies the endpoint's free-text booking search.
`request.page`	`Page`	`integer`	`1`	The one-based page number. Defaults to 1.
`request.pageSize`	`PageSize`	`integer`	`25`	The requested number of records per page. Defaults to 25.

Response envelope

Property	Type	Example	Description
`page`	`integer`	`1`	The one-based page returned.
`pageSize`	`integer`	`5`	The page size applied to the request.
`totalRecords`	`integer`	`151`	The total number of bookings matching the filters.
`totalPages`	`integer`	`31`	The number of available pages for the applied page size.
`items`	`array`	`[...]`	The booking records returned for the current page.

Booking item items[]

Property	Type	Example	Description
`bookingId`	`integer`	`229`	The booking identifier.
`bookingType`	`string`	`boarding`	The booking type.
`reference`	`string`	`1-WTKB000229`	The booking reference.
`status`	`string`	`new`	The current booking status.
`customerId`	`integer`	`165`	The related customer identifier.
`customerName`	`string`	`Example Customer`	The customer name returned for the booking.
`petNames`	`string`	`Poppy`	The pet names returned for the booking.
`numberOfPets`	`integer`	`1`	The number of pets attached to the booking.
`serviceId`	`integer`	`1`	The related service identifier.
`checkInDate`	`date-time`	`2026-05-07T00:00:00Z`	The booking check-in date and time in UTC.
`checkOutDate`	`date-time`	`2026-05-08T00:00:00Z`	The booking check-out date and time in UTC.
`bookingPaid`	`boolean`	`false`	Indicates whether the booking is marked as paid.
`hasPayment`	`boolean`	`false`	Indicates whether the booking has an associated payment.

Responses

200

OK application/json

Response body

{
  "page": 1,
  "pageSize": 5,
  "totalRecords": 151,
  "totalPages": 31,
  "items": [
    {
      "bookingId": 229,
      "bookingType": "boarding",
      "reference": "WTKB000229",
      "status": "new",
      "customerId": 165,
      "customerName": "Example Customer",
      "petNames": "Poppy",
      "numberOfPets": 1,
      "serviceId": 1,
      "checkInDate": "2026-05-07T00:00:00Z",
      "checkOutDate": "2026-05-08T00:00:00Z",
      "bookingPaid": false,
      "hasPayment": false
    }
  ]
}

401

Missing or invalid API key application/json

The successful example is shortened to one booking item. The pagination totals describe the full matching collection.