API Docs

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,
$$v - 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":
MARC - 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.
Dublin Core - A dc:identifier field with a delivery URL is added per representation.
MODS - A location/url field with a delivery URL is added per representation.

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

• WADL documentation: Download
• Swagger (OpenAPI) documentation: Download

URL Parameters

Querystring Parameters

Body Parameters

None

Output

This method returns a Bib object. See doc

Possible Error Codes