Cicini Public API

Welcome. The Public API v1 is a read-only, API-key authenticated HTTP API for organization data. Use it to sync customers and appointments into your own tools (CRMs, analytics, back-office scripts).

Getting started

Base URL, first request, and response shape.

Authentication

Bearer keys (cic_test_ / cic_live_) and plan requirements.

Core resources

Customers and appointments (bookings) that ship today.

API reference

Interactive OpenAPI for every public v1 operation.

What you can build today

Resource	Method	Path	Notes
Customers	`GET`	`/api/public/v1/customers`	Active customers only; paginated
Appointments	`GET`	`/api/public/v1/appointments`	Active appointments; filters for status, customer, staff, date range

Machine-readable contract: OpenAPI (regenerate with pnpm docs:openapi in the monorepo).

Quick mental model

Create an API key in the Cicini dashboard (Professional+ plan — see Authentication).
Call public endpoints from a server with Authorization: Bearer ….
Page through results with limit / offset and pagination.hasMore.

Product truth (do not assume)

Topic	Truth
API surface	Only paths under `/api/public/v1/*` are integration-friendly
Write APIs	Not available on public v1 (no create/update/delete customers or appointments via API key)
Services / staff / gift cards / webhooks	Not public v1 endpoints yet
Dashboard session APIs	`/api/` used by the web app require NextAuth — not* for third-party integrations
Super-admin APIs	`/api/admin/*` — platform only
List prices (product)	Free $0 · Starter $ 19 · Professional $49 (`lib/pricing/plan-core.ts`)
API access on Free / Starter	`apiAccess: false`, `apiKeys: 0` — keys are a Professional+ feature

Where to read these docs

Surface	URL
Production	https://docs.cicini.com (this Mintlify site)
App landing	https://cicini.com/docs — points here
Local preview	`pnpm docs:dev` from the monorepo root (`developer-docs/`)

Get started

Core resources

Examples

Overview

Cicini Public API

Getting started

Authentication

Core resources

API reference

What you can build today

Quick mental model

Product truth (do not assume)

Where to read these docs

Next steps

​Cicini Public API

Getting started

Authentication

Core resources

API reference

​What you can build today

​Quick mental model

​Product truth (do not assume)

​Where to read these docs

​Next steps

Cicini Public API

What you can build today

Quick mental model

Product truth (do not assume)

Where to read these docs

Next steps