Skip to main content

​
Get a random paragraph

curl https://api.urantia.dev/paragraphs/random

​
Search the Urantia Papers

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:
FormatExampleStructure
globalId1:2.0.1partId:paperId.sectionId.paragraphId
standardReferenceId2:0.1paperId:sectionId.paragraphId
paperSectionParagraphId2.0.1paperId.sectionId.paragraphId
curl https://api.urantia.dev/paragraphs/1:2.0.1

​
Get a paragraph with surrounding context

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, a knowledge graph built by Jan Herca. 
# 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: 
curl "https://api.urantia.dev/paragraphs/2:0.1?include=entities"

​
Read a full paper

curl https://api.urantia.dev/papers/1
Returns the paper metadata and all its paragraphs in order.