Prokaryotic Nomenclature Up-to-Date API Root.


PNU Web Service 1.0

You have to register and create a user account, if you want to use the web services. You can browse the endpoints and read the documentation without login.

Example client for the access to the RESTful web service in R and python


List of the most important endpoints:

  • /species/: list of all species. Using the PNU number a single entry can be retrieved. The PNU number for a species is a 6-digit number beginning with 7.
  • /genus/: list of all genera. Using the PNU number a single entry can be retrieved. The PNU number for a genus is a 6-digit number beginning with 5.
  • /fam/: list of all families. Using the exact family name a single entry for the family can be retrieved.
  • /class/: list of all classes. Using the exact class name a single entry for the class can be retrieved.
  • /reclassified/: list of all species that have been reclassified.

Beyond these there are also endpoints:

  • /taxon/{taxon}/:
    given the name of a class or family or genus or species matching the searching criteria can be retrieved.

  • /name/{genus}/{species}/subsp/{subspecies}/:
    given the name of a genus and/or species and/or subspecies one or more entries matching the searching criteria can be retrieved.

  • /culturecollectionno/{culturecollectionnno}/:
    given a culture collection number an associated species is retrieved.

Please take a look at the API documentation for list of all end points. For more detailed information visit the links below.


The results can be fetched as JSON or XML. You can specify the format as a query parameter in the link, for example:

  • http://www.example.com/?format=json
  • http://www.example.com/?format=xml

or give the format over content negotiation, for example with curl in the shell:

curl -X GET "http://www.example.com" -H "Accept: application/json"
curl -X GET "http://www.example.com" -H "Accept: application/xml"

Please help us to improve our distributed webservices. Report bugs and change requests, even if these are minor issues and typos. Please send your comments to webservices(at)dsmz.de.

GET /api/pnu/
HTTP 200 OK
Content-Type: application/json
Vary: Accept
Allow: OPTIONS, GET

{
    "genera": "https://bacdive.dsmz.de/api/pnu/genus/", 
    "classes": "https://bacdive.dsmz.de/api/pnu/class/", 
    "reclassified": "https://bacdive.dsmz.de/api/pnu/reclassified/", 
    "species": "https://bacdive.dsmz.de/api/pnu/species/", 
    "familiae": "https://bacdive.dsmz.de/api/pnu/fam/"
}