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

# Urantia Parallels for a Work

> The 10 Urantia paragraphs closest in meaning to the chunk that holds this unit. The reference must name one unit.

**The Urantia parallels are semantic, not curated.** They show the paragraphs closest in meaning by embedding similarity. They do not claim that two teachings are the same.



## OpenAPI

````yaml GET /works/{work}/{ref}/urantia-parallels
openapi: 3.1.0
info:
  title: Urantia Papers API
  version: 1.0.0
  description: >-
    An API and MCP server for the Urantia Papers. Structured access to all 197
    papers and more than 14,500 paragraphs, with full-text and semantic search,
    named entities, cross-references to public domain texts of the world's
    religions, and audio. No key needed. Docs: https://docs.urantia.dev
  termsOfService: https://docs.urantia.dev/terms-of-service
  contact:
    name: urantia.dev
    url: https://docs.urantia.dev/help
    email: kelson@urantia.dev
  license:
    name: MIT
    url: https://github.com/urantia-hub/urantia-dev-api/blob/main/LICENSE
servers:
  - url: https://api.urantia.dev
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
paths:
  /works/{work}/{ref}/urantia-parallels:
    get:
      tags:
        - Works
      summary: Top 10 Urantia paragraphs for one unit of a work
      description: >-
        The 10 Urantia paragraphs closest in meaning to the chunk that holds
        this unit. The reference must name one unit.


        **The Urantia parallels are semantic, not curated.** They show the
        paragraphs closest in meaning by embedding similarity. They do not claim
        that two teachings are the same.
      operationId: getWorkUrantiaParallels
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 64
            description: >-
              "bible", or a work id such as "bhagavad-gita" (its ref prefix also
              works: "bg").
          required: true
          description: >-
            "bible", or a work id such as "bhagavad-gita" (its ref prefix also
            works: "bg").
          name: work
          in: path
        - schema:
            type: string
            minLength: 1
            maxLength: 40
            description: >-
              A unit (`John 3:16`, `2.47`, `Dhp 183`), a short range (`John
              3:16-18`, `2.47-49`), or a whole chapter (`John 3`, `2`).
          required: true
          description: >-
            A unit (`John 3:16`, `2.47`, `Dhp 183`), a short range (`John
            3:16-18`, `2.47-49`), or a whole chapter (`John 3`, `2`).
          name: ref
          in: path
          example: '2:5.1'
      responses:
        '200':
          description: The unit with its top 10 Urantia paragraphs
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      work:
                        type: object
                        properties:
                          id:
                            type: string
                          title:
                            type: string
                          tradition:
                            type: string
                        required:
                          - id
                          - title
                          - tradition
                      reference:
                        type: string
                        description: >-
                          "John 3:16", "Dhp 183", "BG 2.47-49" (a chunk in
                          semantic search).
                      text:
                        type: string
                      url:
                        type:
                          - string
                          - 'null'
                        description: The public page that holds the text, or null.
                      match:
                        type: string
                        enum:
                          - reference
                          - exact
                          - all
                          - near
                        description: 'Keyword search: how it matched.'
                      similarity:
                        type: number
                        description: 'Semantic search: cosine similarity.'
                      strength:
                        type: string
                        enum:
                          - strong
                          - related
                          - weak
                        description: >-
                          How close the result is: strong (most right answers
                          score this), related, or weak (likely off the topic).
                      urantiaParallels:
                        type: array
                        items:
                          type: object
                          properties:
                            standardReferenceId:
                              type: string
                            paperTitle:
                              type: string
                            sectionTitle:
                              type:
                                - string
                                - 'null'
                            text:
                              type: string
                            similarity:
                              type: number
                            rank:
                              type: integer
                          required:
                            - standardReferenceId
                            - paperTitle
                            - sectionTitle
                            - text
                            - similarity
                            - rank
                        description: >-
                          The nearest Urantia paragraphs (semantic parallels,
                          not curated ones).
                    required:
                      - work
                      - reference
                      - text
                      - url
                      - urantiaParallels
                required:
                  - data
              example:
                data:
                  work:
                    id: bible
                    title: The Bible (World English Bible)
                    tradition: Jewish and Christian
                  reference: John 3:16
                  text: >-
                    For God so loved the world, that he gave his only born Son,
                    that whoever believes in him should not perish, but have
                    eternal life.
                  url: https://ebible.org/eng-web/JHN03.htm#V16
                  urantiaParallels:
                    - standardReferenceId: '142:6.6'
                      paperTitle: The Passover at Jerusalem
                      sectionTitle: The Visit with Nicodemus
                      text: >-
                        Nicodemus replied: “But I do not understand — how can
                        that be?” Said Jesus: “Can it be that you are a teacher
                        in Israel and yet ignorant of all this? It becomes,
                        then, the duty of those who know about the realities of
                        the spirit to reveal these things to those who discern
                        only the manifestations of the material world. But will
                        you believe us if we tell you of the heavenly truths? Do
                        you have the courage, Nicodemus, to believe in one who
                        has descended from heaven, even the Son of Man?”
                      similarity: 0.699646
                      rank: 1
                    - standardReferenceId: '174:5.7'
                      paperTitle: Tuesday Morning in the Temple
                      sectionTitle: The Inquiring Greeks
                      text: >-
                        “He who believes this gospel, believes not merely in me
                        but in Him who sent me. When you look upon me, you see
                        not only the Son of Man but also Him who sent me. I am
                        the light of the world, and whosoever will believe my
                        teaching shall no longer abide in darkness. If you
                        gentiles will hear me, you shall receive the words of
                        life and shall enter forthwith into the joyous liberty
                        of the truth of sonship with God. If my fellow
                        countrymen, the Jews, choose to reject me and to refuse
                        my teachings, I will not sit in judgment on them, for I
                        came not to judge the world but to offer it salvation.
                        Nevertheless, they who reject me and refuse to receive
                        my teaching shall be brought to judgment in due season
                        by my Father and those whom he has appointed to sit in
                        judgment on such as reject the gift of mercy and the
                        truths of salvation. Remember, all of you, that I speak
                        not of myself, but that I have faithfully declared to
                        you that which the Father commanded I should reveal to
                        the children of men. And these words which the Father
                        directed me to speak to the world are words of divine
                        truth, everlasting mercy, and eternal life.
                      similarity: 0.689726
                      rank: 2
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
        '400':
          description: Invalid request
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
        '404':
          description: Work or reference not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
        '429':
          description: Too many requests
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
        '500':
          description: Internal server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
components:
  headers:
    X-RateLimit-Limit:
      description: The number of requests allowed in the current window.
      schema:
        type: integer
      example: 200
    X-RateLimit-Remaining:
      description: The number of requests left in the current window.
      schema:
        type: integer
      example: 199
    X-RateLimit-Reset:
      description: The time the window resets, in Unix seconds.
      schema:
        type: integer
      example: 1791152213
  schemas:
    ProblemDetails:
      type: object
      description: An RFC 9457 problem details object. Every error response uses it.
      properties:
        type:
          type: string
          format: uri
          description: A URI that names the error type.
        title:
          type: string
          description: The short name of the status.
        status:
          type: integer
          description: The HTTP status code.
        detail:
          type: string
          description: What went wrong in this request.
      required:
        - type
        - title
        - status
        - detail
      example:
        type: https://urantia.dev/errors/not-found
        title: Not Found
        status: 404
        detail: Paragraph not found

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.