openapi: 3.2.0
info:
  title: QUT ePrints REST Interface Datasets API
  version: 1.0.0
  summary: The EPrints REST dataset interface exposed by QUT's institutional repository.
  description: QUT ePrints exposes the GNU EPrints REST interface at https://eprints.qut.edu.au/rest/.
  contact:
    name: QUT ePrints
    email: eprints@qut.edu.au
    url: https://www.library.qut.edu.au/about/collections/qut-eprints/
  x-operator: institution
  x-operator-basis: eprints.qut.edu.au -> 131.181.196.14 (no CNAME); APNIC netname QUT-AU, org ORG-QUOT1-AP, origin AS7575; TLS subject O=QUEENSLAND UNIVERSITY OF TECHNOLOGY, CN=eprints.qut.edu.au.
  x-generated: '2026-09-01'
  x-method: probed
  x-source: https://eprints.qut.edu.au/rest/
servers:
- url: https://eprints.qut.edu.au/rest
  description: QUT ePrints REST base (production, live 2026-09-01)
security: []
tags:
- name: Datasets
  description: EPrints REST dataset navigation.
paths:
  /:
    get:
      tags:
      - Datasets
      operationId: listDatasets
      summary: List the repository's REST datasets
      description: Returns an XHTML index of the datasets this repository exposes over REST. Live response on 2026-09-01 listed Eprints, Users and Subjects. Public, no authentication.
      security: []
      responses:
        '200':
          description: XHTML index titled `EPrints REST - Datasets`.
          content:
            application/xhtml+xml:
              schema:
                type: string
                contentMediaType: application/xhtml+xml
              examples:
                live:
                  summary: Live response captured 2026-09-01
                  externalValue: examples/qut-eprints-rest-datasets.html
  /eprint/:
    get:
      tags:
      - Datasets
      operationId: listEprintResources
      summary: List eprint resources
      description: Returns an XHTML index of per-record resources in the eprint dataset, as sibling `N/` and `N.xml` entries. Public and 200 — but dereferencing any of the listed entries returns 401.
      security: []
      responses:
        '200':
          description: XHTML index titled `EPrints REST - Eprints DataSet`.
          content:
            application/xhtml+xml:
              schema:
                type: string
                contentMediaType: application/xhtml+xml
  /subject/:
    get:
      tags:
      - Datasets
      operationId: listSubjectResources
      summary: List subject resources
      description: Returns an XHTML index of the subject dataset. Public, no authentication, verified 200.
      security: []
      responses:
        '200':
          description: XHTML index.
          content:
            application/xhtml+xml:
              schema:
                type: string
                contentMediaType: application/xhtml+xml
  /eprint/{eprintId}.xml:
    get:
      tags:
      - Datasets
      operationId: getEprintRecord
      summary: Retrieve one eprint record as EPrints XML
      description: Documented because the index advertises it, and recorded as closed because it is. Probed 2026-09-01 and returned HTTP 401 for both a listed id (4) and the repository's own sample identifier (249243). No credential is obtainable through any public QUT route, so this operation is unusable by the public.
      parameters:
      - name: eprintId
        in: path
        required: true
        schema:
          type: integer
        example: 249243
      responses:
        '200':
          description: EPrints XML record. Not observed — the endpoint returned 401 on every probe.
          content:
            application/xml:
              schema:
                type: string
                contentMediaType: application/xml
        '401':
          description: Unauthorized. This is the observed response, twice, on 2026-09-01. The body is an Apache HTML 401 page, not a structured error document.
          content:
            text/html:
              schema:
                type: string
                contentMediaType: text/html
      security:
      - basicAuth: []
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: EPrints REST record access is credentialed. QUT publishes no public route to obtain a credential for this repository — no developer portal, no self-service registration.