Published at October 28th, 2025 Last updated 6 days ago

Pure OAI interface

OAI Endpoint

Pure implements the Open Archives Initiative Protocol for Metadata Harvesting
Also see

Example requests

http://server/ws/oai?verb=Identify
http://server/ws/oai?verb=ListRecords&metadataPrefix=oai_dc
http://server/ws/oai?verb=ListRecords&metadataPrefix=mods

From Pure version 5.28.0 the MODS format is version 3.8 and in prior Pure versions it is MODS 3.3.

You may find these tools useful.

NL-DIDL metadata format

The DIDL metadata format is a customization of the MODS metadata format.

For more information on the specifications of the format see here: https://wiki.surfnet.nl/display/standards/NARCIS

Harvesting information using the DIDL metadata format can be done by the OAI Endpoint with the metadataPrefix parameter set to "nldidl"

http://server/ws/oai?verb=ListRecords&metadataPrefix=nl_didl

Several configurations has been added to the format, three available to everyone. Found under System Settings under the menu "nldidl"

Identifier prefix:
Identifierprefix used to signal organisational ownership of a record in the 'urn:nbn:nl:ui' namespace, i.e the prefix 'urn:nbn:nl:ui-17' signals identifiers belonging to Kiniklijke Nederlandse Akademie van Wetenschappen (KNAW)

Backwards Compatibility
Can be enabled to ensure backwards compatibility, this enables providing human start page as both 'rdf:type rdf:resource' and 'dip:ObjectType'

Customized identifier source
Enables customizing identifiers in the NL-DIDL metadata format, enabling preservation of persistence identifiers from prior to integration into Pure. When a source id from the provided source exists on a record, this source id is used in the construction of identifiers.

nldidl.identifier-prefix-label=Identifier prefix
nldidl.identifier-prefix-description=Identifierprefix used to signal organisational ownership of a record in the 'urn:nbn:nl:ui' namespace, i.e the prefix 'urn:nbn:nl:ui-17' signals identifiers belonging to Kiniklijke Nederlandse Akademie van Wetenschappen (KNAW)

nldidl.humanstartpage-backwards-compatibility-label=Backwards Compatibility
nldidl.humanstartpage-backwards-compatibility-description=Can be enabled to ensure backwards compatibility, this enables providing human start page as both 'rdf:type rdf:resource' and 'dip:ObjectType'

nldidl.legacy-persistence-identifier-source-label=Customized identifier source
nldidl.legacy-persistence-identifier-source-description=Enables customizing identifiers in the NL-DIDL metadata format, enabling preservation of persistence identifiers from prior to integration into Pure. When a source id from the provided source exists on a record, this source id is used in the construction of identifiers.