Biodiversity Heritage Library
API v3 Documentation
Overview
Methods
Data Elements
Release Notes

GetTitleMetadata
Return metadata about a title. You may choose to include a list of the items (books) associated with the title.
SYNTAX
https://www.biodiversitylibrary.org/api3?op=GetTitleMetadata
&id=<identifier of a title>
&idtype=<bhl, doi, oclc, issn, isbn, lccn, ddc, nal, nlm, coden, or soulsby (OPTIONAL; "bhl" is the default)>
&item=<"t" or "true" to include the title's items in the response>
&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=GetTitleMetadata&id=61122&idtype=bhl&items=t&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>
    <Title>
      <TitleID>61122</TitleID>
      <Genre>Collection</Genre>
      <MaterialType>Archival material</MaterialType>
      <FullTitle>Plant lists, notes, and correspondence : Frémont expeditions, 1843-1853</FullTitle>
      <ShortTitle>Plant lists, notes, and correspondence : Frémont expeditions, 1843-1853</ShortTitle>
      <SortTitle>Plant lists notes and correspondence Frémont expeditions</SortTitle>
      <TitleUrl>https://www.biodiversitylibrary.org/bibliography/61122</TitleUrl>
      <CreationDate>2012/08/06 13:58:28</CreationDate>
      <Authors>
        <Author>
          <AuthorID>280</AuthorID>
          <Name>Torrey, John,</Name>
          <Role>Main Entry -- Personal Name (MARC 100)</Role>
          <Dates>1796-1873</Dates>
        </Author>
        <Author>
          <AuthorID>30811</AuthorID>
          <Name>Bigelow, John M.</Name>
          <Role>Added Entry -- Personal Name (MARC 700)</Role>
          <Dates>1804-1878</Dates>
        </Author>
        <Author>
          <AuthorID>172</AuthorID>
          <Name>Gray, Asa,</Name>
          <Role>Added Entry -- Personal Name (MARC 700)</Role>
          <Dates>1810-1888</Dates>
        </Author>
      </Authors>
      <Subjects>
        <Subject>
          <SubjectText>Correspondence</SubjectText>
          <CreationDate>2012/08/07 00:04:26</CreationDate>
        </Subject>
        <Subject>
          <SubjectText>Discovery and exploration</SubjectText>
          <CreationDate>2012/08/07 00:04:26</CreationDate>
        </Subject>
        <Subject>
          <SubjectText>Explorers</SubjectText>
          <CreationDate>2012/08/07 00:04:26</CreationDate>
        </Subject>
        <Subject>
          <SubjectText>Frémont Expedition</SubjectText>
          <CreationDate>2012/08/07 00:04:26</CreationDate>
        </Subject>
        <Subject>
          <SubjectText>Plants</SubjectText>
          <CreationDate>2012/08/07 00:04:26</CreationDate>
        </Subject>
        <Subject>
          <SubjectText>Scientific Expeditions</SubjectText>
          <CreationDate>2012/08/07 00:04:26</CreationDate>
        </Subject>
        <Subject>
          <SubjectText>West (U.S.)</SubjectText>
          <CreationDate>2012/08/07 00:04:26</CreationDate>
        </Subject>
      </Subjects>
      <Identifiers>
        <Identifier>
          <IdentifierName>OCLC</IdentifierName>
          <IdentifierValue>782055926</IdentifierValue>
        </Identifier>
      </Identifiers>
      <Associations>
        <TitleAssociation>
          <TitleAssociationTypeName>Host Item Entry</TitleAssociationTypeName>
          <Title>Frémont expeditions, 1843-1853</Title>
        </TitleAssociation>
      </Associations>
      <Variants>
        <TitleVariant>
          <TitleVariantTypeName>Alternative</TitleVariantTypeName>
          <Title>Frémont expeditions   </Title>
        </TitleVariant>
      </Variants>
      <Items>
        <Item>
          <ItemID>124320</ItemID>
          <Volume>Explorers & travellers who have collected plants in California, Oregon, Washington Territory & Nev.</Volume>
          <ItemUrl>https://www.biodiversitylibrary.org/item/124320</ItemUrl>
        </Item>
        <Item>
          <ItemID>124321</ItemID>
          <Volume>List of plants of Frémont collections 1845-1846, sent by Torrey to Engelmann Fall 1848</Volume>
          <Year>1845</Year>
          <EndYear>1846</EndYear>
          <ItemUrl>https://www.biodiversitylibrary.org/item/124321</ItemUrl>
        </Item>
        <Item>
          <ItemID>124322</ItemID>
          <Volume>List of camps of an exploration from Fort Smith Ark. to San Pedro Cal. by Dr. Bigelow commenced July</Volume>
          <ItemUrl>https://www.biodiversitylibrary.org/item/124322</ItemUrl>
        </Item>
        <Item>
          <ItemID>124324</ItemID>
          <Volume>Numbers corresponding to labels on the plants commencing with the first plant gathered in California</Volume>
          <ItemUrl>https://www.biodiversitylibrary.org/item/124324</ItemUrl>
        </Item>
        <Item>
          <ItemID>124325</ItemID>
          <Volume>Asa Gray lists and letters regarding Frémont's expeditions, n.d.</Volume>
          <ItemUrl>https://www.biodiversitylibrary.org/item/124325</ItemUrl>
        </Item>
      </Items>
      <Notes>
        <TitleNote>
          <NoteText>Folder 9.65. List of plants for 1843 -- Folder 9.66. Localities of plants for 1844 -- Folder 9.67. Plant lists and notes, 2nd expedition, 1843-1844 -- Folder 9.68. List of plants of Frémont collections 1845-1846, sent by Torrey to Engelmann Fall 1848 -- Folder 9.69. Numbers corresponding to labels on the plants commencing with the first plant gathered in California, 1845-1846 -- Folder 9.70. Explorers & travellers who have collected plants in California, Oregon, Washington Territory & Nevada, n.d. -- Folder 9.71. List of camps of an exploration from Fort Smith Ark. to San Pedro Cal. by Dr. Bigelow commenced July 15, 1853 -- Folder 9.72. Asa Gray lists and letters regarding Frémont's expeditions, n.d.</NoteText>
          <NoteSequence>1</NoteSequence>
          <NoteTypeName>Contents</NoteTypeName>
        </TitleNote>
        <TitleNote>
          <NoteText>Plant lists, notes, and correspondence, chiefly by John Torrey, for 1843-1853. The lists and notes relate to plants collected on Frémont's 2nd and 3rd expeditions to the American West and Torrey's work identifying and describing the plants. Also included are Asa Gray's notes and correspondence from Asa Gray to John Torrey regarding Frémont's expeditions, a list of explorers who collected plants in the American West, and a list of camps during an exploration for a railroad route from Arkansas to California in 1853 by John Milton Bigelow.</NoteText>
          <NoteSequence>2</NoteSequence>
          <NoteTypeName>Scope and Content</NoteTypeName>
        </TitleNote>
        <TitleNote>
          <NoteText>In English.</NoteText>
          <NoteSequence>3</NoteSequence>
          <NoteTypeName>Language</NoteTypeName>
        </TitleNote>
      </Notes>
    </Title>
  </Result>
