> ## Documentation Index
> Fetch the complete documentation index at: https://urantia.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart - Urantia Book API in 60 Seconds

> Make your first Urantia Book API call in under a minute. Search paragraphs, look up references, and access audio narration.

## Get a random paragraph

```bash theme={null}
curl https://api.urantia.dev/paragraphs/random
```

## Search the Urantia Papers

```bash theme={null}
curl -X POST https://api.urantia.dev/search \
  -H "Content-Type: application/json" \
  -d '{"q": "Universal Father", "limit": 5}'
```

Search modes: `and` (all words, default), `or` (any word), `phrase` (exact match).

## Look up a specific paragraph

The API accepts three reference formats — auto-detected from the string:

| Format                  | Example   | Structure                              |
| ----------------------- | --------- | -------------------------------------- |
| globalId                | `1:2.0.1` | `partId:paperId.sectionId.paragraphId` |
| standardReferenceId     | `2:0.1`   | `paperId:sectionId.paragraphId`        |
| paperSectionParagraphId | `2.0.1`   | `paperId.sectionId.paragraphId`        |

```bash theme={null}
curl https://api.urantia.dev/paragraphs/1:2.0.1
```

## Get a paragraph with surrounding context

```bash theme={null}
curl "https://api.urantia.dev/paragraphs/1:2.0.1/context?window=3"
```

Returns the target paragraph plus 3 paragraphs before and after it — useful for RAG and AI applications.

## Browse entities

The API includes 4,400+ entities (beings, places, orders, races, religions, concepts) sourced from [Urantiapedia](https://urantiapedia.org), a knowledge graph built by [Jan Herca](https://github.com/JanHerca).

```bash theme={null}
# List entities, optionally filter by type or search by name
curl "https://api.urantia.dev/entities?type=being&limit=5"
curl "https://api.urantia.dev/entities?q=adam"

# Get a single entity
curl https://api.urantia.dev/entities/adam-and-eve

# Get all paragraphs that mention an entity
curl https://api.urantia.dev/entities/adam-and-eve/paragraphs
```

You can also include entity mentions inline on any paragraph-returning endpoint with `?include=entities`:

```bash theme={null}
curl "https://api.urantia.dev/paragraphs/2:0.1?include=entities"
```

## Read a full paper

```bash theme={null}
curl https://api.urantia.dev/papers/1
```

Returns the paper metadata and all its paragraphs in order.