Instance Set API version v3.2
http://github.com/org/folio/mod-inventory-storage
Instance Set
Get instances, for each instance get related records
/inventory-view/instance-set
Collection of instance-set items.
Get instances, for each instance get related records
get /inventory-view/instance-set
Get instances, for each instance get related records
Query Parameters
- instance: (boolean - default: false)
Add "instance" property with the instance JSON
- holdingsRecords: (boolean - default: false)
Add "holdingsRecords" array with all holdings record JSONs that belong to the instance
- items: (boolean - default: false)
Add "items" array with all item JSONs that belong to the instance
- precedingTitles: (boolean - default: false)
Add "precedingTitles" array with relationship records, each has a precedingInstanceId property
- succeedingTitles: (boolean - default: false)
Add "succeedingTitles" array with relationship records, each has a succeedingInstanceId property
- superInstanceRelationships: (boolean - default: false)
Add "superInstanceRelationships" array with relationship records, each has a superInstanceId property
- subInstanceRelationships: (boolean - default: false)
Add "subInstanceRelationships" array with relationship records, each has a subInstanceId property
- offset: (integer - default: 0 - minimum: 0 - maximum: 2147483647)
Skip over a number of elements by specifying an offset value for the query
Example:
0
- limit: required(integer - minimum: 1 - maximum: 10)
Limit the number of instance records to return data for; small maximum avoids out of memory
Example:
1
- query: (string)
A query expressed as a CQL string (see dev.folio.org/reference/glossary#cql) using valid searchable fields. The first example below shows the general form of a full CQL query, but those fields might not be relevant in this context.
using CQL
Example:
(username=="ab*" or personal.firstName=="ab*" or personal.lastName=="ab*") and active=="true" sortby personal.lastName personal.firstName barcode hrid=="in007"
HTTP status code 200
Streams a list of instance-set items
Body
Media type: binary/octet-stream
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "Instance with holdings, items, preceding titles, succeeding titles, super instances, sub instances",
"type": "object",
"properties": {
"id": {
"description": "Instance id",
"$ref": "uuid.json"
},
"instance": {
"description": "Instance record",
"$ref": "instance.json"
},
"holdingsRecords": {
"type": "array",
"description": "Holdings records of the instance",
"items": {
"$ref": "holdings-storage/holdingsRecord.json"
}
},
"items": {
"type": "array",
"description": "Items of the instance",
"items": {
"$ref": "item-storage/item.json"
}
},
"precedingTitles": {
"type": "array",
"description": "Instances that are preceding titles of the instance",
"items": {
"$ref": "instanceprecedingsucceedingtitle.json"
}
},
"succeedingTitles": {
"type": "array",
"description": "Instances that are succeeding titles of the instance",
"items": {
"$ref": "instanceprecedingsucceedingtitle.json"
}
},
"superInstanceRelationships": {
"type": "array",
"description": "Instances that are super instances of the instance",
"items": {
"$ref": "instancerelationship.json"
}
},
"subInstanceRelationships": {
"type": "array",
"description": "Instances that are sub instances of the instance",
"items": {
"$ref": "instancerelationship.json"
}
}
},
"additionalProperties": false,
"required": ["id"]
}
Example:
{
"instanceSet": [
{
"id": "4b763e7c-2470-4d31-91b0-23a606b7d55e",
"instance": {
"id": "4b763e7c-2470-4d31-91b0-23a606b7d55e",
"_version": 1,
"hrid": "in00000000002",
"source": "MARC",
"title": "Long Way to a Small Angry Planet",
"alternativeTitles": [],
"editions": [],
"series": [],
"identifiers": [
{
"value": "9781473619777",
"identifierTypeId": "8261054f-be78-422d-bd51-4ed9f33c3422"
}
],
"contributors": [
{
"name": "Chambers, Becky",
"contributorNameTypeId": "2b94c631-fca9-4892-a730-03ee529ffe2a"
}
],
"subjects": [],
"classifications": [],
"publication": [],
"publicationFrequency": [],
"publicationRange": [],
"electronicAccess": [],
"instanceTypeId": "535e3160-763a-42f9-b0c0-d8ed7df6e2a2",
"instanceFormatIds": [],
"instanceFormats": [],
"physicalDescriptions": [],
"languages": [],
"notes": [],
"discoverySuppress": false,
"statisticalCodeIds": [],
"statusUpdatedDate": "2021-02-24T11:30:15.752+0200",
"tags": {
"tagList": [
"test-tag"
]
},
"metadata": {
"createdDate": "2021-02-24T09:30:15.752+00:00",
"updatedDate": "2021-02-24T09:30:15.752+00:00"
},
"holdingsRecords2": [],
"natureOfContentTermIds": []
},
"holdingsRecords": [
{
"id": "2a4cad3d-d978-4404-88f3-f4c2b04f254c",
"_version": 1,
"hrid": "ho00000000003",
"formerIds": [],
"instanceId": "4b763e7c-2470-4d31-91b0-23a606b7d55e",
"permanentLocationId": "9f551ce9-ac88-4f89-970d-b00e4b69edf2",
"electronicAccess": [],
"notes": [],
"holdingsStatements": [],
"holdingsStatementsForIndexes": [],
"holdingsStatementsForSupplements": [],
"statisticalCodeIds": [],
"metadata": {
"createdDate": "2021-02-24T09:30:15.770+00:00",
"updatedDate": "2021-02-24T09:30:15.770+00:00"
}
},
{
"id": "3dac5efd-f778-498c-9e58-bea2473694b1",
"_version": 1,
"hrid": "ho00000000004",
"formerIds": [],
"instanceId": "4b763e7c-2470-4d31-91b0-23a606b7d55e",
"permanentLocationId": "ded842f9-cd42-43f5-bc9c-e54cb1bfa2e0",
"electronicAccess": [],
"notes": [],
"holdingsStatements": [],
"holdingsStatementsForIndexes": [],
"holdingsStatementsForSupplements": [],
"statisticalCodeIds": [],
"metadata": {
"createdDate": "2021-02-24T09:30:15.786+00:00",
"updatedDate": "2021-02-24T09:30:15.786+00:00"
}
},
{
"id": "5508aa51-dc6c-4bd5-8b88-2773cf3f2978",
"_version": 1,
"hrid": "ho00000000005",
"formerIds": [],
"instanceId": "4b763e7c-2470-4d31-91b0-23a606b7d55e",
"permanentLocationId": "ce97794f-2729-49c7-8561-d7016816b685",
"electronicAccess": [],
"notes": [],
"holdingsStatements": [],
"holdingsStatementsForIndexes": [],
"holdingsStatementsForSupplements": [],
"statisticalCodeIds": [],
"metadata": {
"createdDate": "2021-02-24T09:30:15.811+00:00",
"updatedDate": "2021-02-24T09:30:15.811+00:00"
}
}
],
"items": [
{
"id": "c83efee3-ebbc-4772-ab34-1918381da2c7",
"_version": 1,
"hrid": "it00000000003",
"holdingsRecordId": "2a4cad3d-d978-4404-88f3-f4c2b04f254c",
"formerIds": [],
"barcode": "565578437802",
"effectiveCallNumberComponents": {},
"yearCaption": [],
"notes": [],
"circulationNotes": [],
"status": {
"name": "Available",
"date": "2021-02-24T09:30:15.828+00:00"
},
"materialTypeId": "0c7ff668-08d4-47b5-ae64-f5a31b757e1c",
"permanentLoanTypeId": "81ebe45c-f4df-4b92-afab-90b4f433f6b3",
"temporaryLocationId": "bbe659bf-fb2d-44b2-bd1a-7f968993bca0",
"effectiveLocationId": "bbe659bf-fb2d-44b2-bd1a-7f968993bca0",
"electronicAccess": [],
"statisticalCodeIds": [],
"metadata": {
"createdDate": "2021-02-24T09:30:15.828+00:00",
"updatedDate": "2021-02-24T09:30:15.828+00:00"
}
},
{
"id": "bf6b5993-7f0a-4bcf-9b48-fac7e4405a48",
"_version": 1,
"hrid": "it00000000004",
"holdingsRecordId": "2a4cad3d-d978-4404-88f3-f4c2b04f254c",
"formerIds": [],
"barcode": "565578437802",
"effectiveCallNumberComponents": {},
"yearCaption": [],
"notes": [],
"circulationNotes": [],
"status": {
"name": "Available",
"date": "2021-02-24T09:30:15.848+00:00"
},
"materialTypeId": "0c7ff668-08d4-47b5-ae64-f5a31b757e1c",
"permanentLoanTypeId": "81ebe45c-f4df-4b92-afab-90b4f433f6b3",
"temporaryLocationId": "bbe659bf-fb2d-44b2-bd1a-7f968993bca0",
"effectiveLocationId": "bbe659bf-fb2d-44b2-bd1a-7f968993bca0",
"electronicAccess": [],
"statisticalCodeIds": [],
"metadata": {
"createdDate": "2021-02-24T09:30:15.848+00:00",
"updatedDate": "2021-02-24T09:30:15.848+00:00"
}
},
{
"id": "6f3a5084-75a6-4065-9b8e-19cf62a64b01",
"_version": 1,
"hrid": "it00000000005",
"holdingsRecordId": "3dac5efd-f778-498c-9e58-bea2473694b1",
"formerIds": [],
"barcode": "565578437802",
"effectiveCallNumberComponents": {},
"yearCaption": [],
"notes": [],
"circulationNotes": [],
"status": {
"name": "Available",
"date": "2021-02-24T09:30:15.868+00:00"
},
"materialTypeId": "0c7ff668-08d4-47b5-ae64-f5a31b757e1c",
"permanentLoanTypeId": "81ebe45c-f4df-4b92-afab-90b4f433f6b3",
"temporaryLocationId": "bbe659bf-fb2d-44b2-bd1a-7f968993bca0",
"effectiveLocationId": "bbe659bf-fb2d-44b2-bd1a-7f968993bca0",
"electronicAccess": [],
"statisticalCodeIds": [],
"metadata": {
"createdDate": "2021-02-24T09:30:15.868+00:00",
"updatedDate": "2021-02-24T09:30:15.868+00:00"
}
},
{
"id": "e6febf5b-e931-473c-b9a5-60e9cfc27ce1",
"_version": 1,
"hrid": "it00000000006",
"holdingsRecordId": "5508aa51-dc6c-4bd5-8b88-2773cf3f2978",
"formerIds": [],
"barcode": "565578437802",
"effectiveCallNumberComponents": {},
"yearCaption": [],
"notes": [],
"circulationNotes": [],
"status": {
"name": "Available",
"date": "2021-02-24T09:30:15.885+00:00"
},
"materialTypeId": "0c7ff668-08d4-47b5-ae64-f5a31b757e1c",
"permanentLoanTypeId": "81ebe45c-f4df-4b92-afab-90b4f433f6b3",
"temporaryLocationId": "bbe659bf-fb2d-44b2-bd1a-7f968993bca0",
"effectiveLocationId": "bbe659bf-fb2d-44b2-bd1a-7f968993bca0",
"electronicAccess": [],
"statisticalCodeIds": [],
"metadata": {
"createdDate": "2021-02-24T09:30:15.885+00:00",
"updatedDate": "2021-02-24T09:30:15.885+00:00"
}
}
]
}
]
}
HTTP status code 400
Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.
Body
Media type: text/plain
Type: any
Example:
unable to list instance-set -- malformed parameter 'query', syntax error at column 6
HTTP status code 401
Not authorized to perform requested action
Body
Media type: text/plain
Type: any
Example:
unable to list instance-set -- unauthorized
HTTP status code 500
Internal server error, e.g. due to misconfiguration
Body
Media type: text/plain
Type: any
Example:
internal server error, contact administrator