Biodiversity Heritage Library
API v3 Documentation
Overview
Methods
Data Elements
Release Notes
GetInstitutions
Get a list of institutions which have contributed to BHL in some way. These institutions may fill roles such as contributors, rights holders, and scanning institutions.
SYNTAX
https://www.biodiversitylibrary.org/api3?op=GetInstitutions
&format=<"xml" for an XML response or "json" for JSON (OPTIONAL; "xml" is the default)>
&apikey=<API key value>
EXAMPLE REQUEST (XML)
            
https://www.biodiversitylibrary.org/api3?op=GetInstitutions&format=xml&apikey=12345678-BBBB-DDDD-FFFF-123456789012
EXAMPLE RESPONSE (XML)
            

<?xml version="1.0" encoding="utf-8"?>
<Response
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Status>ok</Status>
  <ErrorMessage />
  <Result>
    <Institution>
      <InstitutionCode>ANSP</InstitutionCode>
      <InstitutionName>Academy of Natural Sciences of Drexel University, Library and Archives</InstitutionName>
      <InstitutionUrl />
      <BHLMember>true</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>ACC</InstitutionCode>
      <InstitutionName>African Conservation Centre</InstitutionName>
      <InstitutionUrl>https://www.accafrica.org/</InstitutionUrl>
      <BHLMember>true</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>AMNH</InstitutionCode>
      <InstitutionName>American Museum of Natural History Library</InstitutionName>
      <InstitutionUrl>http://library.amnh.org</InstitutionUrl>
      <BHLMember>true</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>SCIELO</InstitutionCode>
      <InstitutionName>BHL SciELO</InstitutionName>
      <InstitutionUrl>http://www.bhlscielo.org/en/</InstitutionUrl>
      <BHLMember>true</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>BDRJBM</InstitutionCode>
      <InstitutionName>Biblioteca Digital del Real Jardin Botanico de Madrid</InstitutionName>
      <BHLMember>false</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>BOSTONUL</InstitutionCode>
      <InstitutionName>Boston University Libraries (archive.org)</InstitutionName>
      <InstitutionUrl />
      <BHLMember>false</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>CAMNH</InstitutionCode>
      <InstitutionName>Carnegie Museum of Natural History</InstitutionName>
      <InstitutionUrl>http://www.carnegiemnh.org/</InstitutionUrl>
      <BHLMember>false</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>EAZA</InstitutionCode>
      <InstitutionName>European Association of Zoos and Aquaria</InstitutionName>
      <InstitutionUrl>http://www.eaza.net/</InstitutionUrl>
      <BHLMember>false</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>FIELD</InstitutionCode>
      <InstitutionName>Field Museum of Natural History Library</InstitutionName>
      <InstitutionUrl>http://fieldmuseum.org/explore/department/library</InstitutionUrl>
      <BHLMember>true</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>HUH</InstitutionCode>
      <InstitutionName>Harvard University Botany Libraries</InstitutionName>
      <InstitutionUrl>http://www.huh.harvard.edu/libraries/</InstitutionUrl>
      <BHLMember>true</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>LC</InstitutionCode>
      <InstitutionName>Library of Congress</InstitutionName>
      <InstitutionUrl />
      <BHLMember>true</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>MITL</InstitutionCode>
      <InstitutionName>MIT Libraries (archive.org)</InstitutionName>
      <BHLMember>false</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>NBC</InstitutionCode>
      <InstitutionName>Naturalis Biodiversity Center</InstitutionName>
      <InstitutionUrl>http://www.naturalis.nl/en/science/collection/library/</InstitutionUrl>
      <BHLMember>true</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>PENNST</InstitutionCode>
      <InstitutionName>Penn State University (archive.org)</InstitutionName>
      <BHLMember>false</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>ROM</InstitutionCode>
      <InstitutionName>Royal Ontario Museum (archive.org)</InstitutionName>
      <InstitutionUrl />
      <BHLMember>false</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>SBG</InstitutionCode>
      <InstitutionName>Singapore Botanic Gardens, National Parks Board Singapore</InstitutionName>
      <InstitutionUrl>https://www.sbg.org.sg/</InstitutionUrl>
      <BHLMember>true</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>SIA</InstitutionCode>
      <InstitutionName>Smithsonian Institution Archives</InstitutionName>
      <InstitutionUrl />
      <BHLMember>true</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>TXAS</InstitutionCode>
      <InstitutionName>Texas Academy of Science</InstitutionName>
      <InstitutionUrl>http://www.texasacademyofscience.org/</InstitutionUrl>
      <BHLMember>false</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>USGS</InstitutionCode>
      <InstitutionName>United States Geological Survey Libraries Program</InstitutionName>
      <InstitutionUrl />
      <BHLMember>true</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>WAS</InstitutionCode>
      <InstitutionName>Washington Academy of Sciences</InstitutionName>
      <InstitutionUrl>http://www.washacadsci.org/</InstitutionUrl>
      <BHLMember>false</BHLMember>
    </Institution>
    <Institution>
      <InstitutionCode>PEABODY</InstitutionCode>
      <InstitutionName>Yale Peabody Museum of Natural History</InstitutionName>
      <InstitutionUrl>http://peabody.yale.edu/</InstitutionUrl>
      <BHLMember>true</BHLMember>
    </Institution>
  </Result>
