Skip to main content

SDK examples

There is no official client library yet. The API is intentionally a thin REST surface designed to be called with any HTTP client.

curl

# List customers
curl https://app.kennels.app/api/v1/customers \
  -H "Authorization: Bearer kennel_pk_live_..."

# Search
curl "https://app.kennels.app/api/v1/customers?q=smith" \
  -H "Authorization: Bearer kennel_pk_live_..."

# Create a booking
curl -X POST https://app.kennels.app/api/v1/bookings \
  -H "Authorization: Bearer kennel_pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type":"boarding","facilityId":"...","customerId":"...","petId":"...","checkIn":"2026-06-01T10:00:00Z","checkout":"2026-06-05T10:00:00Z"}'

Node.js (fetch)

const BASE = 'https://app.kennels.app/api/v1';
const KEY = process.env.KENNEL_API_KEY;

async function api(path, init = {}) {
  const res = await fetch(BASE + path, {
    ...init,
    headers: {
      Authorization: 'Bearer ' + KEY,
      'Content-Type': 'application/json',
      ...(init.headers ?? {}),
    },
  });
  if (!res.ok) {
    throw new Error('Kennel API ' + res.status + ': ' + (await res.text()));
  }
  return res.json();
}

const me = await api('/me');
console.log(me.account.name);

Python (requests)

import os, requests

BASE = 'https://app.kennels.app/api/v1'
KEY = os.environ['KENNEL_API_KEY']

def api(path, **kw):
    h = kw.pop('headers', {})
    h['Authorization'] = 'Bearer ' + KEY
    h['Content-Type'] = 'application/json'
    r = requests.request(kw.pop('method', 'GET'), BASE + path, headers=h, **kw)
    r.raise_for_status()
    return r.json()

print(api('/me')['account']['name'])
print(len(api('/customers')['customers']))

Rate-limit handling

async function apiWithRetry(path, init, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const res = await fetch(BASE + path, {
      ...init,
      headers: { Authorization: 'Bearer ' + KEY, ...(init?.headers ?? {}) },
    });
    if (res.status !== 429) return res;
    const retryAfter = parseInt(res.headers.get('retry-after') ?? '5', 10);
    await new Promise((r) => setTimeout(r, retryAfter * 1000));
  }
  throw new Error('rate limit exhausted');
}

Fetch Public API · OpenAPI 3.1 spec at /api/v1/openapi.json