List customer bookings

Endpoints

GET List customers GET Get a customer GET List customer pets GET List customer bookings

GET /customers/{customerId}/bookings

Try it

Returns a paginated collection of bookings belonging to one customer.

The endpoint accepts the standard booking filter and pagination query parameters.

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

Example request

cURL

curl --request GET \
  --url "https://api.kennelbooker.com/api/v1/customers/165/bookings?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/customers/165/bookings?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/customers/165/bookings?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

Path parameter

The customer must belong to the business identified by the supplied API key.

Parameter	Type	Required	Description
`customerId`	`integer`	Required	The unique customer identifier.

The standard booking filters, pagination envelope and booking item fields are shown below this customer-specific path parameter.

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.