The Acquisitions API

To use the Acquisitions API endpoints, your key must be assigned the Acquisitions Write role. See Administering Sierra API Client Keys in the Sierra WebHelp for more information.

The Acquisitions API contains methods for posting or validating new acquisitions. When you post an acquisition, Sierra creates bibliographic and an attached order record. If you want to retrieve order record information for existing acquisitions, see The Orders API.

With the Acquisitions API, you can:

The Try it out! links below take you to the corresponding section in the interactive documentation, where you can view the model, model schema, and parameters for each available operation.

See also:

AcquisitionOrderPost Request Object

ErrorCode Object

OrderBibLinks Object

Request Objects

Create a New Acquisition

POST /v6/aquisitions/orders/

Adds bibliographic and order records to the Sierra system for a new acquisition.

Try it out!

Create a New Acquisition (YPB only)

This method is deprecated, except for libraries using the Acquisitions API with YPB. Use the /v6/acquisitions/orders endpoint to post new acquisitions data for all other vendors.

POST /v6/orders/funds/{acctUnit}/{fundCodeNum}

Adds bibliographic and order records to the Sierra system for a new acquisition.

Try it out!

Validate the Order Data

POST /v6/acquisitions/orders/validate

Validates the data for an AcquisitionOrder object. (Does not create bibliographic or order records.)

The validate operation assesses the following conditions:

  • There is content in required fields.
  • The data length of fixed fields.
  • The login exists on the system.
  • The location exists on the system.
  • The fund exists on the system.
  • The vendor exists on the system.
  • The fund is valid for login used.

Try it out!