Arctos API

Note: this documentation refers to the new API (beginning 2020). For information about the old API, please see this page.

Usage

Specimen query terms

Results

Only JSON-formatted results are currently available. The default fields returned for a specimen search are: guid, scientific_name, country, state_prov, spec_locality, verbatim_date, dec_lat, dec_long, coordinateuncertaintyinmeters. More field control should soon be possible via the cols=... key-value pair.

Examples:

Single specimen by GUID:
http://test.arctos.database.museum/api/v1/cat/record?\
  api_key=...&q=guid%3DUAM%3AHerb%3A10043

Several specimens by GUID:
http://test.arctos.database.museum/api/v1/cat/record?\
  api_key=...&q=guid%3DUAM%3AHerb%3A10043,UAM%3AHerb%3A10442

Specimens by name:
http://test.arctos.database.museum/api/v1/cat/record?\
  api_key=...&q=genus%3DClaytonia%26species%3Darctica

Interacting with the API

In order to get a non-zero Content-Length from the API, the HTTP header Accept-Encoding: gzip must be set. This is set by default on web browsers and wget, but not with curl. The output from curl must then be uncompressed:

curl -s -H "Accept-Encoding: gzip" \
   http://test.arctos.database.museum/api/v1/about | gunzip > output.json