Bible Ask

POST/v1/bible/ask10 credits

Ask any question and get a grounded, scripture-backed answer streamed as Server-Sent Events (SSE). The model retrieves relevant verses first, then synthesizes a cited answer.

See Streaming for full details on consuming SSE.

Request body

{
  "question": "What does the Bible say about forgiveness?",
  "theme": "forgiveness"
}

Field	Type	Required	Description
question	string	Yes	The question to ask (max 1000 chars)
theme	string	No	Scope retrieval to a biblical theme

Response (SSE stream)

The response is Content-Type: text/event-stream. Events arrive in this order:

Token events (one per word/piece)
A single citations event
[DONE]

data: {"token": "The"}

data: {"token": " Bible"}

data: {"token": " teaches"}

data: {"citations": [{"reference": "Ephesians 4:32", "text": "Be kind to one another, tenderhearted, forgiving one another, as God in Christ forgave you."}, {"reference": "Matthew 18:21-22", "text": "Then Peter came up and said to him, Lord, how often will my brother sin against me?"}]}

data: [DONE]

Example

curl -X POST https://platform.godfocus.io/v1/bible/ask \
  -H "Authorization: Bearer $GODFOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  --no-buffer \
  -d '{"question": "What does the Bible say about forgiveness?", "theme": "forgiveness"}'

Credits

10 credits are deducted when the stream begins (not when it completes). If you close the connection early, the credits are still consumed.