Conventions
- Base URL:
https://api.sorraia.app/v1 - Auth:
Authorization: Bearer sor_live_...(see Authentication) - Lists return
{ data, pagination }; single resources return the object directly. - Pagination:
page(1-based) andlimit(default 25, max 100). - Rate limits: 1000 requests/hour per key; read
X-RateLimit-*headers, back off on429.
Errors
Every error uses a consistent shape with a stable machine-readablecode:
invalid_api_key (401), plan_feature_gated (402: the
account’s plan has no API access, which is included on every paid plan),
plan_limit_reached (402: a plan limit, such as a site’s forms and calendars),
insufficient_scope (403), not_found (404), rate_limited (429), plus
request-specific codes like domain_required and forbidden_field (400).
Browse the endpoints in the sidebar, or start with the
getting-started guide.