Bibliographic Resource

URLs and Supported Operations

The Bibliographic Resource supports 3 operations.

Operation Resource URL HTTP METHOD Response Code
Create https://worldcat.org/bib/data?inst={inst}&classificationScheme={scheme}&holdingLibraryCode={holdingCode} POST 201
Read https://worldcat.org/bib/data/{oclcNumber}?inst={inst}&classificationScheme={scheme}&holdingLibraryCode={holdingLibraryCode} GET 200
Update https://worldcat.org/bib/data?inst={inst}&classificationScheme={scheme}&holdingLibraryCode={holdingCode} PUT 200

HTTP Accept Types

The Metadata API Bibliographic Record Resource will produce three different representations that can be sent back to clients. All three are representations serialize an AtomPub that wraps a bibliographic record. There are two XML serializations for MARC/XML and OCLC's native CDF records. The third serialization is a translation of the CDF record into JSON:

HTTP Request Content Types

When sending requests to the service to create and update records, you can send the serializations that are either wrapped or unwrapped:

Parameters

Parameter Required? Description Expected/Sample Value
inst No

Registry ID of the institution who is creating/editing the record

Either this parameter or the instSymbol should be sent

 
instSymbol No

OCLC Symbol of the institution who is creating/editing the record

Either this parameter or the inst should be sent

 
classificationScheme Yes The classification scheme
  • DeweyDecimal
  • LibraryOfCongress
  • NationalLibraryOfMedicine
  • NationalAgriculturalLibrary
  • GovernmentDocument
  • UniversalDecimal
  • CanadianNationalLibrary
holdingLibraryCode No Four letter holding code to set the holding on. Valid codes for a given institution can be obtained via a request for holding code resource  

Example Request

Read a bibliographic record with the OCLC Number 319501305:

https://worldcat.org/bib/data/319501305?classificationScheme=LibraryOfCongress

Notes

When updating records, they must include a numeric OCLC Number in the 001 field. Do not include "ocm" or "ocn" prefixes.

 

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 »