National University of Colombia OAI-PMH API

OAI-PMH 2.0 metadata harvesting interface of the Repositorio Institucional UNAL, served from the university's own host. Twelve metadata prefixes (oai_dc, qdc, mods, mets, didl, dim, etdms, marc, ore, rdf, uketd_dc, xoai). The software underneath is DSpace 7.6.5, but OAI-PMH is an open protocol and the deployment, host, sets and content are UNAL's; verified live 2026-09-01 with verb=Identify (200).

Operations 2

GET /oai OAI-PMH 2.0 request endpoint #
GET /oai/request OAI-PMH 2.0 request endpoint #

Documentation

Specifications

Schemas & Data

Other Resources

🔗
x-json-structure
https://raw.githubusercontent.com/api-evangelist/national-university-of-colombia/refs/heads/main/json-structure/national-university-of-colombia-community-structure.json
🔗
x-json-structure
https://raw.githubusercontent.com/api-evangelist/national-university-of-colombia/refs/heads/main/json-structure/national-university-of-colombia-collection-structure.json
🔗
x-example
https://raw.githubusercontent.com/api-evangelist/national-university-of-colombia/refs/heads/main/examples/national-university-of-colombia-listCommunities-example.json
🔗
x-example
https://raw.githubusercontent.com/api-evangelist/national-university-of-colombia/refs/heads/main/examples/national-university-of-colombia-listCollections-example.json
🔗
x-example
https://raw.githubusercontent.com/api-evangelist/national-university-of-colombia/refs/heads/main/examples/national-university-of-colombia-oaiRecord-example.json
🔗
x-spectral-rules
https://raw.githubusercontent.com/api-evangelist/national-university-of-colombia/refs/heads/main/rules/national-university-of-colombia-rules.yml
🔗
x-vocabulary
https://raw.githubusercontent.com/api-evangelist/national-university-of-colombia/refs/heads/main/vocabulary/national-university-of-colombia-vocabulary.yml
🔗
x-json-ld-context
https://raw.githubusercontent.com/api-evangelist/national-university-of-colombia/refs/heads/main/json-ld/national-university-of-colombia-context.jsonld
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/national-university-of-colombia/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/national-university-of-colombia-oai-pmh-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

national-university-of-colombia-oai-pmh-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: National University Of Colombia OAI PMH API
  version: '1.0'
  description: 'Operations tagged OAI-PMH across 2 of this provider''s published API definitions: national-university-of-colombia-journals-oai.yaml, national-university-of-colombia-repository-oai.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://revistas.unal.edu.co/index.php/index
  description: Open Journal Systems 3.4.0.10 site-wide context. Confirmed live 2026-09-01 via ?verb=Identify -> repositoryName "Portal de Revistas UN", repositoryIdentifier ojs.unal.edu.co, adminEmail digital@unal.edu.co.
- url: https://bffrepositorio.unal.edu.co/server
  description: DSpace 7.6.5 backend (REST API and OAI-PMH), discovered via repositorio.unal.edu.co assets/config.json
tags:
- name: oai pmh
  description: OAI-PMH 2.0 metadata harvesting interface for the university journal portal.
