Copy request

Building a query:

To access a collection of copies or local holdings record construct the URL in the following manner:

https://circ.sd00.worldcat.org/LHR?{query}

To access information on a specific copy or local holdings record construct the URL in the following manner::

https://circ.sd00.worldcat.org/LHR/{copyId}

where {query} or {copyId} provide information about the copy or local holdings record you are requesting information for.

Examples:

Below are some sample URLs and an explanation of what they are querying using different HTTP methods:

XML structure for POST and PUT requests:

More information about the proper structure of XML made as part of POST and PUT requests can be found here:

• http://worldcat.org/xmlschemas/copy-platform/1.0/copy-platform-schema-1.0.xsd

Below are two XML payload examples for creating and updating a purchase order:

Creating a copy or local holdings record:

<?xml version='1.0' encoding='UTF-8'?>
  <entry  xmlns='http://www.w3.org/2005/Atom' xmlns:os='http://a9.com/-/spec/opensearch/1.1/' xmlns:gd='http://schemas.google.com/g/2005'>
    <title type='text' />
    <updated>2011-10-07T13:57:43.537Z</updated>
    <content type='application/xml'>
      <copy xmlns='http://worldcat.org/xmlschemas/Copy-1.0' id='https://circ.sd00.worldcat.org/LHR/55171589'>
        <institution>http://www.worldcat.org/webservices/registry/content/Institutions/1</institution>
        <bib>urn:oclc:platform/bibs/33252178</bib>
        <recordType>SERIAL</recordType>
        <receiptStatus>UNKNOWN</receiptStatus>
        <holdingLocation>WAUA</holdingLocation>
        <shelvingLocation>Periodicals</shelvingLocation>
        <shelvingDesignation scheme='UNKNOWN'>
          <information>call</information>
          <itemPart>number</itemPart>
        </shelvingDesignation>
        <holding category='BASIC'>
          <pieceDesignation>64849398475859a</pieceDesignation>
          <caption sequence='1' id='1'>
            <enumeration label='v.'>1</enumeration>
            <enumeration label='no.'>1</enumeration>
            <chronology label='(year)'>2010</chronology>
            <chronology label='(month)'>8</chronology>
          </caption>
        </holding>
        <holding category='BASIC'>
          <pieceDesignation>8741298741209a</pieceDesignation>
          <caption sequence='2' id='1'>
            <enumeration label='v.'>1</enumeration>
            <enumeration label='no.'>2</enumeration>
            <chronology label='(year)'>2010</chronology>
            <chronology label='(month)'>9</chronology>
          </caption>
        </holding>
        <holding category='BASIC'>
          <pieceDesignation>8654323456543a</pieceDesignation>
          <caption sequence='1' id='2'>
            <enumeration label='no.'>10</enumeration>
          </caption>
                  <note type='STAFF'>Back cover missing</note>
                  <cost>
                    <currency>USD</currency>
                        <amount>1000</amount>
                        <qualifier>Replacement cost</qualifier>
                  </cost>
        </holding>
      </copy>
    </content>
  </entry>

If the request is successful, the response will will return newly created copy of local holdings record (with generated ID). 

Updating a copy or local holdings record:

<?xml version='1.0' encoding='UTF-8'?>
  <entry  xmlns="http://www.w3.org/2005/Atom" xmlns:os="http://a9.com/-/spec/opensearch/1.1/" xmlns:gd="http://schemas.google.com/g/2005">
    <title type="text" />
    <updated>2011-10-07T13:57:43.537Z</updated>
    <content type="application/xml">
      <copy xmlns="http://worldcat.org/xmlschemas/Copy-1.0" id="https://circ.sd00.worldcat.org/LHR/55171589">
        <institution>http://www.worldcat.org/webservices/registry/content/Institutions/1</institution>
        <bib>urn:oclc:platform/bibs/33252178</bib>
        <lastUpdateDate>2011-04-13T08:11:58.100Z</lastUpdateDate>
        <recordType>SERIAL</recordType>
        <receiptStatus>UNKNOWN</receiptStatus>
        <holdingLocation>WAUA</holdingLocation>
        <shelvingLocation>Periodicals</shelvingLocation>
        <shelvingDesignation scheme="UNKNOWN">
          <information>call</information>
          <itemPart>number</itemPart>
        </shelvingDesignation>
        <holding category="BASIC">
          <pieceDesignation>64849398475859</pieceDesignation>
          <caption sequence="1" id="1">
            <enumeration label="v.">1</enumeration>
            <enumeration label="no.">1</enumeration>
            <chronology label="(year)">2010</chronology>
            <chronology label="(month)">8</chronology>
          </caption>
        </holding>
        <holding category="BASIC">
          <pieceDesignation>8741298741209</pieceDesignation>
          <caption sequence="2" id="1">
            <enumeration label="v.">1</enumeration>
            <enumeration label="no.">2</enumeration>
            <chronology label="(year)">2010</chronology>
            <chronology label="(month)">9</chronology>
          </caption>
        </holding>
        <holding category="BASIC">
          <pieceDesignation>8654323456543</pieceDesignation>
          <caption sequence="1" id="2">
            <enumeration label="no.">10</enumeration>
          </caption>
          <note type="STAFF">Back cover missing</note>
          <cost>
            <currency>USD</currency>
              <amount>1000</amount>
              <qualifier>Replacement cost</qualifier>
          </cost>
        </holding>
      </copy>
    </content>
  </entry>

Query options:

Below is a list of all the possible parameters that can be used as part of the copy resource, all of them are optional:

Allowed POST/PUT Values:

Below is a table listing all the allowed values and content of each data type in the Collection Management Schema, this should be used as a quick reference into required attributes and values, however a more in depth details can be found using the accompanying XSD file.