VMS Developer API

Include your API key in every request using either method:

# Header method (recommended)
X-API-Key: vms_your_api_key_here

# Bearer token method
Authorization: Bearer vms_your_api_key_here

Retrieve a single verse by its slug (e.g., john-3-16). Returns the KJV original text, AI translation(s), historical context, and metadata.

Query Parameters:

style=faithful   # Default — precision AI translation
style=casual     # TikTok-native conversational translation
style=all        # Both styles in one response

Example Request:

curl -H "X-API-Key: vms_your_key" \
  "https://versemadesimple.com/api/v1/verse/john-3-16?style=all"

Example Response:

{
  "reference": "John 3:16",
  "slug": "john-3-16",
  "kjv_text": "For God so loved the world, that he gave...",
  "faithful": {
    "simplified_text": "For God loved the world so much...",
    "bottom_line": "God's love is unconditional and sacrificial.",
    "historical_context": "Written by the Apostle John...",
    "practical_reflection": "..."
  },
  "casual": {
    "simplified_text": "God was so down for humanity...",
    "bottom_line": "If you trust him, you're just getting started.",
    "available": true
  },
  "available_styles": { "faithful": true, "casual": true },
  "attribution": {
    "source": "Verse Made Simple",
    "url": "https://versemadesimple.com/john/3/16",
    "license": "Proprietary — active API subscription required"
  }
}

Create a new API key. Requires Supabase authentication via Bearer token. The full key is returned only once — store it securely.

curl -X POST \
  -H "Authorization: Bearer YOUR_SUPABASE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My App"}' \
  "https://versemadesimple.com/api/v1/keys"

# Response:
{
  "id": "uuid...",
  "name": "My App",
  "key": "vms_abc123...",  // ⚠️ Only shown ONCE
  "prefix": "vms_abc1...",
  "tier": "free",
  "rate_limit_monthly": 500
}

Get usage statistics for the current billing period. Requires Supabase authentication.

# Returns: total queries, breakdown by endpoint and style,
# per-key usage with tier limits