Holdings Lookup

This resource represents the Talis Source holdings catalogue.

Service URI

http://api.talis.com/1/bib/holdings

GET

Obtains a representation of a portion of the holdings catalogue. The results are sorted by the title of the collection having the holding.

Required parameters

• api_key – the user’s API key

Optional parameters

• isbn – a space delimited list of ISBNs for which holdings are required
• group – a space delimited list of group URIs. The list of holdings will be restricted to those in collections that are members of this group.
  Note that the group URIs are defined by the directory but there is not currently a user interface
  for maintaining them.
• max – an integer specifying the maximum number of records to return
• output – a string representing the format of the output. This may be either ‘xml’ (indicating a holdings XML format), ‘rdf’ (an RDF/XML description of the holdings) or ‘json’ (a Javascript version of the holdings xml format). The default for this parameter is ‘xml’

Typical HTTP Responses

• 200 – the request was successful, the descriptions are returned in the response
• 403 – the request failed because the api_key was invalid
• 500 – the request failed due to an internal server error

Sample Output

This is a sample of XML output

<?xml version="1.0" encoding="utf-8"?>
<Holdings>
  <holding name="Bedfordshire Libraries" instCode="N006" identity="n006.inst" isbn="0201735172"/>
  <holding name="Blackburn" instCode="0006" identity="0006.inst" isbn="0201735172"/>
  <holding name="Cambridgeshire Libraries & Information Service" instCode="4052" identity="4052.inst" isbn="0201735172"/>
  <holding name="DERBYSHIRE LIBRARIES  QE/P 41" instCode="4041" identity="4041.inst" isbn="0201735172"/>
  <holding name="East Riding of Yorkshire Council, Library and Information Services" instCode="6130" identity="6130.inst" isbn="0201735172"/>
  <holding name="Hampshire County Library and Information Services" instCode="1022" identity="1022.inst" isbn="0201735172"/>
  <holding name="Lancaster University Library" instCode="0112" identity="0112.inst" isbn="0201735172"/>
  <holding name="North Lincolnshire" instCode="6131" identity="6131.inst" isbn="0201735172"/>
  <holding name="Oxfordshire County Council" instCode="1030" identity="1030.inst" isbn="0201735172"/>
  <holding name="Tameside Libraries" instCode="0020" identity="0020.inst" isbn="0201735172"/>
  <holding name="The John Rylands University Library" instCode="0085" identity="0085.inst" isbn="0201735172"/>
  <holding name="The University of Manchester Joule Library" instCode="0091" identity="0091.inst" isbn="0201735172"/>
</Holdings>

The equivilent JSON output is:

{
"Holdings": {
 "0201735172" : [ 
    { "name": "Bedfordshire Libraries", "instCode": "N006", "identifier": "N006.inst" },
    { "name": "Blackburn", "instCode": "0006", "identifier": "0006.inst" },
    { "name": "Cambridgeshire Libraries & Information Service", "instCode": "4052", "identifier": "4052.inst" },
    { "name": "DERBYSHIRE LIBRARIES  QE/P 41", "instCode": "4041", "identifier": "4041.inst" },
    { "name": "East Riding of Yorkshire Council, Library and Information Services", "instCode": "6130", "identifier": "6130.inst" },
    { "name": "Hampshire County Library and Information Services", "instCode": "1022", "identifier": "1022.inst" },
    { "name": "Lancaster University Library", "instCode": "0112", "identifier": "0112.inst" },
    { "name": "North Lincolnshire", "instCode": "6131", "identifier": "6131.inst" },
    { "name": "Oxfordshire County Council", "instCode": "1030", "identifier": "1030.inst" },
    { "name": "Tameside Libraries", "instCode": "0020", "identifier": "0020.inst" },
    { "name": "The John Rylands University Library", "instCode": "0085", "identifier": "0085.inst" },
    { "name": "The University of Manchester Joule Library", "instCode": "0091", "identifier": "0091.inst" }
  ]
}
}