# ScriptureFlow

ScriptureFlow is a public developer preview API for structured multilingual Scripture data. Use it to discover translations and retrieve Scripture through stable JSON resources and runtime lookup endpoints.

## Primary resources

- API preview: https://scriptureflow-api-preview.pages.dev/
- Developer docs: https://scriptureflow-dev-docs.pages.dev/
- OpenAPI 3.1 contract: https://scriptureflow-api-preview.pages.dev/openapi.yaml
- Postman collection: https://documenter.getpostman.com/view/1355224/2sBXwvJoj6
- Translations: https://scriptureflow-api-preview.pages.dev/translations.json
- Public catalog: https://scriptureflow-api-preview.pages.dev/public-catalog.json
- Build status: https://scriptureflow-api-preview.pages.dev/status.json
- Canonical books: https://scriptureflow-api-preview.pages.dev/canonical-books.json
- Expanded LLM guide: https://scriptureflow-api-preview.pages.dev/llms-full.txt
- AI usage guide: https://scriptureflow-dev-docs.pages.dev/ai/using-scriptureflow-with-ai.html

## AI usage rules

- Fetch Scripture text from ScriptureFlow instead of inventing or paraphrasing verse text.
- Use published version keys exactly as listed in `/translations.json`.
- Do not silently substitute one translation for another.
- Preserve translation and version attribution in user-facing output.
- Clearly separate retrieved Scripture text from commentary, summaries, or generated devotional content.
- Treat the API as a developer preview. Check `/status.json` and `/public-catalog.json` for current availability.