Skip to main content

​
API Overview

​
Authentication

The Lighthouse API uses Bearer token authentication via Supabase Auth. Include your token in every request: 
curl -H "Authorization: Bearer <token>" \
  https://api.lighthousefh.com/v1/cases

​
Response Format

All successful responses are wrapped in an ApiResponse envelope: 
{
  "status": "success",
  "data": { ... },
  "message": null,
  "timestamp": "2024-01-15T10:30:00Z",
  "request_id": null
}

​
Error Format

Errors return an ApiError object: 
{
  "status": "error",
  "error": "Not Found",
  "message": "The requested resource was not found",
  "status_code": 404,
  "timestamp": "2024-01-15T10:30:00Z",
  "request_id": null
}

​
Common Status Codes

CodeMeaning
200Success
201Created
204No Content (successful delete)
400Bad Request (validation error)
401Unauthorized (missing or invalid token)
403Forbidden (insufficient permissions)
404Not Found
409Conflict (resource already being processed)
500Internal Server Error

​
Rate Limiting

There are currently no rate limits enforced. This may change in future versions.