</Response>
EXAMPLE REQUEST (JSON)
            
https://www.biodiversitylibrary.org/api3?op=GetInstitutions&format=json&apikey=12345678-BBBB-DDDD-FFFF-123456789012
EXAMPLE RESPONSE (JSON)
            
{
  "Status": "ok",
  "ErrorMessage": "",
  "Result": [
    {
      "InstitutionCode": "ANSP",
      "InstitutionName": "Academy of Natural Sciences of Drexel University, Library and Archives",
      "InstitutionUrl": "",
      "BHLMember": true
    },
    {
      "InstitutionCode": "ACC",
      "InstitutionName": "African Conservation Centre",
      "InstitutionUrl": "https://www.accafrica.org/",
      "BHLMember": true
    },
    {
      "InstitutionCode": "AMNH",
      "InstitutionName": "American Museum of Natural History Library",
      "InstitutionUrl": "http://library.amnh.org",
      "BHLMember": true
    },
    {
      "InstitutionCode": "AOS",
      "InstitutionName": "American Ornithological Society",
      "InstitutionUrl": "http://www.americanornithology.org/",
      "BHLMember": false
    },
    {
      "InstitutionCode": "SCIELO",
      "InstitutionName": "BHL SciELO",
      "InstitutionUrl": "http://www.bhlscielo.org/en/",
      "BHLMember": true
    },
    {
      "InstitutionCode": "BDRJBM",
      "InstitutionName": "Biblioteca Digital del Real Jardin Botanico de Madrid",
      "BHLMember": false
    },
    {
      "InstitutionCode": "BOSTONUL",
      "InstitutionName": "Boston University Libraries (archive.org)",
      "InstitutionUrl": "",
      "BHLMember": false
    },
    {
      "InstitutionCode": "CAMNH",
      "InstitutionName": "Carnegie Museum of Natural History",
      "InstitutionUrl": "http://www.carnegiemnh.org/",
      "BHLMember": false
    },
    {
      "InstitutionCode": "EAZA",
      "InstitutionName": "European Association of Zoos and Aquaria",
      "InstitutionUrl": "http://www.eaza.net/",
      "BHLMember": false
    },
    {
      "InstitutionCode": "FIELD",
      "InstitutionName": "Field Museum of Natural History Library",
      "InstitutionUrl": "http://fieldmuseum.org/explore/department/library",
      "BHLMember": true
    },
    {
      "InstitutionCode": "HUH",
      "InstitutionName": "Harvard University Botany Libraries",
      "InstitutionUrl": "http://www.huh.harvard.edu/libraries/",
      "BHLMember": true
    },
    {
      "InstitutionCode": "LC",
      "InstitutionName": "Library of Congress",
      "InstitutionUrl": "",
      "BHLMember": true
    },
    {
      "InstitutionCode": "MITL",
      "InstitutionName": "MIT Libraries (archive.org)",
      "BHLMember": false
    },
    {
      "InstitutionCode": "NBC",
      "InstitutionName": "Naturalis Biodiversity Center",
      "InstitutionUrl": "http://www.naturalis.nl/en/science/collection/library/",
      "BHLMember": true
    },
    {
      "InstitutionCode": "PENNST",
      "InstitutionName": "Penn State University (archive.org)",
      "BHLMember": false
    },
    {
      "InstitutionCode": "ROM",
      "InstitutionName": "Royal Ontario Museum (archive.org)",
      "InstitutionUrl": "",
      "BHLMember": false
    },
    {
      "InstitutionCode": "SBG",
      "InstitutionName": "Singapore Botanic Gardens, National Parks Board Singapore",
      "InstitutionUrl": "https://www.sbg.org.sg/",
      "BHLMember": true
    },
    {
      "InstitutionCode": "SIA",
      "InstitutionName": "Smithsonian Institution Archives",
      "InstitutionUrl": "",
      "BHLMember": true
    },
    {
      "InstitutionCode": "TXAS",
      "InstitutionName": "Texas Academy of Science",
      "InstitutionUrl": "http://www.texasacademyofscience.org/",
      "BHLMember": false
    },
    {
      "InstitutionCode": "USGS",
      "InstitutionName": "United States Geological Survey Libraries Program",
      "InstitutionUrl": "",
      "BHLMember": true
    },
    {
      "InstitutionCode": "WAS",
      "InstitutionName": "Washington Academy of Sciences",
      "InstitutionUrl": "http://www.washacadsci.org/",
      "BHLMember": false
    },
    {
      "InstitutionCode": "PEABODY",
      "InstitutionName": "Yale Peabody Museum of Natural History",
      "InstitutionUrl": "http://peabody.yale.edu/",
      "BHLMember": true
    }
  ]
}