API Reference

Complete reference for all SoapBox API endpoints.

Base URL

https://api.soapboxsuperapp.com/api/v1

Common Parameters

Example: List Churches

Request

curl https://api.soapboxsuperapp.com/api/v1/churches \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": [
    {
      "id": 1,
      "name": "First Baptist Church",
      "description": "A welcoming community...",
      "city": "Dallas",
      "state": "TX",
      "country": "USA",
      "website": "https://firstbaptist.org",
      "memberCount": 1500,
      "createdAt": "2024-01-15T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "hasMore": true
  }
}

Example: Create Prayer Request

Request

curl -X POST https://api.soapboxsuperapp.com/api/v1/prayers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "communityId": 123,
    "content": "Please pray for my family during this difficult time.",
    "isAnonymous": false
  }'

Response

{
  "data": {
    "id": 456,
    "communityId": 123,
    "userId": 789,
    "content": "Please pray for my family during this difficult time.",
    "isAnonymous": false,
    "isAnswered": false,
    "prayerCount": 0,
    "createdAt": "2024-03-10T15:30:00Z"
  }
}

Error Handling

All errors follow a consistent format:

{
  "error": "NotFound",
  "message": "Church with ID 999 not found",
  "statusCode": 404
}