WorldCat Manage Institution API

openapi: 3.2.0
info:
  description: WorldCat Metadata API
  version: 2.0.0
  title: WorldCat Metadata Manage Institution API
servers:
- url: https://metadata.api.oclc.org
  description: PROD
security:
- worldcat_metadata_auth:
  - WorldCatMetadataAPI
tags:
- name: Manage Institution
paths:
  /worldcat/manage/institution/holdings/current:
    get:
      tags:
      - Manage Institution
      summary: Retrieve the current institution holdings for Bibliographic records from WorldCat.
      description: Given one or more OCLC Numbers (up to 10), check WorldCat for the institution holdings. It will return current institution holdings information associated w/ the OCLC Number(s) provided. If an OCLC Number does not exist or is invalid, a result of null is returned for the current control number.
      operationId: get-current-holdings
      parameters:
      - $ref: '#/components/parameters/oclcNumberListReq'
      responses:
        '200':
          description: The current holdings were retrieved successfully.
          content:
            application/json:
              examples:
                success:
                  value:
                    holdings:
                    - requestedControlNumber: '1'
                      currentControlNumber: '1'
                      institutionSymbol: OCWMS
                      holdingSet: true
                    - requestedControlNumber: '261176486'
                      currentControlNumber: '311684437'
                      institutionSymbol: OCWMS
                      holdingSet: true
                    - requestedControlNumber: '999999999999'
                      currentControlNumber: null
                      institutionSymbol: OCWMS
                      holdingSet: false
        '400':
          description: Bad request. The request was unacceptable.
          content:
            application/json:
              examples:
                non-numeric-control-number-provided:
                  summary: Non-Numeric Control Number
                  value:
                    type: BAD_REQUEST
                    title: 'Invalid value provided for query param: oclcNumbers.'
                    detail: 'A request with an invalid query param value was attempted: oclcNumbers=[abc]'
                too-many-control-numbers-provided:
                  summary: Too Many Control Numbers
                  value:
                    type: BAD_REQUEST
                    title: 'Too many values provided for query parameter: oclcNumbers'
                    detail: A maximum of 10 values can be provided for a given request
        '401':
          $ref: '#/components/responses/unauthorized'
        '403':
          $ref: '#/components/responses/403-forbidden-url'
        '406':
          $ref: '#/components/responses/406-accept-header-unacceptable'
        '500':
          $ref: '#/components/responses/500-internal-server-error'
      security:
      - worldcat_metadata_auth:
        - WorldCatMetadataAPI:manage_institution_holdings
  /worldcat/manage/institution/holdings/set:
    post:
      tags:
      - Manage Institution
      summary: Set a holding on a Bibliographic record.
      description: 'Given a Bibliographic record, unset a holding on the record. Note: ONLY one record is allowed in the request body.'
      operationId: set-a-holding
      responses:
        '200':
          description: The holding was set successfully.
          content:
            application/json:
              examples:
                holding-set:
                  $ref: '#/components/examples/holding-set'
                holding-already-set:
                  $ref: '#/components/examples/holding-already-set'
        '400':
          description: Bad request. The request was unacceptable.
          content:
            application/json:
              examples:
                xml-missing-control-number:
                  $ref: '#/components/examples/xml-missing-control-number-set'
                xml-has-parsing-errors:
                  $ref: '#/components/examples/xml-has-parsing-errors'
                xml-has-missing-or-unusable-data:
                  $ref: '#/components/examples/xml-has-missing-or-unusable-data'
                xml-hdas-validation-errors:
                  $ref: '#/components/examples/xml-has-validation-errors'
        '401':
          $ref: '#/components/responses/unauthorized'
        '403':
          $ref: '#/components/responses/403-forbidden-url'
        '404':
          $ref: '#/components/responses/failed-not-found'
        '406':
          $ref: '#/components/responses/406-accept-header-unacceptable'
        '500':
          $ref: '#/components/responses/500-internal-server-error'
      requestBody:
        description: The Bibliographic record to set the holding on.
        required: true
        content:
          application/marcxml+xml:
            schema:
              $ref: '#/components/schemas/MARCXML'
            examples:
              MARCXML:
                $ref: '#/components/examples/bib-marcxml-existing'
          application/marc:
            schema:
              type: string
            examples:
              MARC21:
                $ref: '#/components/examples/bib-marc-existing'
      security:
      - worldcat_metadata_auth:
        - WorldCatMetadataAPI:manage_institution_holdings
  /worldcat/manage/institution/holdings/unset:
    post:
      tags:
      - Manage Institution
      summary: Unset a holding on a Bibliographic record.
      description: 'Given a Bibliographic record, unset a holding on the record. Note: ONLY one record is allowed in the request body.'
      operationId: unset-a-holding
      parameters:
      - name: cascadeDelete
        in: query
        description: Remove associated Local Bibliographic Data and/or Local Holdings Records when unsetting the holding
        required: false
        schema:
          type: boolean
          default: true
          enum:
          - true
          - false
      responses:
        '200':
          description: The holding was unset successfully.
          content:
            application/json:
              examples:
                holding-unset:
                  $ref: '#/components/examples/holding-unset'
                holding-already-unset:
                  $ref: '#/components/examples/holding-already-unset'
                holding-unset-blocked-by-lbds:
                  $ref: '#/components/examples/holding-unset-blocked-by-lbds'
                holding-unset-blocked-by-lhrs:
                  $ref: '#/components/examples/holding-unset-blocked-by-lhrs'
                holding-unset-blocked-by-lbds-and-lhrs:
                  $ref: '#/components/examples/holding-unset-blocked-by-lbds-and-lhrs'
        '400':
          description: Bad request. The request was unacceptable.
          content:
            application/json:
              examples:
                non-boolean-cascade-delete:
                  $ref: '#/components/examples/non-boolean-cascade-delete'
                xml-missing-control-number:
                  $ref: '#/components/examples/xml-missing-control-number-unset'
                xml-has-parsing-errors:
                  $ref: '#/components/examples/xml-has-parsing-errors'
                xml-has-missing-or-unusable-data:
                  $ref: '#/components/examples/xml-has-missing-or-unusable-data'
                xml-hdas-validation-errors:
                  $ref: '#/components/examples/xml-has-validation-errors'
        '401':
          $ref: '#/components/responses/unauthorized'
        '403':
          $ref: '#/components/responses/403-forbidden-url'
        '404':
          $ref: '#/components/responses/failed-not-found'
        '406':
          $ref: '#/components/responses/406-accept-header-unacceptable'
        '500':
          $ref: '#/components/responses/500-internal-server-error'
      requestBody:
        description: The Bibliographic record to unset the holding on.
        required: true
        content:
          application/marcxml+xml:
            schema:
              $ref: '#/components/schemas/MARCXML'
            examples:
              MARCXML:
                $ref: '#/components/examples/bib-marcxml-existing'
          application/marc:
            schema:
              type: string
            examples:
              MARC21:
                $ref: '#/components/examples/bib-marc-existing'
      security:
      - worldcat_metadata_auth:
        - WorldCatMetadataAPI:manage_institution_holdings
  /worldcat/manage/institution/holdings/{oclcNumber}/set:
    post:
      tags:
      - Manage Institution
      summary: Set the holding on a Bibliographic record for an institution by OCLC Number.
      description: Given an Identifier (OCLC Number), set the holding on the appropriate Bibliographic record.
      operationId: set-holding-for-one-or-multiple-institutions
      parameters:
      - name: oclcNumber
        description: The Identifier is the OCLC Number.
        in: path
        required: true
        schema:
          oneOf:
          - $ref: '#/components/schemas/schemas-OclcNumber'
        examples:
          oclcNumber:
            value: 1234567890
      responses:
        '200':
          description: The holding was set successfully.
          content:
            application/json:
              examples:
                holding-set:
                  $ref: '#/components/examples/holding-set'
                holding-already-set:
                  $ref: '#/components/examples/holding-already-set'
        '400':
          description: Bad request. The request was unacceptable.
          content:
            application/json:
              examples:
                non-numeric-oclc-number:
                  $ref: '#/components/examples/non-numeric-oclc-number'
                bib-not-found:
                  $ref: '#/components/examples/bib-not-found'
        '401':
          $ref: '#/components/responses/unauthorized'
        '403':
          $ref: '#/components/responses/403-forbidden-url'
        '404':
          $ref: '#/components/responses/failed-not-found'
        '406':
          $ref: '#/components/responses/failed-not-acceptable'
        '500':
          $ref: '#/components/responses/500-internal-server-error'
      security:
      - worldcat_metadata_auth:
        - WorldCatMetadataAPI:manage_institution_holdings
  /worldcat/manage/institution/holdings/{oclcNumber}/unset:
    post:
      tags:
      - Manage Institution
      summary: Unset the holding on a Bibliographic record for an institution by OCLC Number.
      description: Given an Identifier (OCLC Number), unset the holding on the appropriate Bibliographic record.
      operationId: Unset-holding-for-one-or-multiple-institutions
      parameters:
      - name: oclcNumber
        description: The Identifier is the OCLC Number.
        in: path
        required: true
        schema:
          oneOf:
          - $ref: '#/components/schemas/schemas-OclcNumber'
        examples:
          oclcNumber:
            value: 1234567890
      - name: cascadeDelete
        in: query
        description: Remove associated Local Bibliographic Data and/or Local Holdings Records when unsetting the holding
        required: false
        schema:
          type: boolean
          default: true
          enum:
          - true
          - false
      responses:
        '200':
          description: The holding was unset successfully.
          content:
            application/json:
              examples:
                holding-unset:
                  $ref: '#/components/examples/holding-unset'
                holding-already-unset:
                  $ref: '#/components/examples/holding-already-unset'
                holding-unset-blocked-by-lbds:
                  $ref: '#/components/examples/holding-unset-blocked-by-lbds'
                holding-unset-blocked-by-lhrs:
                  $ref: '#/components/examples/holding-unset-blocked-by-lhrs'
                holding-unset-blocked-by-lbds-and-lhrs:
                  $ref: '#/components/examples/holding-unset-blocked-by-lbds-and-lhrs'
        '400':
          description: Bad request. The request was unacceptable.
          content:
            application/json:
              examples:
                non-boolean-cascade-delete:
                  $ref: '#/components/examples/non-boolean-cascade-delete'
                non-numeric-oclc-number:
                  $ref: '#/components/examples/non-numeric-oclc-number'
                bib-not-found:
                  $ref: '#/components/examples/bib-not-found'
        '401':
          $ref: '#/components/responses/unauthorized'
        '403':
          $ref: '#/components/responses/403-forbidden-url'
        '404':
          $ref: '#/components/responses/failed-not-found'
        '406':
          $ref: '#/components/responses/406-accept-header-unacceptable'
        '500':
          $ref: '#/components/responses/500-internal-server-error'
      security:
      - worldcat_metadata_auth:
        - WorldCatMetadataAPI:manage_institution_holdings
  /worldcat/manage/institution/holdings/move:
    post:
      tags:
      - Manage Institution
      summary: Move a holding from one Bibliographic record to another.
      description: Given source and target OCLC numbers, move the holdings from the source to the target.
      operationId: move-holdings
      requestBody:
        description: The source and target OCLC numbers
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MoveHoldings'
            examples:
              success-single-holding:
                value:
                  sourceOclcNumber: '1'
                  targetOclcNumber: null
      responses:
        '200':
          description: The Holding Codes were retrieved successfully.
          content:
            application/json:
              examples:
                success-lbds:
                  value:
                  - sourceControlNumber: '1'
                  - requestedSourceControlNumber: '1'
                  - targetControlNumber: '2'
                  - requestedTargetControlNumber: '2'
                  - success: true
                  - message: Successfully set holding and moved local bibliographic data (LBD) to bibliographic record {target OCN}.
                  - action: Move Holdings
                success-lhrs:
                  value:
                  - sourceControlNumber: '1'
                  - requestedSourceControlNumber: '1'
                  - targetControlNumber: '2'
                  - requestedTargetControlNumber: '2'
                  - success: true
                  - message: Successfully set holding and moved local holdings record (LHR) to bibliographic record {target OCN}.
                  - action: Move Holdings
                success-lbds-and-lhrs:
                  value:
                  - sourceControlNumber: '1'
                  - requestedSourceControlNumber: '1'
                  - targetControlNumber: '2'
                  - requestedTargetControlNumber: '2'
                  - success: true
                  - message: Successfully set holding and moved local bibliographic data (LBD) and local holdings records (LHRs) to bibliographic record {target OCN}.
                  - action: Move Holdings
                success-lhrs-and-some-lbds:
                  value:
                  - sourceControlNumber: '1'
                  - requestedSourceControlNumber: '1'
                  - targetControlNumber: '2'
                  - requestedTargetControlNumber: '2'
                  - success: true
                  - message: Successfully set holding. Unable to move all local bibliographic data (LBD) to bibliographic record {target OCN}.
                  - action: Move Holdings
                success-not-all-lhrs-and-lbds:
                  value:
                  - sourceControlNumber: '1'
                  - requestedSourceControlNumber: '1'
                  - targetControlNumber: '2'
                  - requestedTargetControlNumber: '2'
                  - success: true
                  - message: Successfully set holding. Unable to move all local bibliographic data (LBD) and local holdings records (LHRs) to bibliographic record {target OCN}.
                  - action: Move Holdings
        '400':
          description: Bad request. The request was unacceptable.
          content:
            application/json:
              examples:
                source-non-numeric:
                  value:
                  - type: BAD_REQUEST
                  - title: Source OCLC number invalid
                  - detail: A non-numeric source OCLC number was provided
                target-non-numberic:
                  value:
                  - type: BAD_REQUEST
                  - title: Target OCLC number invalid.
                  - detail: A non-numeric target OCLC number was provided.
                source-and-target-identical:
                  value:
                  - type: BAD_REQUEST
                  - title: Source and target OCLC number identical.
                  - detail: Identical source and target OCLC numbers were provided.
                unusable-body:
                  value:
                  - type: BAD_REQUEST
                  - title: Invalid body content.
                  - detail: 'A request with an invalid body content was attempted:  null'
        '406':
          $ref: '#/components/responses/406-accept-header-unacceptable'
        '409':
          description: Conflict. The request could not be completed due to a conflict with the current state of the target resource.
          content:
            application/json:
              examples:
                source-not-found:
                  value:
                  - type: CONFLICT
                  - title: Source OCLC number not found.
                  - detail: Unable to find the provided source OCLC number.
                target-not-found:
                  value:
                  - type: CONFLICT
                  - title: Target OCLC number not found.
                  - detail: Unable to find the provided target OCLC number.
                no-lbds-or-lhrs:
                  value:
                  - type: CONFLICT
                  - title: No local bibliographic data (LBD) or local holdings records (LHRs).
                  - detail: Move Holdings Failed. No local bibliographic data (LBD) or local holdings records (LHRs) are attached to the bibliographic record (source OCN).
      security:
      - worldcat_metadata_auth:
        - WorldCatMetadataAPI:manage_institution_holdings
  /worldcat/manage/institution/holding-codes:
    get:
      tags:
      - Manage Institution
      summary: Retrieve Holding Codes
      description: Retrieve all the Holding Codes associated with the authenticated institution.
      operationId: retrieve-holding-codes
      responses:
        '200':
          description: The Holding Codes were retrieved successfully.
          content:
            application/json:
              examples:
                success:
                  value:
                    holdingLibraryCodes:
                    - code: ABCL
                      name: Engineering Library
                    - code: DEFJ
                      name: Auxilliary Storage
                    - code: GHIO
                      name: Music Library
                    - code: JKLU
                      name: Drama Library
        '401':
          $ref: '#/components/responses/unauthorized'
        '403':
          $ref: '#/components/responses/403-forbidden-url'
        '404':
          $ref: '#/components/responses/failed-not-found'
        '406':
          $ref: '#/components/responses/406-accept-header-unacceptable'
        '500':
          $ref: '#/components/responses/500-internal-server-error'
      security:
      - worldcat_metadata_auth:
        - WorldCatMetadataAPI:manage_bibs
        - WorldCatMetadataAPI:get_holding_codes
  /worldcat/manage/institution-config/branch-shelving-locations:
    get:
      tags:
      - Manage Institution
      parameters:
      - $ref: '#/components/parameters/accept'
      - $ref: '#/components/parameters/includeShelvingLocations'
      - $ref: '#/components/parameters/branchLocationLimit'
      responses:
        '200':
          $ref: '#/components/responses/success-read-institution-branch-config'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
              examples:
                missing-single-required-query-parameter:
                  $ref: '#/components/examples/missing-single-required-query-parameter'
          description: Bad request. The request was unacceptable, often due to missing required or invalid/unsupported parameter(s)
        '401':
          $ref: '#/components/responses/unauthorized'
        '403':
          $ref: '#/components/responses/forbidden'
        '405':
          $ref: '#/components/responses/method-not-supported'
        '406':
          $ref: '#/components/responses/failed-not-acceptable'
        '500':
          $ref: '#/components/responses/internal-server-error'
      operationId: manage-institution-branch-config
      summary: Retrieve branch holding codes and shelving locations
      description: Retrieve branch holding codes or shelving locations within a branch associated with an authenticated institution.
      security:
      - worldcat_metadata_auth:
        - WorldCatMetadataAPI:get_holding_codes
        - WorldCatMetadataAPI:manage_bibs
  /worldcat/search/institution:
    get:
      tags:
      - Manage Institution
      parameters:
      - $ref: '#/components/parameters/accept'
      - $ref: '#/components/parameters/registryIds'
      - $ref: '#/components/parameters/oclcSymbols'
      responses:
        '200':
          $ref: '#/components/responses/success-read-institution-branch-config'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
              examples:
                missing-single-required-query-parameter:
                  $ref: '#/components/examples/missing-single-required-query-parameter'
          description: Bad request. The request was unacceptable, often due to missing required or invalid/unsupported parameter(s)
        '401':
          $ref: '#/components/responses/unauthorized'
        '403':
          $ref: '#/components/responses/forbidden'
        '405':
          $ref: '#/components/responses/method-not-supported'
        '406':
          $ref: '#/components/responses/failed-not-acceptable'
        '500':
          $ref: '#/components/responses/internal-server-error'
      operationId: find-institution-by-identifier
      summary: Fetch Identifiers for an Institution
      description: Fetch Identifiers for an Institution
      security:
      - worldcat_metadata_auth:
        - WorldCatMetadataAPI:get_holding_codes
        - WorldCatMetadataAPI:manage_bibs
