University of Navarra Harvesting API

openapi: 3.2.0
info:
  title: Universidad de Navarra Revistas Cientificas OAI-PMH…
  version: '2.0'
  description: Machine-readable description of the OAI-PMH 2.0 metadata harvesting interface operated by the Servicio de Publicaciones de la Universidad de Navarra at revistas.unav.edu.
  contact:
    name: Servicio de Publicaciones, Universidad de Navarra
    email: rhereder@unav.es
    url: https://revistas.unav.edu/
  license:
    name: OAI-PMH 2.0 protocol (Open Archives Initiative)
    url: https://www.openarchives.org/OAI/openarchivesprotocol.html
  x-operator: institution
  x-operator-basis: Host revistas.unav.edu is under the institution's own registrable domain unav.edu, has no CNAME to any vendor platform (A record only, nginx/1.20.1), and the OAI Identify response names the university's own Servicio de Publicaciones with an @unav.es administrative contact.
  x-provenance:
    method: derived
    generated: '2026-09-01'
    source:
    - https://revistas.unav.edu/index.php/index/oai?verb=Identify
    - https://revistas.unav.edu/index.php/index/oai?verb=ListMetadataFormats
    - https://revistas.unav.edu/index.php/index/oai?verb=ListSets
    - https://revistas.unav.edu/index.php/index/oai?verb=ListIdentifiers&metadataPrefix=oai_dc
    note: Derived by API Evangelist from live probes of the endpoint. The university does not publish an OpenAPI for this interface; OAI-PMH is a protocol specification, and this document maps the protocol onto the deployment's verified base URL, sets and metadata formats.
  x-software:
    name: Open Journal Systems
    version: 3.4.0.8
    vendor: Public Knowledge Project
    self_hosted: true
  x-oai-pmh:
    protocolVersion: '2.0'
    repositoryIdentifier: ojs.pkp.sfu.ca
    earliestDatestamp: '2019-02-01T12:03:23Z'
    deletedRecord: persistent
    granularity: YYYY-MM-DDThh:mm:ssZ
    compression:
    - gzip
    - deflate
    setCount: 100
servers:
- url: https://revistas.unav.edu/index.php/index
  description: Site-wide OAI-PMH interface across all Universidad de Navarra journals
tags:
- name: Harvesting
  description: OAI-PMH 2.0 verbs for harvesting scholarly metadata
paths:
  /oai:
    get:
      summary: OAI-PMH 2.0 request endpoint
      description: Single OAI-PMH request endpoint. The verb parameter selects the operation. Responses are OAI-PMH 2.0 XML documents. No authentication is required.
      operationId: oaiRequest
      tags:
      - Harvesting
      parameters:
      - name: verb
        in: query
        required: true
        description: The OAI-PMH verb to execute.
        schema:
          type: string
          enum:
          - Identify
          - ListMetadataFormats
          - ListSets
          - ListIdentifiers
          - ListRecords
          - GetRecord
      - name: metadataPrefix
        in: query
        required: false
        description: Metadata format to return. Required for ListIdentifiers, ListRecords and GetRecord. Formats confirmed live on this deployment.
        schema:
          type: string
          enum:
          - oai_dc
          - marcxml
          - oai_marc
          - rfc1807
      - name: set
        in: query
        required: false
        description: Set to restrict the harvest to. This deployment exposes 100 sets, one per journal plus per-section subsets (for example anuario-de-historia-iglesia and anuario-de-historia-iglesia:ART-not).
        schema:
          type: string
      - name: identifier
        in: query
        required: false
        description: Record identifier, required for GetRecord. Identifiers take the form oai:ojs.pkp.sfu.ca:article/<id>.
        schema:
          type: string
      - name: from
        in: query
        required: false
        description: Lower bound of the datestamp range, UTC.
        schema:
          type: string
          format: date-time
      - name: until
        in: query
        required: false
        description: Upper bound of the datestamp range, UTC.
        schema:
          type: string
          format: date-time
      - name: resumptionToken
        in: query
        required: false
        description: Flow-control token returned by an incomplete list response.
        schema:
          type: string
      responses:
        '200':
          description: OAI-PMH 2.0 XML response. Protocol-level failures are also returned with HTTP 200 and an <error> element carrying an OAI error code.
          content:
            text/xml:
              schema:
                type: string
                format: xml
              examples:
                identify:
                  summary: Identify response captured 2026-09-01
                  externalValue: ../examples/revistas-oai-identify.xml
                listMetadataFormats:
                  summary: ListMetadataFormats response captured 2026-09-01
                  externalValue: ../examples/revistas-oai-listmetadataformats.xml
                listSets:
                  summary: ListSets response captured 2026-09-01
                  externalValue: ../examples/revistas-oai-listsets.xml
                listIdentifiers:
                  summary: ListIdentifiers response captured 2026-09-01
                  externalValue: ../examples/revistas-oai-listidentifiers.xml
                badVerb:
                  summary: badVerb protocol error captured 2026-09-01
                  externalValue: ../examples/revistas-oai-error-badverb.xml