# ScriptureFlow cURL examples

No API key is required during public preview. These commands use `--fail-with-body` so HTTP failures remain visible and return a non-zero exit code.

## List translations

Discover exact, case-sensitive version keys instead of guessing or silently substituting translations. Some translations may be partial.

```bash
curl --fail-with-body --silent --show-error \
  "https://scriptureflow-api-preview.pages.dev/translations.json"
```

## Get John 3:16

```bash
curl --fail-with-body --silent --show-error \
  "https://scriptureflow-api-preview.pages.dev/api/verse?version=en-kjv&reference=John%203%3A16"
```

## Get Amos 8:4–6

```bash
curl --fail-with-body --silent --show-error \
  "https://scriptureflow-api-preview.pages.dev/api/verse?version=en-kjv&book=Amos&chapter=8&verse=4&end_verse=6"
```

## Get Quick Verse

Quick Verse is selected at request time and may differ between runs.

```bash
curl --fail-with-body --silent --show-error \
  "https://scriptureflow-api-preview.pages.dev/api/quick-verse?version=en-kjv"
```

## Get generated Verse of the Day

```bash
curl --fail-with-body --silent --show-error \
  "https://scriptureflow-api-preview.pages.dev/en-kjv/random.json"
```

Preserve the returned version and reference attribution. Keep generated commentary separate from Scripture text, and never invent missing verse text.