> ## 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.

# Get UB Paragraphs for a Scripture Passage

> Returns the 10 Urantia paragraphs closest in meaning to the chunk that holds this passage. A chunk is a group of passages of about one Urantia paragraph in length. Pre-computed with `text-embedding-3-large` (3072-d) cosine similarity. The ref must name one passage.

**These are semantic parallels, not curated ones.** They show the passages closest in meaning by embedding similarity. They do not claim that two teachings are the same.



## OpenAPI

````yaml GET /scriptures/{corpus}/{ref}/urantia-parallels
openapi: 3.1.0
info:
  title: Urantia Papers API
  version: 1.0.0
  description: >-
    A developer and AI-agent friendly API for the Urantia Papers. Provides
    full-text search, structured content access, and audio URLs for all 17,000+
    paragraphs across 197 papers.
servers:
  - url: https://api.urantia.dev
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
paths:
  /scriptures/{corpus}/{ref}/urantia-parallels:
    get:
      tags:
        - Scriptures
      summary: Top 10 Urantia paragraphs for a scripture passage
      description: >-
        Returns the 10 Urantia paragraphs closest in meaning to the chunk that
        holds this passage. A chunk is a group of passages of about one Urantia
        paragraph in length. Pre-computed with `text-embedding-3-large` (3072-d)
        cosine similarity. The ref must name one passage.


        **These are semantic parallels, not curated ones.** They show the
        passages closest in meaning by embedding similarity. They do not claim
        that two teachings are the same.
      operationId: getScriptureUrantiaParallels
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 64
            description: >-
              Corpus id, slug, or ref prefix, e.g. `bhagavad-gita`, `bg`, or
              `dhammapada`
          required: true
          description: >-
            Corpus id, slug, or ref prefix, e.g. `bhagavad-gita`, `bg`, or
            `dhammapada`
          name: corpus
          in: path
        - schema:
            type: string
            minLength: 1
            maxLength: 32
            description: >-
              A passage (`2.47`, `BG 2.47`, `Dhp 183`, `Epictetus 3.22.5`), a
              short range (`2.47-49`), or a whole chapter (`2`)
          required: true
          description: >-
            A passage (`2.47`, `BG 2.47`, `Dhp 183`, `Epictetus 3.22.5`), a
            short range (`2.47-49`), or a whole chapter (`2`)
          name: ref
          in: path
          example: '2:5.1'
      responses:
        '200':
          description: The passage with its top 10 Urantia paragraphs
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      corpus:
                        type: object
                        properties:
                          id:
                            type: string
                          slug:
                            type: string
                          religion:
                            type: string
                          title:
                            type: string
                          translator:
                            type: string
                          year:
                            type: integer
                          refPrefix:
                            type: string
                          urantiaSection:
                            type:
                              - string
                              - 'null'
                            description: >-
                              The Paper 131 section headed with this religion,
                              or null when Paper 131 has no such heading
                        required:
                          - id
                          - slug
                          - religion
                          - title
                          - translator
                          - year
                          - refPrefix
                          - urantiaSection
                      passage:
                        type: object
                        properties:
                          id:
                            type: string
                          ref:
                            type: string
                          division:
                            type: integer
                          divisionTitle:
                            type:
                              - string
                              - 'null'
                          subdivision:
                            type:
                              - integer
                              - 'null'
                          text:
                            type: string
                        required:
                          - id
                          - ref
                          - division
                          - divisionTitle
                          - subdivision
                          - text
                      chunk:
                        type: object
                        properties:
                          id:
                            type: string
                          reference:
                            type: string
                          text:
                            type: string
                        required:
                          - id
                          - reference
                          - text
                      urantiaParallels:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            standardReferenceId:
                              type: string
                            paperId:
                              type: string
                            paperTitle:
                              type: string
                            sectionTitle:
                              type:
                                - string
                                - 'null'
                            text:
                              type: string
                            similarity:
                              type: number
                            rank:
                              type: integer
                          required:
                            - id
                            - standardReferenceId
                            - paperId
                            - paperTitle
                            - sectionTitle
                            - text
                            - similarity
                            - rank
                    required:
                      - corpus
                      - passage
                      - chunk
                      - urantiaParallels
                required:
                  - data
              example:
                data:
                  corpus:
                    id: bhagavad-gita-besant-1922
                    slug: bhagavad-gita
                    religion: Hinduism
                    title: The Bhagavad Gita
                    translator: Annie Besant (4th edition)
                    year: 1922
                    refPrefix: BG
                    urantiaSection: '131:4'
                  passage:
                    id: bhagavad-gita-besant-1922:BG 2.47
                    ref: BG 2.47
                    division: 2
                    divisionTitle: null
                    subdivision: null
                    text: >-
                      Thy business is with the action only, never with its
                      fruits; so let not the fruit of action be thy motive, nor
                      be thou to inaction attached.
                  chunk:
                    id: bhagavad-gita-besant-1922:BG 2.47
                    reference: BG 2.47-49
                    text: >-
                      Thy business is with the action only, never with its
                      fruits; so let not the fruit of action be thy motive, nor
                      be thou to inaction attached. Perform action, O
                      Dhananjaya, dwelling in union with the divine, renouncing
                      attachments and balanced evenly in success and failure:
                      equilibrium is called yoga. Far lower than the Yoga of
                      Discrimination is action, O Dhananjaya. Take thou refuge
                      in the Pure Reason; pitiable are they who work for fruit.
                  urantiaParallels:
                    - id: 4:131.3.5
                      standardReferenceId: '131:3.5'
                      paperId: '131'
                      paperTitle: The World’s Religions
                      sectionTitle: Buddhism
                      text: >-
                        “No religionist may hope to attain the enlightenment of
                        immortal wisdom who persists in being slothful,
                        indolent, feeble, idle, shameless, and selfish. But
                        whoso is thoughtful, prudent, reflective, fervent, and
                        earnest — even while he yet lives on earth — may attain
                        the supreme enlightenment of the peace and liberty of
                        divine wisdom. Remember, every act shall receive its
                        reward. Evil results in sorrow and sin ends in pain. Joy
                        and happiness are the outcome of a good life. Even the
                        evildoer enjoys a season of grace before the time of the
                        full ripening of his evil deeds, but inevitably there
                        must come the full harvest of evil-doing. Let no man
                        think lightly of sin, saying in his heart: ‘The penalty
                        of wrongdoing shall not come near me.’ What you do shall
                        be done to you, in the judgment of wisdom. Injustice
                        done to your fellows shall come back upon you. The
                        creature cannot escape the destiny of his deeds.
                      similarity: 0.442891
                      rank: 1
                    - id: 2:48.7.13
                      standardReferenceId: '48:7.13'
                      paperId: '48'
                      paperTitle: The Morontia Life
                      sectionTitle: Morontia Mota
                      text: >-
                        11. The weak indulge in resolutions, but the strong act.
                        Life is but a day’s work — do it well. The act is ours;
                        the consequences God’s.
                      similarity: 0.422695
                      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 reference, or more than one passage
          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: Corpus or passage 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
          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'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '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.