paths:
  /oai:
    get:
      tags:
      - oai pmh
      summary: OAI-PMH 2.0 request endpoint
      description: OAI-PMH 2.0 protocol endpoint for the Portal de Revistas UN. The verb parameter selects the operation. Returns XML conforming to the OAI-PMH schema. Confirmed live metadata prefixes are oai_dc, marcxml, oai_marc and rfc1807. Sets are one per journal, with journal:section subsets (e.g. acta_agronomica, acta_agronomica:AGRPR); at least 100 sets are served in the first ListSets page. deletedRecord is persistent, granularity YYYY-MM-DDThh:mm:ssZ.
      operationId: oaiRequest
      parameters:
      - name: verb
        in: query
        required: true
        description: The OAI-PMH protocol verb.
        schema:
          type: string
          enum:
          - Identify
          - ListMetadataFormats
          - ListSets
          - ListIdentifiers
          - ListRecords
          - GetRecord
      - name: metadataPrefix
        in: query
        description: Metadata format prefix (required for ListIdentifiers, ListRecords, GetRecord).
        schema:
          type: string
          enum:
          - oai_dc
          - marcxml
          - oai_marc
          - rfc1807
      - name: identifier
        in: query
        description: OAI identifier of a record (required for GetRecord), e.g. oai:ojs.unal.edu.co:article/1.
        schema:
          type: string
      - name: set
        in: query
        description: setSpec to restrict harvesting to one journal or journal section, e.g. acta_agronomica or acta_agronomica:AGRPR.
        schema:
          type: string
      - name: from
        in: query
        description: Lower bound UTC datestamp (YYYY-MM-DDThh:mm:ssZ).
        schema:
          type: string
          format: date-time
      - name: until
        in: query
        description: Upper bound UTC datestamp (YYYY-MM-DDThh:mm:ssZ).
        schema:
          type: string
          format: date-time
      - name: resumptionToken
        in: query
        description: Token returned by a previous incomplete list response.
        schema:
          type: string
      responses:
        '200':
          description: OAI-PMH XML response. Protocol-level failures (badVerb, badArgument, cannotDisseminateFormat, idDoesNotExist, noRecordsMatch, noSetHierarchy, badResumptionToken) are returned inside an <error> element with HTTP 200, per the OAI-PMH specification.
          content:
            text/xml:
              schema:
                type: string
                description: XML document conforming to http://www.openarchives.org/OAI/2.0/
    servers:
    - url: https://revistas.unal.edu.co/index.php/index
      description: Open Journal Systems 3.4.0.10 site-wide context. Confirmed live 2026-09-01 via ?verb=Identify -> repositoryName "Portal de Revistas UN", repositoryIdentifier ojs.unal.edu.co, adminEmail digital@unal.edu.co.
  /oai/request:
    get:
      tags:
      - oai pmh
      summary: OAI-PMH 2.0 request endpoint
      description: OAI-PMH 2.0 protocol endpoint. The verb parameter selects the operation. Returns XML conforming to the OAI-PMH schema. Confirmed live metadata prefixes include oai_dc, qdc, mods, mets, didl, dim, etdms, marc, ore, rdf, uketd_dc, and xoai.
      operationId: getOaiRequest
      parameters:
      - name: verb
        in: query
        required: true
        description: The OAI-PMH protocol verb.
        schema:
          type: string
          enum:
          - Identify
          - ListMetadataFormats
          - ListSets
          - ListIdentifiers
          - ListRecords
          - GetRecord
      - name: metadataPrefix
        in: query
        description: Metadata format prefix (required for ListIdentifiers, ListRecords, GetRecord).
        schema:
          type: string
          enum:
          - oai_dc
          - qdc
          - mods
          - mets
          - didl
          - dim
          - etdms
          - marc
          - ore
          - rdf
          - uketd_dc
          - xoai
      - name: identifier
        in: query
        description: OAI identifier of a record (required for GetRecord), e.g. oai:repositorio.unal.edu.co:unal/76203.
        schema:
          type: string
      - name: set
        in: query
        description: setSpec to restrict harvesting, e.g. com_unal_1 or col_unal_82470.
        schema:
          type: string
      - name: from
        in: query
        description: Lower bound UTC datestamp (YYYY-MM-DDThh:mm:ssZ).
        schema:
          type: string
          format: date-time
      - name: until
        in: query
        description: Upper bound UTC datestamp (YYYY-MM-DDThh:mm:ssZ).
        schema:
          type: string
          format: date-time
      - name: resumptionToken
        in: query
        description: Token returned by a previous incomplete list response.
        schema:
          type: string
      responses:
        '200':
          description: OAI-PMH XML response.
          content:
            text/xml:
              schema:
                type: string
                description: XML document conforming to http://www.openarchives.org/OAI/2.0/
      x-operation-id-source: normalized
      x-operation-id-original: oaiRequest
    servers:
    - url: https://bffrepositorio.unal.edu.co/server
      description: DSpace 7.6.5 backend (REST API and OAI-PMH), discovered via repositorio.unal.edu.co assets/config.json
x-refined-from:
- national-university-of-colombia-journals-oai.yaml
- national-university-of-colombia-repository-oai.yaml