components:
  schemas:
    SourceOclcNumber:
      description: The holding library symbol to move from
      type: string
    schemas-OclcNumber:
      description: the oclc number of a given bibliographic record
      type: integer
      format: int64
      example: 61253844
    TargetOclcNumber:
      description: The holding library symbol to move to
      type: string
    OclcNumber:
      description: the oclc number of a given bibliographic record
      type: integer
      format: int64
    InstitutionBranchConfig:
      type: object
      properties:
        hasProblems:
          type: boolean
        id:
          type: integer
        institutionNumber:
          type: string
        institutionName:
          type: string
        oclcSymbol:
          $ref: '#/components/schemas/OCLCSymbol'
        branchLocations:
          type: array
          items:
            $ref: '#/components/schemas/BranchLocations'
    MoveHoldings:
      description: Move holdings for an institution
      type: object
      properties:
        sourceOclcNumber:
          $ref: '#/components/schemas/SourceOclcNumber'
        targetOclcNumber:
          $ref: '#/components/schemas/TargetOclcNumber'
    RegistryId:
      description: The identifier in the WorldCat Registry for the institution
      type: integer
    BranchLocations:
      type: object
      properties:
        branchLocationId:
          type: string
        branchLocationNumber:
          type: string
        branchLocationName:
          type: string
        branchLocationHoldingCode:
          type: string
        branchLocationHoldingSymbol:
          type: string
        defaultHoldingSymbol:
          type: boolean
        shelvingLocations:
          type: array
          items:
            type: string
        shelvingLocationScheme:
          type: string
    MARCXML:
      description: see https://www.loc.gov/standards/marcxml/schema/MARC21slim.xsd
      type: object
      xml:
        name: record
      externalDocs:
        description: Learn about the Marc Bibliographic Standard
        url: https://www.loc.gov/standards/marcxml/
    ProblemType:
      description: A URI reference [RFC3986] that identifies the problem type.
      type: string
      format: uri
      enum:
      - https://developer.api.oclc.org/errors/NOT_ACCEPTABLE
      - https://developer.api.oclc.org/errors/NOT_ALLOWED
      - https://developer.api.oclc.org/errors/INTERAL_SERVER_ERROR
      - https://developer.api.oclc.org/errors/BAD_REQUEST
      - https://developer.api.oclc.org/errors/NOT_FOUND
      - https://developer.api.oclc.org/errors/NOT_ELIGIBLE
      - https://developer.api.oclc.org/errors/MISSING_QUERY_PARAMETER
      - https://developer.api.oclc.org/errors/INVALID_QUERY_PARAMETERS
      - https://developer.api.oclc.org/errors/INVALID_QUERY_PARAMETER_VALUE
      - https://developer.api.oclc.org/errors/INVALID_QUERY_PARAMETER_NAME
      - https://developer.api.oclc.org/errors/SYNTAX_ERROR
      - https://developer.api.oclc.org/errors/INVALID_DOCUMENT
      - https://developer.api.oclc.org/errors/MISSING_ELEMENT
      - https://developer.api.oclc.org/errors/INVALID_ELEMENT_VALUE
    Problem:
      type: object
      description: RFC 7807 description of an error.
      properties:
        type:
          $ref: '#/components/schemas/ProblemType'
        title:
          description: A short, human-readable summary of the problem type.
          type: string
        instance:
          description: A URI reference that identifies the specific occurrence of the problem.
          type: string
          format: uri
        detail:
          description: A human-readable explanation specific to this occurrence of the problem.,
          type: string
        invalidParams:
          description: An array of validation errors.
          type: array
          items:
            description: The validation error descriptor.
            type: object
            properties:
              path:
                type: string
              name:
                type: string
              reason:
                type: string
    OCLCSymbol:
      description: institution OCLC Symbol. Special characters need to be encoded properly.
      type: string
      minLength: 3
      maxLength: 8
      pattern: ^[a-zA-Z0-9@*&#%+$/]{1,}$
  examples:
    bib-not-found:
      summary: Bibliographic Record Not Found
      value:
        type: BAD_REQUEST
        title: Unable to perform the bib read operation.
        detail:
          summary: NOT_FOUND
          description: Not able to find the requested Bib
    unauthorized:
      summary: Error returned when valid API credentials not sent or invalid
      value:
        message: Unauthorized
    method-not-allowed-error:
      summary: Error when invalid HTTP method used
      value:
        title: NOT_ALLOWED
        detail: POST method not allowed
    branchesShelvingLocations:
      summary: Show branch and shelving location information
      value:
        hasProblems: false
        id: '91475'
        institutionNumber: '59357'
        institutionName: OCLC Library
        oclcSymbol: OCWMS
        branchLocations:
        - branchLocationId: '125573'
          branchLocationNumber: '33484'
          branchLocationName: OCLC Library South Branch
          branchLocationHoldingCode: SOUT
          branchLocationHoldingSymbol: OCWMS
          defaultHoldingSymbol: false
          shelvingLocations:
          - eBooks
          - EUS Shelving Location
          - SOUT Periodicals test
          - SOUT-Periodicals
          - SOUT-Reference
          - SOUT-STACKS
          shelvingLocationScheme: Library of Congress
        - branchLocationId: '125569'
          branchLocationNumber: '33481'
          branchLocationName: OCLC Library Main Branch
          branchLocationHoldingCode: MAIN
          branchLocationHoldingSymbol: OCWMS
          defaultHoldingSymbol: true
          shelvingLocations:
          - AVAILABLE HOLDS Only
          - MAIN-NO RENEWAL
          - MAIN-Periodicals
          - MAIN-Reference
          - MAIN-STACKS
          - NOT Available HOLDS Only
          shelvingLocationScheme: Library of Congress
        - branchLocationId: '125571'
          branchLocationNumber: '33482'
          branchLocationName: OCLC Library West Branch
          branchLocationHoldingCode: WEST
          branchLocationHoldingSymbol: OCWMS
          defaultHoldingSymbol: false
          shelvingLocations:
          - WEST Periodicals test
          - WEST-Periodicals
          - WEST-Reference
          - WEST-STACKS
          shelvingLocationScheme: Library of Congress
        - branchLocationId: '125572'
          branchLocationNumber: '33483'
          branchLocationName: OCLC Library North Branch OCLC Library North Branch
          branchLocationHoldingCode: NORT
          branchLocationHoldingSymbol: OCWMS
          defaultHoldingSymbol: false
          shelvingLocations:
          - NORT Periodicals test
          - NORT-Periodicals
          - NORT-Reference
          - NORT-STACKS
          shelvingLocationScheme: Library of Congress
        - branchLocationId: '125575'
          branchLocationNumber: '33485'
          branchLocationName: OCLC Library East Branch
          branchLocationHoldingCode: EAST
          branchLocationHoldingSymbol: OCWMS
          defaultHoldingSymbol: false
          shelvingLocations:
          - EAST Periodicals test
          - EAST-Periodicals
          - EAST-Reference
          - EAST-STACKS
          - EUS Shelving Location
          - Library USE Only
          - Reserves – 2-Hour Loan
          shelvingLocationScheme: Library of Congress
        - branchLocationId: '130456'
          branchLocationNumber: '33486'
          branchLocationName: OCLC Library Central Branch
          branchLocationHoldingCode: CENT
          branchLocationHoldingSymbol: OCWMS
          defaultHoldingSymbol: false
          shelvingLocations:
          - CENT- Periodicals
          - CENT-Periodicals test
          - CENT-Reference
          - CENT-STACKS
          shelvingLocationScheme: Library of Congress
    forbidden:
      summary: Error returned when API credentials not for resource
      value:
        message: Forbidden
    bib-marc-existing:
      summary: Bibliographic MARC record
      value: "00291nam a2200109 a 4500001001300000008004100013010001700054040002200071100002700093245001600120500004500136\\u001Eocn970988303\\u001E120827s2012    nyua          000 0 eng d\\u001E  \\u001Fa   63011276 \\u001E  \\u001FaOCWMS\\u001Fbeng\\u001FcOCWMS\\u001E0 \\u001FaOCLC Developer Network\\u001E10\\u001FaTest Record\\u001E  \\u001FaFOR OCLC DEVELOPER NETWORK DOCUMENTATION\\u001E\\u001D      \n"
    holding-set:
      summary: Holding Set Successfully.
      value:
        controlNumber: '439887343'
        requestedControlNumber: '439887343'
        institutionCode: '158223'
        institutionSymbol: OCWMS
        success: true
        message: Set Holding Succeeded.
        action: Set Holdings
    holding-unset-blocked-by-lbds:
      summary: Holding Unset Blocked by LBD(s).
      value:
        controlNumber: '439887343'
        requestedControlNumber: '439887343'
        institutionCode: '158223'
        institutionSymbol: OCWMS
        success: false
        message: Unset Holdings Failed. Local bibliographic data (LBD) is attached to this record.
        action: Unset Holdings
    bib-marcxml-existing:
      summary: Bibliographic MARC XML record
      value: "<r

# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/worldcat/refs/heads/main/openapi/worldcat-manage-institution-api-openapi.yml