Getting started
Comfort Oak’s API is the source of truth for catalog, CMS, commerce, leads, and ops.
Everything lives under versioned JSON at /api/v1.
Interactive reference:
Use the OpenAPI explorer to try endpoints live.
The machine-readable spec is at
/docs/api.json.
Base URL
https://api.comfortoak.com/api/v1
First requests
-
Check health
GET /api/v1/health— confirms the API process is up. -
Load bootstrap
GET /api/v1/bootstrap— menus, announcement bar, and public settings. -
Fetch catalog
GET /api/v1/sofasorGET /api/v1/productsfor storefront data. - Authenticate when needed Customer and staff tokens are separate — see the auth guide.
Response shape
Successful JSON payloads typically wrap content in a data key. Validation errors return 422 with an errors map.
{
"data": {
"ok": true,
"app": "Comfort Oak",
"time": "2026-08-12T10:00:00+00:00"
}
}