API Docs

__METHOD= GET . __PATH= /almaws/v1/bibs/{mms_id} .

Retrieve Bib

This web service returns a Bib record in an XML format.

To include physical inventory information use "expand=p_avail":
AVA field is added per holding record (related to the input mms-id or to a related Bib records) as following:
$$a - Institution code, $$b - Library code, $$c - Location display name, $$h - Campus,
$$d - Call number, $$e - Availability (such as available, unavailable, or check_holdings),
$$j - Location code, $$k - Call number type, $$f - total items, $$g - non available items,
$$h - Calculated summary information,
$$p - priority, $$0 - Bib record ID, $$8 - Holdings ID (of items on permanent location only), $$t - Holdings Information, $$q - library name.
AVA is added also for items in temporary location. For such items, $$8 (holding id) will not be added.
Note: When using the API against a NZ Institution AVA fields will be retrieved for each member which has holdings.

To include digital inventory information use: "expand=d_avail":
AVD field is added per Representations, as following:
$$a - Institution code, $$b - Representations ID, $$c - REPRESENTATION/REMOTE_REPRESENTATION, $$d - Repository Name, $$e - Label, $$f - Public Note, $$h - Full Text Link, $$r - IED.

To include electronic inventory information use: "expand=e_avail":
AVE field is added per portfolio, as following:
$$l -library code, $$m - Collection name, $$n - Public note, $$u - link to the bibliographic record's services page,
$$s - coverage statement (as displayed in Primo's ViewIt mashup), $$t - Interface name.
$$8 - portfolio pid, $$c - collection identifier for the electronic resource, $$e - activation status.
$$i - Available for institution, $$d - Available for library, $$b - Available for campus.
Note: $$u will be created based on a Customer Parameter in the "Customer Parameters" mapping table (module: general): publishing_base_url.
Note: When using the API against a NZ Institution AVE fields will also be retrieved for each member which has portfolios, including $$a with the Institution code and $$0 with the mms-id.

Note: For Dublin Core records the expand parameter does not create an addition AVD field. Instead it creates a dc:identifier field with a delivery URL.
Note:The bibliographic record retrieved from Alma is enriched with additional identifiers.
The MMS ID of the Network Zone and the Alma Community Zone ID are added to the record
in additional 035 marc fields. The Community Zone ID is added with the prefix (EXLCZ)
while the Network Zone ID is added with the prefix (EXLNZ-network_code). The local
MMS ID is in the 001 marc field. These additional shared IDs can be used for better
identification of a common record. The local MMS ID should be used when there is a need to call
an API in the institution for the record.

Resource URL

GET /almaws/v1/bibs/{mms_id}

API Description

URL Parameters

mms_idxs:stringThe Bib Record ID.

Querystring Parameters

viewxs:stringOptional. Default: fullUse view=brief to retrieve without the MARCXML. Use view=local_fields to retrieve only local fields for an IZ record linked to an NZ record.
expandxs:stringOptional. Default: NoneThis parameter allows for expanding the bibliographic record with additional information:
p_avail - Expand physical inventory information.
e_avail - Expand electronic inventory information.
d_avail - Expand digital inventory information.
requests - Expand total number of title requests.
To use more than one, use a comma separator.

Body Parameters



This method returns a Bib object. See doc

Possible Error Codes

401652General Error - An error has occurred while processing the request.
402204Input parameters mmsId X is not numeric.
402203Input parameters mmsId X is not valid.