API Reference
Base URL: https://platform.godfocus.io/v1
All endpoints require the Authorization: Bearer gfp_live_... header unless noted.
Endpoints
| Endpoint | Method | Cost | Description |
|---|---|---|---|
| /v1/health | GET | Free | Auth check + credit balance |
| /v1/bible/search | POST | 1 credit | Keyword scripture search |
| /v1/bible/search-ai | POST | 3 credits | Semantic (AI-powered) search |
| /v1/bible/ask | POST | 10 credits | Grounded RAG answer (streaming) |
| /v1/billing/packs | GET | Free | List credit packs |
| /v1/billing/checkout | POST | Free | Create Stripe checkout session |
Versioning
The API is currently at version 1 (/v1). Breaking changes will be announced with a new version prefix. The current version will remain supported for at least 12 months after a new version launches.
Rate limits
All keys share a rate limit of 60 requests per minute. Exceeding this returns a 429 response. See Errors for retry guidance.
Content type
All POST request bodies must use Content-Type: application/json. All responses are JSON (except /v1/bible/ask which is text/event-stream).