Oxford Text Archive OAI-PMH

openapi: 3.1.0
info:
  title: Oxford Text Archive OAI-PMH Interface
  version: '2.0'
  summary: OAI-PMH 2.0 harvesting for the Bodleian Libraries' Oxford Text Archive.
  description: |
    A second, separate institution-operated OAI-PMH endpoint, distinct from ORA. The Oxford
    Text Archive is a language-resources repository run by the Bodleian Libraries on a DSpace
    installation at ota.bodleian.ox.ac.uk. DSpace is open-source software Oxford installs and
    runs itself — not a hosted vendor platform — so the surface is institution-operated, not a
    tenancy.

    The Identify response carries an OLAC archive description naming the institution as
    "Bodleian Libraries, University of Oxford" with a physical address at Osney Mead, Oxford,
    which is unusually explicit provenance for a repository endpoint. Note two honest defects
    visible in that response: an unresolved template variable `${lr.desription.access}` in the
    OLAC access field (with the typo in the software's own key), and an OLAC record last
    reviewed 2020-02-26. `deletedRecord` is `transient`, unlike ORA's `no`.

    DERIVED: this is a convenience description of a protocol Oxford implements. Oxford
    publishes no OpenAPI for it.
  contact:
    name: Oxford Text Archive — Bodleian Libraries, University of Oxford
    email: ota@bodleian.ox.ac.uk
    url: https://ota.bodleian.ox.ac.uk/repository/xmlui/page/about
  x-operator: institution
  x-operator-evidence: >-
    Identify response reports repositoryIdentifier ota.bodleian.ox.ac.uk, adminEmail
    ota@bodleian.ox.ac.uk and an OLAC institution of "Bodleian Libraries, University of
    Oxford". DSpace is self-hosted open-source software, not a vendor tenancy.
  x-provenance:
    generated: '2026-08-19'
    method: derived
    source: >-
      Derived from a live Identify response captured 2026-08-19, stored verbatim in
      ../examples/university-of-oxford-ota-oai-identify.xml.
  x-standard: https://www.openarchives.org/OAI/openarchivesprotocol.html
servers:
  - url: https://ota.bodleian.ox.ac.uk/repository/oai/request
    description: >-
      Oxford Text Archive OAI-PMH base URL. The Identify response self-reports this base URL
      over http; https is what actually answers.
tags:
  - name: TextArchive
    description: OAI-PMH harvesting of Oxford Text Archive records.
paths:
  /:
    get:
      operationId: otaOaiRequest
      summary: Issue an OAI-PMH verb against the Oxford Text Archive
      tags: [TextArchive]
      parameters:
        - name: verb
          in: query
          required: true
          schema:
            type: string
            enum: [Identify, ListSets, ListMetadataFormats, ListIdentifiers, ListRecords, GetRecord]
        - name: metadataPrefix
          in: query
          required: false
          schema: { type: string }
          example: oai_dc
        - name: set
          in: query
          required: false
          schema: { type: string }
        - name: identifier
          in: query
          required: false
          description: Form `oai:ota.bodleian.ox.ac.uk:20.500.12024/{id}` (Handle-based).
          schema: { type: string }
          example: oai:ota.bodleian.ox.ac.uk:20.500.12024/0001
        - name: from
          in: query
          required: false
          schema: { type: string, format: date-time }
        - name: until
          in: query
          required: false
          schema: { type: string, format: date-time }
        - name: resumptionToken
          in: query
          required: false
          schema: { type: string }
      responses:
        '200':
          description: >-
            OAI-PMH response envelope. Protocol errors are returned inside a 200 body via an
            <error> element, not as an HTTP status.
          content:
            text/xml:
              schema:
                type: string
                contentMediaType: text/xml
              examples:
                identify:
                  externalValue: ../examples/university-of-oxford-ota-oai-identify.xml