Application Programming Interface (API)

Web-based scientific names finding service provides a RESTful API interface.

Using POST Method with JSON payload

/api/v0

with request body in JSON according to the specification.

Using POST Method to Upload Files

It is possible to upload files and get scientific names from their content. In this case API uses 'multipart/form' approach instead of JSON. For example, using curl and verifying data against Catalogue of Life (source #1) and Encyclopedia of Life (source #12):

curl -v -F sources[]=1 -F sources[]=12 -F file=@file.pdf \
    https://finder.globalnames.org/api/v0/find

For examples how to write a client, refer to a gnfinder Ruby Gem code.

OpenAPI Schema

Read the GNfinder's OpenAPI documentation to learn about all options and the output schema.