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

# List Papers

> Returns metadata for all papers in the Urantia Book, ordered by paper number.

Use `?include=topEntities` to attach a per-paper aggregate of the most-referenced named entities (beings, places, concepts, etc.) sorted by citation frequency.



## OpenAPI

````yaml GET /papers
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:
  /papers:
    get:
      tags:
        - Papers
      summary: List all 197 papers
      description: >-
        Returns metadata for all papers in the Urantia Book, ordered by paper
        number.


        Use `?include=topEntities` to attach a per-paper aggregate of the
        most-referenced named entities (beings, places, concepts, etc.) sorted
        by citation frequency.
      operationId: listPapers
      parameters:
        - 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: List of all papers
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        partId:
                          type: string
                        title:
                          type: string
                        sortId:
                          type: string
                        labels:
                          type: array
                          nullable: true
                          items:
                            type: string
                        video:
                          type: object
                          nullable: true
                          additionalProperties:
                            type: object
                            properties:
                              mp4:
                                type: string
                              thumbnail:
                                type: string
                              duration:
                                type: number
                            required:
                              - mp4
                              - thumbnail
                              - duration
                        topEntities:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              name:
                                type: string
                              type:
                                type: string
                              count:
                                type: integer
                                minimum: 0
                            required:
                              - id
                              - name
                              - type
                              - count
                      required:
                        - id
                        - partId
                        - title
                        - sortId
                        - labels
                        - video
                required:
                  - data
        '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

````