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