Direct links with Life Science Identifiers

Note that the Life Science Identifiers have an altered authority part ("nmbe.ch"). You can continue to use all ObjectIds published in the catalog version 15.0 by N. I. Platnick, except for the changed ObjectIds listed here.

Links with full LSIDs

URL: http://wsc.nmbe.ch/lsid/<LSID>
Example: http://wsc.nmbe.ch/lsid/urn:lsid:nmbe.ch:spidersp:021946

Links with ObjectId only

URL species: http://wsc.nmbe.ch/speciesLsid/<ObjectId>
URL genus: http://wsc.nmbe.ch/genusLsid/<ObjectId>
URL family: http://wsc.nmbe.ch/familyLsid/<ObjectId>
Example: http://wsc.nmbe.ch/speciesLsid/021946


WSC Taxonomy REST API

The WSC taxonomy webservice provides taxonomical data either for a single taxon via the Life Science Identifier (LSID) or provides LSIDs for updated and new taxa. The REST API can only be used with a valid API key. To get an API key, please register as member of the WSCA, log in and generate an API key within your personal account page.

Single taxon

URL: http://wsc.nmbe.ch/api/lsid/<LSID>?apiKey=<valid API key>
Description: Retrieve taxonomic information for a single taxon via the LSID
Method: GET
Response type: JSON

ParameterDescription
LSIDFull LSID of the taxon.
apiKeyValid API key is found on your personal WSCA membership account page.
Example

URL:
http://wsc.nmbe.ch/api/lsid/urn:lsid:nmbe.ch:spidersp:021946?apiKey=xyz

Sample response:
{"taxon":{"species":"nava","subspecies":"","author":"(Blackwall, 1841)","taxonRank":"species","status":"VALID","genus":"Hahnia","family":"Hahniidae","lsid":"urn:lsid:nmbe.ch:spidersp:021946"}}

If the called taxon is a synonym or a replaced homonym, a link will be provided to the valid taxon.

Example:
"validTaxon":{"_href":"http:\/\/wsc.nmbe.ch\/api\/lsid\/urn:lsid:nmbe.ch:spidersp:002177"}
Taxa updates

URL: http://wsc.nmbe.ch/api/updates?type=<value (optional)>&date=<YYYY-MM-DD (optional)>&apiKey=<valid API key>
Description: Retrieve LSIDs of new or changed taxa. If date parameter is not provided, the response will include LSIDs of new or changed taxa of last six months (default)
Method: GET
Response type: JSON, paged (50 items per page)
Navigation: "_links": "self", "next", "previous", "first", "last"

ParameterDescription
type (optional)Restrict returned LSIDs for specified taxon type.
Valid values:
  • family
  • genus
  • species
date (optional)Retrieve data sets newer (incl. equal) the specified date. Format: YYYY-MM-DD. If not specified, the default value will be the current date minus 6 months
apiKeyValid API key is found on your personal WSCA membership account page.
Example

URL:
http://wsc.nmbe.ch/api/updates?apiKey=xyz

Sample response:
{"updates":["urn:lsid:nmbe.ch:spidersp:046607","urn:lsid:nmbe.ch:spidersp:046608",{...} ,"urn:lsid:nmbe.ch:spidersp:046653","urn:lsid:nmbe.ch:spidersp:046654" ,"urn:lsid:nmbe.ch:spidersp:046655","urn:lsid:nmbe.ch:spidersp:046656"] ,"_links":{"self":"http:\/\/wsc.nmbe.ch\/api\/updates?page=1\u0026apiKey=xyz" ,"next":"http:\/\/wsc.nmbe.ch\/api\/updates?page=2\u0026apiKey=xyz" ,"last":"http:\/\/wsc.nmbe.ch\/api\/updates?page=13\u0026apiKey=xyz