Copy response
Examples:
The following examples demonstrate the different operations that can be executed on copies or local holding records using HTTP methods. Please note that none of the examples include the principleID and principleIDNS parameters that are required to successfully complete the operation. The collection management platform service can return data in two possible formats:
| Format | Accept Header | Extension |
|---|---|---|
| Atom XML | application/atom+xml | .xml |
| Atom JSON | application/json | .json |
GET a collection of copies with OCLC number 33252178:
Request:
https://circ.sd00.worldcat.org/LHR/?q=oclc:33252178
XML Response:
<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:os="http://a9.com/-/spec/opensearch/1.1/" xmlns:gd="http://schemas.google.com/g/2005">
<id>urn:oclc:collectionmanagement/copies/1</id>
<title type="text">Copies</title>
<updated>2011-10-10T10:10:11.362Z</updated>
<gd:etag>W/"5dfb11adb86b9874b83dbda853b273d7"</gd:etag>
<os:totalResults>1</os:totalResults>
<os:startIndex>1</os:startIndex>
<os:itemsPerPage>10</os:itemsPerPage>
<entry>
<title type="text" />
<updated>2011-10-10T10:10:11.363Z</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>
</holding>
</copy>
</content>
</entry>
</feed>
JSON Response:
{
"id": "urn:oclc:collectionmanagement/copies/91475",
"title": "Copies",
"updated": "2011-11-30T14:56:57.615Z",
"entries": [
{
"title": "",
"content": {
"institution": "null91475",
"bib": "/bibs/33252178",
"lastUpdateDate": 1302682318100,
"recordType": "SERIAL",
"receiptStatus": "UNKNOWN",
"copyNumber": null,
"note": [],
"holdingLocation": "MAIN",
"shelvingLocation": "3rd Floor",
"previousShelvingLocation": [],
"shelvingDesignation": {
"prefix": [],
"information": "call",
"itemPart": [
"number"
],
"suffix": [],
"scheme": "UNKNOWN"
},
"holding": [
{
"pieceDesignation": [
"64849398475859"
],
"note": [],
"useRestriction": [],
"cost": [],
"temporaryLocation": [],
"caption": {
"description": null,
"enumeration": [
{
"value": "1",
"label": "v."
},
{
"value": "1",
"label": "no."
}
],
"chronology": [
{
"value": "2010",
"label": "(year)"
},
{
"value": "8",
"label": "(month)"
}
],
"id": 1,
"sequence": 1
},
"category": "BASIC"
},
{
"pieceDesignation": [
"8741298741209"
],
"note": [],
"useRestriction": [],
"cost": [],
"temporaryLocation": [],
"caption": {
"description": null,
"enumeration": [
{
"value": "1",
"label": "v."
},
{
"value": "2",
"label": "no."
}
],
"chronology": [
{
"value": "2010",
"label": "(year)"
},
{
"value": "9",
"label": "(month)"
}
],
"id": 1,
"sequence": 2
},
"category": "BASIC"
},
{
"pieceDesignation": [
"8654323456543"
],
"note": [],
"useRestriction": [],
"cost": [],
"temporaryLocation": [],
"caption": {
"description": null,
"enumeration": [
{
"value": "10",
"label": "no."
}
],
"chronology": [],
"id": 2,
"sequence": 1
},
"category": "BASIC"
}
],
"id": "/LHR/55171589?inst=91475"
},
"updated": "2011-11-30T14:56:57.618Z"
}
],
"extensions": [
{
"name": "gd:etag",
"attributes": {
"xmlns:gd": "http://schemas.google.com/g/2005"
},
"children": [
"W/\"cc93002cd39bdb52cec1af1a07b77b0b\""
]
},
{
"name": "os:totalResults",
"attributes": {
"xmlns:os": "http://a9.com/-/spec/opensearch/1.1/"
},
"children": [
"1"
]
},
{
"name": "os:startIndex",
"attributes": {
"xmlns:os": "http://a9.com/-/spec/opensearch/1.1/"
},
"children": [
"1"
]
},
{
"name": "os:itemsPerPage",
"attributes": {
"xmlns:os": "http://a9.com/-/spec/opensearch/1.1/"
},
"children": [
"10"
]
}
]
}
GET a collection of copies with barcode ID 01237001:
Request:
https://circ.sd00.worldcat.org/LHR/?q=barcode:01237001
XML Response:
<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:os="http://a9.com/-/spec/opensearch/1.1/" xmlns:gd="http://schemas.google.com/g/2005">
<id>urn:oclc:collectionmanagement/copies/1</id>
<title type="text">Copies</title>
<updated>2011-10-10T10:12:59.154Z</updated>
<gd:etag>W/"bcc4c640caf03264b3f109917ee1713e"</gd:etag>
<os:totalResults>1</os:totalResults>
<os:startIndex>1</os:startIndex>
<os:itemsPerPage>10</os:itemsPerPage>
<entry>
<title type="text" />
<updated>2011-10-10T10:12:59.156Z</updated>
<content type="application/xml">
<copy xmlns="http://worldcat.org/xmlschemas/Copy-1.0" id="https://circ.sd00.worldcat.org/LHR/28397467">
<institution>http://www.worldcat.org/webservices/registry/content/Institutions/1</institution>
<bib>urn:oclc:platform/bibs/428473187</bib>
<lastUpdateDate>2009-05-15T00:00:00.000Z</lastUpdateDate>
<recordType>SINGLE_PART</recordType>
<receiptStatus>RECEIVED_AND_COMPLETE_OR_CEASED</receiptStatus>
<holdingLocation>WAUB</holdingLocation>
<shelvingDesignation scheme="LIBRARY_OF_CONGRESS">
<prefix>+</prefix>
<information>PZ8.1.H22</information>
<itemPart>P4</itemPart>
</shelvingDesignation>
<holding category="BASIC">
<pieceDesignation>01237001</pieceDesignation>
</holding>
</copy>
</content>
</entry>
</feed>
GET a single copy with ID 55171589:
Request:
https://circ.sd00.worldcat.org/LHR/55171589
XML Response:
<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:os="http://a9.com/-/spec/opensearch/1.1/" xmlns:gd="http://schemas.google.com/g/2005">
<id>urn:oclc:collectionmanagement/copies/1/55171589</id>
<title type="text">Copies</title>
<updated>2011-10-10T10:06:08.031Z</updated>
<gd:etag>"5dfb11adb86b9874b83dbda853b273d7"</gd:etag>
<os:totalResults>1</os:totalResults>
<os:startIndex>1</os:startIndex>
<os:itemsPerPage>1</os:itemsPerPage>
<entry>
<title type="text" />
<updated>2011-10-10T10:06:08.206Z</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>
</holding>
</copy>
</content>
</entry>
</feed>
JSON Response:
{
"id": "urn:oclc:collectionmanagement/copies/91475/55171589",
"title": "Copies",
"updated": "2011-11-30T14:54:04.262Z",
"entries": [
{
"title": "",
"content": {
"institution": "null91475",
"bib": "/bibs/33252178",
"lastUpdateDate": 1302682318100,
"recordType": "SERIAL",
"receiptStatus": "UNKNOWN",
"copyNumber": null,
"note": [],
"holdingLocation": "MAIN",
"shelvingLocation": "3rd Floor",
"previousShelvingLocation": [],
"shelvingDesignation": {
"prefix": [],
"information": "call",
"itemPart": [
"number"
],
"suffix": [],
"scheme": "UNKNOWN"
},
"holding": [
{
"pieceDesignation": [
"64849398475859"
],
"note": [],
"useRestriction": [],
"cost": [],
"temporaryLocation": [],
"caption": {
"description": null,
"enumeration": [
{
"value": "1",
"label": "v."
},
{
"value": "1",
"label": "no."
}
],
"chronology": [
{
"value": "2010",
"label": "(year)"
},
{
"value": "8",
"label": "(month)"
}
],
"id": 1,
"sequence": 1
},
"category": "BASIC"
},
{
"pieceDesignation": [
"8741298741209"
],
"note": [],
"useRestriction": [],
"cost": [],
"temporaryLocation": [],
"caption": {
"description": null,
"enumeration": [
{
"value": "1",
"label": "v."
},
{
"value": "2",
"label": "no."
}
],
"chronology": [
{
"value": "2010",
"label": "(year)"
},
{
"value": "9",
"label": "(month)"
}
],
"id": 1,
"sequence": 2
},
"category": "BASIC"
},
{
"pieceDesignation": [
"8654323456543"
],
"note": [],
"useRestriction": [],
"cost": [],
"temporaryLocation": [],
"caption": {
"description": null,
"enumeration": [
{
"value": "10",
"label": "no."
}
],
"chronology": [],
"id": 2,
"sequence": 1
},
"category": "BASIC"
}
],
"id": "/LHR/55171589?inst=91475"
},
"updated": "2011-11-30T14:54:04.267Z"
}
],
"extensions": [
{
"name": "gd:etag",
"attributes": {
"xmlns:gd": "http://schemas.google.com/g/2005"
},
"children": [
"\"cc93002cd39bdb52cec1af1a07b77b0b\""
]
},
{
"name": "os:totalResults",
"attributes": {
"xmlns:os": "http://a9.com/-/spec/opensearch/1.1/"
},
"children": [
"1"
]
},
{
"name": "os:startIndex",
"attributes": {
"xmlns:os": "http://a9.com/-/spec/opensearch/1.1/"
},
"children": [
"1"
]
},
{
"name": "os:itemsPerPage",
"attributes": {
"xmlns:os": "http://a9.com/-/spec/opensearch/1.1/"
},
"children": [
"1"
]
}
]
}
POST XML to create a new copy:
Request:
https://circ.sd00.worldcat.org/LHR
XML Payload:
<?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>
Response:
<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:os="http://a9.com/-/spec/opensearch/1.1/" xmlns:gd="http://schemas.google.com/g/2005">
<id>urn:oclc:collectionmanagement/copies/1/new</id>
<title type="text">Copies</title>
<updated>2011-10-10T10:20:13.662Z</updated>
<gd:etag>"23ab9ad7992c2097a781bca6c5aa5896"</gd:etag>
<os:totalResults>1</os:totalResults>
<os:startIndex>1</os:startIndex>
<os:itemsPerPage>1</os:itemsPerPage>
<entry>
<title type="text" />
<updated>2011-10-10T10:20:13.663Z</updated>
<content type="application/xml">
<copy xmlns="http://worldcat.org/xmlschemas/Copy-1.0" id="https://circ.sd00.worldcat.org/LHR/77772189">
<institution>http://www.worldcat.org/webservices/registry/content/Institutions/1</institution>
<bib>urn:oclc:platform/bibs/33252178</bib>
<lastUpdateDate>2011-10-10T10:20:13.425Z</lastUpdateDate>
<recordType>SERIAL</recordType>
<receiptStatus>UNKNOWN</receiptStatus>
<copyNumber>2</copyNumber>
<holdingLocation>WAUA</holdingLocation>
<shelvingLocation>Periodicals</shelvingLocation>
<shelvingDesignation scheme="UNKNOWN">
<information>call</information>
<itemPart>number</itemPart>
</shelvingDesignation>
<holding category="BASIC">
<pieceDesignation>64849398475859a</pieceDesignation>
</holding>
<holding category="BASIC">
<pieceDesignation>8741298741209a</pieceDesignation>
</holding>
<holding category="BASIC">
<pieceDesignation>8654323456543a</pieceDesignation>
<note type="STAFF">Back cover missing</note>
<cost>
<currency>USD</currency>
<amount>1000</amount>
<qualifier>Replacement cost</qualifier>
</cost>
</holding>
</copy>
</content>
</entry>
</feed>
PUT XML to update an existing copy:
Request:
https://circ.sd00.worldcat.org/LHR/55171589
XML Payload:
<?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>
Response:
<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:os="http://a9.com/-/spec/opensearch/1.1/" xmlns:gd="http://schemas.google.com/g/2005">
<id>urn:oclc:collectionmanagement/copies/1/55171589</id>
<title type="text">Copies</title>
<updated>2011-10-10T10:14:20.857Z</updated>
<gd:etag>"54efab8eed2c28d7c1bc188a20871ae2"</gd:etag>
<os:totalResults>1</os:totalResults>
<os:startIndex>1</os:startIndex>
<os:itemsPerPage>1</os:itemsPerPage>
<entry>
<title type="text" />
<updated>2011-10-10T10:14:20.858Z</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-10-10T10:14:20.563Z</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>
</holding>
<holding category="BASIC">
<pieceDesignation>8741298741209</pieceDesignation>
</holding>
<holding category="BASIC">
<pieceDesignation>8654323456543</pieceDesignation>
<note type="STAFF">Back cover missing</note>
<cost>
<currency>USD</currency>
<amount>1000</amount>
<qualifier>Replacement cost</qualifier>
</cost>
</holding>
</copy>
</content>
</entry>
</feed>
DELETE a copy by ID:
Request:
https://circ.sd00.worldcat.org/LHR/55171589
Response:
// Empty Response // HTTP Status 200 OK returned
The OCLC Developer Network supports the use of OCLC Web Services—a set of tools and APIs that expose data and services for WorldCat and our member libraries and partner institutions or companies. learn more »
© 2010 OCLC Domestic and international trademarks and/or service marks of OCLC Online Computer Library Center, Inc. and its affiliates
Follow the OCLC Developer Network: