API Master Documentation

Reference for integrating with the platform API. When you use flat global API pricing only, the full catalog is shown here; if separate per-route pricing rows exist, only those routes are listed (Authentication stays visible).

Base URL: https://ai.craveva.com/api/v1 or /api/v1 (relative)

All API requests should be made to this base URL with the appropriate endpoint path. Most endpoints require authentication via API key or JWT token in the Authorization header.

API Test Console Available

Log in to test API endpoints directly from this page.

Loading published endpoints…

Authentication

Most endpoints require authentication using an API key or JWT token. Include your credentials in the Authorization header:Authorization: Bearer YOUR_API_KEY_OR_TOKEN

Rate Limits

Starter
1,000 requests/hour
1K/hr
Growth
10,000 requests/hour
10K/hr
Enterprise
Custom limits

Rate limit information is included in response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Error Handling

All errors follow a consistent format. Check the HTTP status code and error response body for details.

{
  "error": true,
  "message": "Human-readable error message",
  "code": "ERROR_CODE",
  "details": {
    "field": "Additional error details"
  }
}
INVALID_REQUEST400 - Request validation failed
UNAUTHORIZED401 - Authentication required
FORBIDDEN403 - Insufficient permissions
NOT_FOUND404 - Resource not found
RATE_LIMIT_EXCEEDED429 - Too many requests
Craveva AI — F&B Database Agent Platform