API reference — Florentin

Home · API reference

API reference

The full interactive reference (Scalar) is served inside your Florentin instance. Here are the essentials to get started.

Open API reference ↗To the quickstart

What you can rely on

The Florentin API consistently follows the same conventions: one REST API per provider domain under /api/v1, authentication via bearer token in the format 42|<secret>, scopes for read and write access, uniform responses as { data, meta } and errors as { error }. So every endpoint is predictable.

The full, always up-to-date reference with all endpoints and schemas is provided interactively (Scalar) inside your instance — generated directly from the live schemas, not maintained by hand.

Essentials

✓

Base URLhttps://<provider-subdomain>.florentin.ai/api/v1

✓

AuthBearer token in the format 42|<secret>.

✓

Scopesapi:read · api:write · api:admin.

✓

Responses{ data, meta }, errors as { error }.

✓

Idempotencyidempotency_key on billing mutations.

✓

Per domainOne REST API per provider domain.

Example

Authenticated request

florentin · api

curl https://acme.florentin.ai/api/v1/customers \
  -H "Authorization: Bearer 42|kP3f9c…"
← 200  { "data": [ … ], "meta": { "page": 1, "total": 128 } }

Reference

Open the live reference

01Provider API referenceAll provider endpoints (Scalar).↗02Customer API referenceAll customer endpoints (Scalar).↗

The live-generated Scalar reference with all endpoints and schemas lives in your Florentin instance; the links above point to the current docs on staging.florentin.ai.

Build your product. We'll handle the rest.

Accounts, billing, credits, portal, access — integrated. Stripe fully included.

Start free →