Skip to main content

Base URL

https://api.crovver.com
For self-hosted instances, replace with your own URL.

Authentication

All endpoints require one of three credentials. See Authentication for details.
# Public key (browser/SDK)
x-public-key: pk_live_...

# Secret key (backend)
Authorization: Bearer sk_live_...

# Service key (internal)
x-service-key: <value>

Response Format

All responses follow this envelope:
{
  "success": true,
  "data": { ... },
  "error": null,
  "meta": { ... }
}

Error Response

{
  "success": false,
  "data": null,
  "error": {
    "message": "Human-readable error message",
    "code": "ERROR_CODE"
  }
}

Common Error Codes

CodeHTTPDescription
MISSING_PUBLIC_KEY400publicKey query param not provided
INVALID_PUBLIC_KEY401Public key not found or inactive
INVALID_SERVICE_KEY401Service key mismatch
TENANT_NOT_FOUND404No tenant with the given external ID
NO_ACTIVE_SUBSCRIPTION404Tenant has no active subscription
MISSING_REQUIRED_FIELDS400Required body/query params missing