Page tree
Skip to end of metadata
Go to start of metadata

The matches endpoint provides a way of submitting lists of names to the service and retrieving a list of potential matches.


Batch matching is an off-line process that can take some time to complete for files containing a large number of names.

Email notifications are used to inform the submitter of progress and to provide a download link to the completed results.




Downloads the results of the batch matching.




Submits a list of names in the following comma separated format:

Id, ScientificName
x, y

Note: The header row is required.


Example Matching File
Id, ScientificName
1, Lichen
2, Parmelia



Specifies the format of the input

  • standard
  • dwcarchive
emailThe email address that will be notified when processing is complete
Post BodyThe DwC archive binary file

Submitting Darwin Core Archive Files

Darwin Core Archives are a standard for packaging self-contained datasets of species concurrence or check list data.





Once a valid Darwin Core Archive has been submitted the batch matching process will parse the metadata of the archive to locate data matching the term identifier. Any data that is identified as a scientific name is then matched against NZOR data and the closest matches are added to a new file that is inserted into the archive as a MeasurementOrFact extension..

The new file is called nzor-result.txt.

Metadata Extension
  <extension linesTerminatedBy="\t" fieldsTerminatedBy="\n" fieldsEnclosedBy="" ignoreHeaderLines="1" rowType="" encoding="UTF-8">
    <coreid index="0" />
    <field term="" />
    <field index="1" term="" />
    <field index="2" term="" />
    <field index="3" term="" />
    <field index="4" term="" />
    <field index="5" term="" />
    <field index="6" term="" />


The Id used in the data file that contained the scientific name record.

the constant scientificName

The NZOR Identifier for the closest match or the constant No Match if there was not match for the submitted name.
Description of how many other names were possible matches.
The constant String Matching

The constant NZOR

The full name of the closest matching NZOR record.

Records where there is a match as list first and then followed by the records that were not matched.

Example Post Command Using CURL

curl -X POST --data-binary @"path-to-archive" ""
  • No labels