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

# List Editions

> Returns the editions of the English text that `?edition=` accepts: the first printing (1955) and each Standard Reference Text (SRT). The API stores the newest (`srt-2024`, the Foundation's download 1.22) and builds an older one by undoing the later changes. `changes` is the count of changes adopted in that edition's year. An edition id can also be the Foundation's number (`1.22`, `21`) or a version stamp.



## OpenAPI

````yaml GET /editions
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:
  /editions:
    get:
      tags:
        - Editions
      summary: List the editions of the English text
      description: >-
        Returns the editions of the English text that `?edition=` accepts: the
        first printing (1955) and each Standard Reference Text (SRT). The API
        stores the newest (`srt-2024`, the Foundation's download 1.22) and
        builds an older one by undoing the later changes. `changes` is the count
        of changes adopted in that edition's year. An edition id can also be the
        Foundation's number (`1.22`, `21`) or a version stamp.
      operationId: listEditions
      responses:
        '200':
          description: The editions
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        label:
                          type: string
                        year:
                          type: integer
                        foundationVersion:
                          type:
                            - string
                            - 'null'
                        versionStamp:
                          type:
                            - string
                            - 'null'
                        default:
                          type: boolean
                        changes:
                          type: integer
                          description: >-
                            The changes adopted in this edition's year (for
                            srt-2009, also those that no report dates).
                      required:
                        - id
                        - label
                        - year
                        - foundationVersion
                        - versionStamp
                        - default
                        - changes
                  meta:
                    type: object
                    properties:
                      default:
                        type: string
                      variants:
                        type: integer
                    required:
                      - default
                      - variants
                required:
                  - data
                  - meta
              example:
                data:
                  - id: '1955'
                    label: First printing (1955)
                    year: 1955
                    foundationVersion: null
                    versionStamp: null
                    default: false
                    changes: 0
                  - id: srt-2009
                    label: Standard Reference Text, 2009
                    year: 2009
                    foundationVersion: null
                    versionStamp: null
                    default: false
                    changes: 161
                meta:
                  default: srt-2024
                  variants: 181
          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'
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.