API Documentation

Overview

The Barnabas AI API provides simple REST endpoints for submitting prayer requests and receiving AI-generated guidance. The API is designed for easy integration with any church website or application.

Authentication

All API requests require authentication using your church's API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY_HERE

API Endpoints

{
  "name": "John Smith",
  "category": "health",
  "request": "Please pray for my mother's healing",
  "privacy": "private"
}

{
  "success": true,
  "requestId": "pr_2025_123456",
  "message": "Prayer request received"
}

{
  "requestId": "pr_2025_123456",
  "category": "health"
}

{
  "success": true,
  "guidance": {
    "response": "Prayer guidance text...",
    "scriptures": ["Psalm 147:3", "James 5:15"],
    "prayerPoints": ["Point 1", "Point 2", "Point 3"]
  }
}

{
  "status": "healthy",
  "timestamp": "2025-11-27T12:00:00Z"
}

Rate Limits

API rate limits vary by subscription tier:

All API responses include rate limit headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1732712400

Error Handling

The API uses standard HTTP response codes:

Error Response Format

{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "Missing required field: request"
  }
}

Support

For API support and questions:

• Email: api@barnabasai.com
• Documentation: https://barnabasai.com/api-docs
• Contact form: https://barnabasai.com/contact