API
REST API
Base URL, Bearer auth, scopes, idempotency, pagination, and resource list.
Base URLhttps://api.orkestr.in/v1
AuthAuthorization: Bearer ork_<prefix>.<secret>
Scopesread | write | admin
First call
curl https://api.orkestr.in/v1/api/me \
-H "Authorization: Bearer ork_a1b2c3d4.deadbeefdeadbeef…"Resource list
| Method | Path | Scope | Notes |
|---|---|---|---|
| GET | /api/me | read | Tenant + scopes for the calling key |
| GET | /api/offerings | read | List published offerings |
| POST | /api/offerings | write | Create an offering |
| PATCH | /api/offerings/:id | write | Edit |
| DELETE | /api/offerings/:id | write | Soft-delete (recoverable from /admin/trash) |
| GET | /api/bookings | read | List + filter bookings |
| POST | /api/bookings | write | Create a booking on behalf of a customer |
| POST | /api/bookings/:id/refund | write | Issue refund |
| GET | /api/coupons | read | List coupons |
| POST | /api/coupons | write | Create coupon |
| GET | /api/availability | read | Resolved slot grid for an offering |
Idempotency
POST /api/bookings and POST /api/bookings/:id/refund accept Idempotency-Key. Replays return the cached response; body diffs return 409. Lock + release semantics built in.
See /docs/developer/reference for the full endpoint catalog
Every endpoint with code samples in curl, JavaScript (fetch), and Python (requests).