Copy Resource

URLs and Supported Requests

The Copy Resource supports five operations.

Operation Resource URL HTTP METHOD
Create https://circ.sd00.worldcat.org/LHR?inst={WorldCat_Registry_ID} POST
Read https://circ.sd00.worldcat.org/LHR/{copyId}?inst={WorldCat_Registry_ID} GET
Update https://circ.sd00.worldcat.org/LHR/{copyId}?inst={WorldCat_Registry_ID} PUT
Delete https://circ.sd00.worldcat.org/LHR/{copyId}?inst={WorldCat_Registry_ID} DELETE
Search https://circ.sd00.worldcat.org/LHR??inst={WorldCat_Registry_ID}q=oclc:{OCLC_number} GET

HTTP Accept Types

HTTP Request Content Types

Schema

When making a PUT/POST request an XML payload must be included. More information about the proper structure of XML made as part of POST and PUT requests can be found here with the Copy Schema File.

Parameters

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

Parameter Required Description
inst Yes The institution's WorldCat Registry ID
principalID Yes An identifier that represents the user making the request
principalIDNS Yes The namespace for the principalID
q No Refer to the query indices table below. Available parameters are: oclc or barcode. The values for these parameters must either be an OCLC number of barcode number respectively.
startIndex

 

No

 

What index item to start the collection at.
itemsPerPage No How many collection items to return per request.

Query Indices

Index Description
oclc Number of OCLC item or items you want to retrieve
barcode item-level barcode for circulating materials

Copy Resource Fields

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 more in depth details can be found using the accompanying XSD file.

NAME RESTRICTIONS MAY CONTAIN DESCRIPTION
recordType

SINGLE_PART

MULTI_PART

SERIAL

UNKNOWN

  The characteristics and definitions of the components of the record.
receiptStatus

ON_ORDER

CURRENTLY_RECEIVED

NOT_CURRENTLY_RECEIVED

RECEIVED_AND_COMPLETE _OR_CEASED

OTHER_RECEIPT_OR_     ACQUISITIONS_STATUS

UNKNOWN

  Indicates the current receipt or acquisitions status of a copy (008/06).
noteVisibilityType

PUBLIC

STAFF

  Enumeration of the types of note describing an item.

noteType

Required attribute:(attr:noteVisibilityType) type:

    A user defined note that can be attached to a copy or an individual holding.
holdingLocationType String that must match  pattern "[A-Z]{4}"   Represents a holding location. OCLC cataloguing rules require that the holding location is a single 4-character code. Corresponds to 852$b.

shelvingDesignation Type

Required attribute:(attr:shelvingSchemeType) scheme

 

(string) prefix

(string) information

(string) itemPart

(string) suffix

The designation used as the shelving scheme for an item. The value of the shelving scheme determines which fields are used.
itemCategoryType

BASIC

SUPPLEMENTARY_MATERIAL

INDEX

  The different categories of material for items.
pieceDesignationType String that must match pattern "[^BU].*"   Represents the institution-defined piece designation for an item. This is the "barcode". It should not start with either a capital 'B' or 'U'.
currencyType String that must match pattern "[A-Z]{3}"   The ISO 4217 currency code for representing the currency of a monetary amount. Categorised by 3 capital letters. The current valid 3-letter codes can be found at http://www.bsi-global.com
costType  

(currencyType) currency

(nonNegativeInteger) amount

(string) qualifier

A cost associated with an item, such as the original purchase price, or the amount to bill a patron if the item is lost.

captionEntryType

Required attribute:(attr:string) label

    The label and value pair for a caption describing a numeric, alphabetic, and/or date designation for an item. The label is defined as an attribute on the element and the value for the label is defined by the element contents.
captionType  

(string) description

(captionEntryType) enumeration

(captionEntryType) chronology

(nonNegativeInteger) id

(nonNegativeInteger) sequence

A set of alphanumeric or date labels (i.e. enumeration and chronology) for an item. Also includes free-text version when standard enumeration and chronology cannot be used to adequately describe the item.

holdingType

Required attraibute:(attr:itemCategoryType) category

 

(pieceDesignationType) pieceDesignation

(noteType) note

(string) useRestriction

(costType) cost

(string) temporaryLocation

(captionType) caption

The information relating to a particular holding associated with a copy.
copyType  

(anyURI) institution

(anyURI) bib

(dateTime) lastUpdateDate

(recordType) recordType

(receiptStatusType) receiptStatus

(integer) copyNumber

(noteType) note

(holdingLocationType) holdingLocation

(string) shelvingLocation

(string) previousShelvingLocation

(shelvingDesignationType) shelvingDesignation

(holdingType) holding

(anyURI) id

A specific instance within a library collection of a bibliographic description. May consist of multiple items in the case of multi-volume sets and seri

Example URLs

Read a collection of copies with OCLC number 33252178:

GET https://circ.sd00.worldcat.org/LHR/?q=oclc:33252178

Read a single copy with ID 55171589:

GET https://circ.sd00.worldcat.org/LHR/55171589

Create a new copy:

POST XML https://circ.sd00.worldcat.org/LHR

XML Payload

Update a specific copy with ID 55171589:

PUT XML https://circ.sd00.worldcat.org/LHR/55171589

XML Payload

Delete a copy with ID 55171589:

DELETE https://circ.sd00.worldcat.org/LHR/55171589

 

We are a worldwide library cooperative, owned, governed and sustained by members since 1967. Our public purpose is a statement of commitment to each other—that we will work together to improve access to the information held in libraries around the globe, and find ways to reduce costs for libraries through collaboration. Learn more »