</Response>

            
        
EXAMPLE REQUEST (JSON)
            
https://www.biodiversitylibrary.org/api3?op=GetTitleMetadata&id=61122&idtype=bhl&items=t&format=json&apikey=12345678-BBBB-DDDD-FFFF-123456789012
            
        
EXAMPLE RESPONSE (JSON)
            
{
  "Status": "ok",
  "ErrorMessage": "",
  "Result": [
    {
      "TitleID": 61122,
      "Genre": "Collection",
      "MaterialType": "Archival material",
      "FullTitle": "Plant lists, notes, and correspondence : Frémont expeditions, 1843-1853",
      "ShortTitle": "Plant lists, notes, and correspondence : Frémont expeditions, 1843-1853",
      "SortTitle": "Plant lists notes and correspondence Frémont expeditions",
      "TitleUrl": "https://www.biodiversitylibrary.org/bibliography/61122",
      "CreationDate": "2012/08/06 13:58:28",
      "Authors": [
        {
          "AuthorID": "280",
          "Name": "Torrey, John,",
          "Role": "Main Entry -- Personal Name (MARC 100)",
          "Dates": "1796-1873"
        },
        {
          "AuthorID": "30811",
          "Name": "Bigelow, John M.",
          "Role": "Added Entry -- Personal Name (MARC 700)",
          "Dates": "1804-1878"
        },
        {
          "AuthorID": "172",
          "Name": "Gray, Asa,",
          "Role": "Added Entry -- Personal Name (MARC 700)",
          "Dates": "1810-1888"
        }
      ],
      "Subjects": [
        {
          "SubjectText": "Correspondence",
          "CreationDate": "2012/08/07 00:04:26"
        },
        {
          "SubjectText": "Discovery and exploration",
          "CreationDate": "2012/08/07 00:04:26"
        },
        {
          "SubjectText": "Explorers",
          "CreationDate": "2012/08/07 00:04:26"
        },
        {
          "SubjectText": "Frémont Expedition",
          "CreationDate": "2012/08/07 00:04:26"
        },
        {
          "SubjectText": "Plants",
          "CreationDate": "2012/08/07 00:04:26"
        },
        {
          "SubjectText": "Scientific Expeditions",
          "CreationDate": "2012/08/07 00:04:26"
        },
        {
          "SubjectText": "West (U.S.)",
          "CreationDate": "2012/08/07 00:04:26"
        }
      ],
      "Identifiers": [
        {
          "IdentifierName": "OCLC",
          "IdentifierValue": "782055926"
        }
      ],
      "Associations": [
        {
          "TitleAssociationTypeName": "Host Item Entry",
          "Title": "Frémont expeditions, 1843-1853"
        }
      ],
      "Variants": [
        {
          "TitleVariantTypeName": "Alternative",
          "Title": "Frémont expeditions   "
        }
      ],
      "Items": [
        {
          "ItemID": 124320,
          "Volume": "Explorers & travellers who have collected plants in California, Oregon, Washington Territory & Nev.",
          "ItemUrl": "https://www.biodiversitylibrary.org/item/124320"
        },
        {
          "ItemID": 124321,
          "Volume": "List of plants of Frémont collections 1845-1846, sent by Torrey to Engelmann Fall 1848",
          "Year": "1845",
          "EndYear": "1846",
          "ItemUrl": "https://www.biodiversitylibrary.org/item/124321"
        },
        {
          "ItemID": 124322,
          "Volume": "List of camps of an exploration from Fort Smith Ark. to San Pedro Cal. by Dr. Bigelow commenced July",
          "ItemUrl": "https://www.biodiversitylibrary.org/item/124322"
        },
        {
          "ItemID": 124324,
          "Volume": "Numbers corresponding to labels on the plants commencing with the first plant gathered in California",
          "ItemUrl": "https://www.biodiversitylibrary.org/item/124324"
        },
        {
          "ItemID": 124325,
          "Volume": "Asa Gray lists and letters regarding Frémont's expeditions, n.d.",
          "ItemUrl": "https://www.biodiversitylibrary.org/item/124325"
        }
      ],
      "Notes": [
        {
          "NoteText": "Folder 9.65. List of plants for 1843 -- Folder 9.66. Localities of plants for 1844 -- Folder 9.67. Plant lists and notes, 2nd expedition, 1843-1844 -- Folder 9.68. List of plants of Frémont collections 1845-1846, sent by Torrey to Engelmann Fall 1848 -- Folder 9.69. Numbers corresponding to labels on the plants commencing with the first plant gathered in California, 1845-1846 -- Folder 9.70. Explorers & travellers who have collected plants in California, Oregon, Washington Territory & Nevada, n.d. -- Folder 9.71. List of camps of an exploration from Fort Smith Ark. to San Pedro Cal. by Dr. Bigelow commenced July 15, 1853 -- Folder 9.72. Asa Gray lists and letters regarding Frémont's expeditions, n.d.",
          "NoteSequence": "1",
          "NoteTypeName": "Contents"
        },
        {
          "NoteText": "Plant lists, notes, and correspondence, chiefly by John Torrey, for 1843-1853. The lists and notes relate to plants collected on Frémont's 2nd and 3rd expeditions to the American West and Torrey's work identifying and describing the plants. Also included are Asa Gray's notes and correspondence from Asa Gray to John Torrey regarding Frémont's expeditions, a list of explorers who collected plants in the American West, and a list of camps during an exploration for a railroad route from Arkansas to California in 1853 by John Milton Bigelow.",
          "NoteSequence": "2",
          "NoteTypeName": "Scope and Content"
        },
        {
          "NoteText": "In English.",
          "NoteSequence": "3",
          "NoteTypeName": "Language"
        }
      ]
    }
  ]
}