Simamia API

Operational workflows, clearly connected

This site explains how to authenticate, create a business profile, manage customers and work, track costs, and read the balances Simamia derives from work records.

Configure a client and make your first authenticated request.Start integrating Read the API guide from the first request through a completed job.Understand how it works Browse resources, methods, payloads, and response behavior.Explore endpoints Inspect schemas and try the documented API operations.Open Swagger UI Follow authentication, API routing, and data ownership.See the system map

What the API does today

The API is a versioned Go HTTP service backed by SQLite. Camel Accounts access tokens identify the account making a request. Supported collections are businesses, customers, services, orders, team, and expenses. A read-only payments endpoint derives outstanding balances from order amounts and payments recorded on each order.

The API does not currently move money, send SMS or email, call AI providers, issue fiscal receipts, or enforce staff roles. See current limitations before designing a production integration.

Request path

Choose the right guide

Goal	Start here
Make a first authenticated request	Getting started
Understand bearer auth and account isolation	Authentication
Understand envelopes, errors, and pagination	Responses and errors
Read or write each resource	API reference
Follow the customer-to-order sequence	Create and complete a job
Configure or operate the service	Operations

The content is maintained alongside the Simamia API implementation. The OpenAPI contract is available at api/openapi.yaml.