Skip to main content
OCLC Support

WorldCat Metadata API 2.0 release notes, April 2025

 

Release Date: April 10, 2025

Introduction

This release of WorldCat Metadata API 2.0 provides two new enhancements. These features will help you manage more complex workflows, including:

  • Records containing errors that have no significant impact on effective use of the record can now be added and replaced.
  • Retrieve branch holding codes and shelving locations with the new "manage/institution-config/branch-shelving-locations" endpoint.

These enhancements are the direct result of your feedback.

New features and enhancements

Records containing errors that have no significant impact on effective use of the record can now be added and replaced

You can now add or replace bibliographic records containing errors that have no significant impact on the effective use of the record. Correcting them is optional. Previously, some minor validation errors prevented users from adding or replacing a bibliographic record. For example, leaving the fixed field element Festschrift (008/30) blank is a minor level validation error that required correction, but now it is acceptable to add or replace a bibliographic record. 

All validation errors can still be viewed using the validateFull parameter with the "/manage/bibs/validate/{validationLevel}" endpoint. 

This enhancement applies to Record Manager as well. See release notes.

Retrieve branch holding codes and shelving locations

GET/worldcat/manage/institution-config/branch-shelving-locations

You can now retrieve branch holding codes or shelving locations within a branch associated with an authenticated institution. Results may be further configured by using the branchLocationLimit or includeShelvingLocations parameters.

Example response: 

{
    "hasProblems": false,
    "id": "91475",
    "institutionNumber": "59357",
    "institutionName": "OCLC Library",
    "oclcSymbol": "OCWMS",
    "branchLocations": [
        {
            "branchLocationId": "125571",
            "branchLocationNumber": "33482",
            "branchLocationName": "OCLC Library West Branch"
        }
    ]
}

Important links

OCLC APIs office hours

Join OCLC APIs Product Management team to ask your questions, get expert advice, and receive in-depth insights about OCLC APIs. Visit OCLC APIs Recordings for information for previous office hour recordings and supporting materials.

Support website(s)

Support information for this product and related products can be found at: