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

# Get Paragraph

> Look up a paragraph using any of three ID formats:
- **globalId**: "1:2.0.1" (partId:paperId.sectionId.paragraphId)
- **standardReferenceId**: "2:0.1" (paperId:sectionId.paragraphId)
- **paperSectionParagraphId**: "2.0.1" (paperId.sectionId.paragraphId)

The format is auto-detected from the reference string.

Response includes a `navigation` envelope with the previous and next paragraph refs (within the same paper, ordered by sortId). Refs are `null` at paper boundaries.

Use `?include=entities` to include typed entity mentions in the response.



## OpenAPI

````yaml GET /paragraphs/{ref}
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:
  /paragraphs/{ref}:
    get:
      tags:
        - Paragraphs
      summary: Get a paragraph by reference
      description: >-
        Look up a paragraph using any of three ID formats:

        - **globalId**: "1:2.0.1" (partId:paperId.sectionId.paragraphId)

        - **standardReferenceId**: "2:0.1" (paperId:sectionId.paragraphId)

        - **paperSectionParagraphId**: "2.0.1" (paperId.sectionId.paragraphId)


        The format is auto-detected from the reference string.


        Response includes a `navigation` envelope with the previous and next
        paragraph refs (within the same paper, ordered by sortId). Refs are
        `null` at paper boundaries.


        Use `?include=entities` to include typed entity mentions in the
        response.
      operationId: getParagraph
      parameters:
        - schema:
            type: string
          required: true
          name: ref
          in: path
        - schema:
            type: string
          required: false
          name: include
          in: query
        - schema:
            type: string
            enum:
              - default
              - rag
            default: default
          required: false
          name: format
          in: query
        - schema:
            type: string
            enum:
              - eng
              - es
              - fr
              - pt
              - de
              - ko
            default: eng
          required: false
          name: lang
          in: query
      responses:
        '200':
          description: The paragraph
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      standardReferenceId:
                        type: string
                      sortId:
                        type: string
                      paperId:
                        type: string
                      sectionId:
                        type: string
                        nullable: true
                      partId:
                        type: string
                      paperTitle:
                        type: string
                      sectionTitle:
                        type: string
                        nullable: true
                      paragraphId:
                        type: string
                      text:
                        type: string
                      htmlText:
                        type: string
                      language:
                        type: string
                      labels:
                        type: array
                        nullable: true
                        items:
                          type: string
                      audio:
                        type: object
                        nullable: true
                        additionalProperties:
                          type: object
                          additionalProperties:
                            type: object
                            properties:
                              format:
                                type: string
                              url:
                                type: string
                              duration:
                                type: number
                              bitrate:
                                type: number
                              fileSize:
                                type: number
                            required:
                              - format
                              - url
                      entities:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            type:
                              type: string
                              enum:
                                - being
                                - place
                                - order
                                - race
                                - religion
                                - concept
                          required:
                            - id
                            - name
                            - type
                      bibleParallels:
                        type: array
                        items:
                          type: object
                          properties:
                            chunkId:
                              type: string
                            reference:
                              type: string
                            bookCode:
                              type: string
                            chapter:
                              type: integer
                            verseStart:
                              type: integer
                            verseEnd:
                              type: integer
                            text:
                              type: string
                            similarity:
                              type: number
                            rank:
                              type: integer
                            source:
                              type: string
                            embeddingModel:
                              type: string
                          required:
                            - chunkId
                            - reference
                            - bookCode
                            - chapter
                            - verseStart
                            - verseEnd
                            - text
                            - similarity
                            - rank
                            - source
                            - embeddingModel
                      urantiaParallels:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            standardReferenceId:
                              type: string
                            paperId:
                              type: string
                            paperTitle:
                              type: string
                            sectionTitle:
                              type: string
                              nullable: true
                            text:
                              type: string
                            similarity:
                              type: number
                            rank:
                              type: integer
                            source:
                              type: string
                            embeddingModel:
                              type: string
                          required:
                            - id
                            - standardReferenceId
                            - paperId
                            - paperTitle
                            - sectionTitle
                            - text
                            - similarity
                            - rank
                            - source
                            - embeddingModel
                    required:
                      - id
                      - standardReferenceId
                      - sortId
                      - paperId
                      - sectionId
                      - partId
                      - paperTitle
                      - sectionTitle
                      - paragraphId
                      - text
                      - htmlText
                      - labels
                      - audio
                  navigation:
                    type: object
                    properties:
                      prev:
                        type: string
                        nullable: true
                      next:
                        type: string
                        nullable: true
                    required:
                      - prev
                      - next
                required:
                  - data
        '400':
          description: Invalid reference format
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                required:
                  - type
                  - title
                  - status
                  - detail
        '404':
          description: Paragraph not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                required:
                  - type
                  - title
                  - status
                  - detail
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                required:
                  - type
                  - title
                  - status
                  - detail

````