Skip to main content

Documentation Index

Fetch the complete documentation index at: https://urantia.dev/llms.txt

Use this file to discover all available pages before exploring further.

The API includes a catalog of 4,400+ named entities extracted from the Urantiapedia knowledge graph, built by Jan Herca. Each entity is classified by type and linked to every paragraph where it appears.

​
Entity types

TypeDescriptionExamples
beingNamed individuals and personalitiesAdam and Eve, Michael of Nebadon, Machiventa Melchizedek
placeLocations and geographic regionsJerusem, Havona, Garden of Eden
orderOrders and classes of beingsSeraphim, Midwayers, Thought Adjusters
raceRaces and peoplesAndites, Nodites, Sangik races
religionReligious traditions and movementsChristianity, Buddhism, Salem teachings
conceptIdeas, doctrines, and abstract topicsMorontia, Supreme Being, personality survival

​
Entity shape

{
  "id": "adam-and-eve",
  "name": "Adam and Eve",
  "type": "being",
  "aliases": ["Material Son and Daughter", "Adam", "Eve"],
  "description": "The Material Son and Daughter who came to Urantia as biologic uplifters...",
  "seeAlso": ["garden-of-eden", "default-of-adam-and-eve"],
  "citationCount": 42
}
FieldDescription
idURL-friendly slug, used as the entity identifier
nameDisplay name
typeOne of: being, place, order, race, religion, concept
aliasesAlternative names (nullable)
descriptionBrief description from Urantiapedia (nullable)
seeAlsoRelated entity IDs (nullable)
citationCountNumber of paragraphs that mention this entity

​
Browsing entities

# List all entities (paginated)
curl "https://api.urantia.dev/entities?limit=20"

# Filter by type
curl "https://api.urantia.dev/entities?type=being&limit=10"

# Search by name
curl "https://api.urantia.dev/entities?q=melchizedek"

# Combine filters
curl "https://api.urantia.dev/entities?type=place&q=eden"

​
Getting a single entity

curl https://api.urantia.dev/entities/adam-and-eve
Returns 404 if the entity ID doesn’t exist.

​
Finding paragraphs for an entity

curl "https://api.urantia.dev/entities/adam-and-eve/paragraphs?limit=5"
Returns a paginated list of paragraphs that mention the entity, ordered by position in the text.

​
Translated entities

All 4,456 entities are available in 5 languages: Spanish, French, Portuguese, German, and Korean. Pass ?lang= to get translated names, descriptions, and aliases. 
# Get an entity in Spanish
curl "https://api.urantia.dev/entities/machiventa-melchizedek?lang=es"

# List beings in French
curl "https://api.urantia.dev/entities?type=being&lang=fr&limit=10"

# Search entities in German
curl "https://api.urantia.dev/entities?q=melchizedek&lang=de"
The response includes a language field indicating which language was returned: 
{
  "data": {
    "id": "machiventa-melchizedek",
    "name": "Machiventa Melchizedek",
    "type": "being",
    "description": "Un Hijo Melchizedek que se encarnó como otorgamiento de emergencia en Urantia...",
    "language": "es",
    "citationCount": 55
  }
}
If a translation isn’t available for the requested language, the API falls back to English and returns "language": "eng". Supported languages: eng (default), es, fr, pt, de, ko To see translation progress across all languages, use the /languages endpoint: 
curl https://api.urantia.dev/languages

​
Inline entities on paragraphs

You can also include entity mentions directly on paragraph responses using ?include=entities: 
curl "https://api.urantia.dev/paragraphs/74:1.1?include=entities"
This adds an entities array to each paragraph with the id, name, and type of every entity mentioned: 
{
  "data": {
    "id": "2:74.1.1",
    "text": "Adam and Eve arrived on Urantia...",
    "entities": [
      { "id": "adam-and-eve", "name": "Adam and Eve", "type": "being" },
      { "id": "urantia", "name": "Urantia", "type": "place" }
    ]
  }
}
Works on all paragraph-returning endpoints: /paragraphs/*, /papers/:id, /search, and /search/semantic. For search endpoints, pass "include": "entities" in the request body.