foliolib.folio.api.inventory.Inventory

class foliolib.folio.api.inventory.Inventory(tenant: str)

Bases: foliolib.folio.FolioApi

Inventory API

API for interacting with an inventory of physical resources

Base class of the Folio API

Parameters

tenant (str) – Tenant id

Methods

delete_instance(instanceId)

Delete instance item with given {instanceId}

delete_instances()

DELETE /inventory/instances

delete_item(itemId)

Delete item item with given {itemId}

delete_items()

DELETE /inventory/items

delete_itemsByHoldingsIds()

DELETE /inventory/items-by-holdings-id

delete_markDeleted(instanceId)

Toggle the suppression state of an instance record, affecting either instance and associated MARC record if present.

get_instance(instanceId)

Retrieve instance item with given {instanceId}

get_instances(**kwargs)

Retrieve a list of instance items.

get_item(itemId)

Retrieve item item with given {itemId}

get_items(**kwargs)

Retrieve a list of item items.

get_itemsByHoldingsIds(**kwargs)

Retrieve a list of itemsByHoldingsId items.

modify_holding(holdingsId, holding)

Update Holdings by holdingsId

modify_instance(instanceId, instance)

Update instance item with given {instanceId}

modify_item(itemId, item)

Update item item with given {itemId}

set_instance(instance)

Create a new instance item.

set_item(item)

Create a new item item.

set_itemsByHoldingsId(itemsByHoldingsId)

Create a new itemsByHoldingsId item.

set_markInProcess(itemId)

POST /inventory/items/{itemId}/mark-in-process

set_markInProcessNonRequestable(itemId)

POST /inventory/items/{itemId}/mark-in-process-non-requestable

set_markIntellectualItem(itemId)

POST /inventory/items/{itemId}/mark-intellectual-item

set_markLongMissing(itemId)

POST /inventory/items/{itemId}/mark-long-missing

set_markMissing(itemId)

POST /inventory/items/{itemId}/mark-missing

set_markRestricted(itemId)

POST /inventory/items/{itemId}/mark-restricted

set_markUnavailable(itemId)

POST /inventory/items/{itemId}/mark-unavailable

set_markUnknown(itemId)

POST /inventory/items/{itemId}/mark-unknown

set_markWithdrawn(itemId)

POST /inventory/items/{itemId}/mark-withdrawn
delete_instance(instanceId: str)

Delete instance item with given {instanceId}

DELETE /inventory/instances/{instanceId}

Parameters

instanceId (str) –

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestError – Bad Request

  • OkapiRequestFatalError – Server Error

delete_instances()

DELETE /inventory/instances

delete_item(itemId: str)

Delete item item with given {itemId}

DELETE /inventory/items/{itemId}

Parameters

itemId (str) –

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestError – Bad Request

  • OkapiRequestFatalError – Server Error

delete_items()

DELETE /inventory/items

delete_itemsByHoldingsIds()

DELETE /inventory/items-by-holdings-id

delete_markDeleted(instanceId: str)

Toggle the suppression state of an instance record, affecting either instance and associated MARC record if present.

DELETE /inventory/instances/{instanceId}/mark-deleted

Parameters

instanceId (str) –

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

  • OkapiRequestFatalError – Server Error

get_instance(instanceId: str)

Retrieve instance item with given {instanceId}

GET /inventory/instances/{instanceId}

Parameters

instanceId (str) –

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An instance record",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The system assigned unique ID of the instance record"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID"
    },
    "matchKey": {
      "type": "string",
      "description": "An unique instance identifier matching a client-side bibliographic record identification. Could be an actual local identifier or a key generated from metadata in the local bibliographic record. Enables the client to determine if a client side bibliographic record already exists as an Instance in Inventory"
    },
    "source": {
      "type": "string",
      "description": "The metadata source and its format of the underlying record to the instance record. (e.g. FOLIO if it's a record created in Inventory;  MARC if it's a MARC record created in MARCcat or EPKB if it's a record coming from eHoldings)"
    },
    "parentInstances": {
      "description": "Array of parent instances",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Id of the parent instance",
            "type": "string"
          },
          "superInstanceId": {
            "description": "Id of the super instance",
            "type": "string"
          },
          "instanceRelationshipTypeId": {
            "description": "Id of the relationship type",
            "type": "string"
          }
        },
        "additionalProperties": false,
        "required": [
          "superInstanceId",
          "instanceRelationshipTypeId"
        ]
      }
    },
    "childInstances": {
      "description": "Child instances",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "subInstanceId": {
            "description": "Id of sub Instance",
            "type": "string"
          },
          "instanceRelationshipTypeId": {
            "description": "Id of the relationship type",
            "type": "string"
          }
        },
        "additionalProperties": false,
        "required": [
          "id",
          "subInstanceId",
          "instanceRelationshipTypeId"
        ]
      }
    },
    "title": {
      "type": "string",
      "description": "The primary title (or label) associated with the resource"
    },
    "indexTitle": {
      "type": "string",
      "description": "Title normalized for browsing and searching; based on the title with articles removed"
    },
    "alternativeTitles": {
      "type": "array",
      "description": "List of alternative titles for the resource (e.g. original language version title of a movie)",
      "items": {
        "type": "object",
        "properties": {
          "alternativeTitleTypeId": {
            "type": "string",
            "description": "ID for an alternative title qualifier"
          },
          "alternativeTitle": {
            "type": "string",
            "description": "An alternative title for the resource"
          },
          "authorityId": {
            "type": "string",
            "description": "UUID of authority record that controls an alternative title",
            "$ref": "uuid.json"
          }
        }
      },
      "uniqueItems": true
    },
    "editions": {
      "type": "array",
      "description": "The edition statement, imprint and other publication source information",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "series": {
      "type": "array",
      "description": "List of series titles associated with the resource (e.g. Harry Potter)",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "Series title value"
          },
          "authorityId": {
            "type": "string",
            "description": "UUID of authority record that controls an series title",
            "$ref": "uuid.json"
          }
        },
        "additionalProperties": false,
        "required": [
          "value"
        ]
      },
      "uniqueItems": true
    },
    "identifiers": {
      "type": "array",
      "description": "An extensible set of name-value pairs of identifiers associated with the resource",
      "minItems": 0,
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "Resource identifier value"
          },
          "identifierTypeId": {
            "type": "string",
            "description": "Resource identifier type (e.g. ISBN, ISSN, LCCN, CODEN, Locally defined identifiers)"
          }
        },
        "additionalProperties": false,
        "required": [
          "value",
          "identifierTypeId"
        ]
      }
    },
    "contributors": {
      "type": "array",
      "description": "List of contributors",
      "minItems": 0,
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Personal name, corporate name, meeting name"
          },
          "contributorTypeId": {
            "type": "string",
            "description": "ID for the contributor type term defined as a referencetable in settings"
          },
          "contributorTypeText": {
            "type": "string",
            "description": "Free text element for adding contributor type terms other that defined by the MARC code list for relators"
          },
          "contributorNameTypeId": {
            "type": "string",
            "description": "Contributor type terms defined by the MARC code list for relators"
          },
          "authorityId": {
            "type": "string",
            "description": "ID of authority record that controls the contributor",
            "$ref": "uuid.json"
          },
          "primary": {
            "type": "boolean",
            "description": "Whether this is the primary contributor"
          }
        },
        "additionalProperties": false,
        "required": [
          "name",
          "contributorNameTypeId"
        ]
      }
    },
    "subjects": {
      "type": "array",
      "description": "List of subject headings",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "Subject heading value"
          },
          "authorityId": {
            "type": "string",
            "description": "UUID of authority record that controls a subject heading",
            "$ref": "uuid.json"
          }
        },
        "additionalProperties": false,
        "required": [
          "value"
        ]
      },
      "uniqueItems": true
    },
    "classifications": {
      "type": "array",
      "description": "List of classifications",
      "minItems": 0,
      "items": {
        "type": "object",
        "properties": {
          "classificationNumber": {
            "type": "string",
            "description": "Classification (e.g. classification scheme, classification schedule)"
          },
          "classificationTypeId": {
            "type": "string",
            "description": "List of classification schemas (e.g. LC, Canadian Classification, NLM, National Agricultural Library, UDC, and Dewey)"
          }
        },
        "additionalProperties": false,
        "required": [
          "classificationNumber",
          "classificationTypeId"
        ]
      }
    },
    "publication": {
      "type": "array",
      "description": "List of publication items",
      "items": {
        "type": "object",
        "properties": {
          "publisher": {
            "type": "string",
            "description": "Name of publisher, distributor, etc."
          },
          "place": {
            "type": "string",
            "description": "Place of publication, distribution, etc."
          },
          "dateOfPublication": {
            "type": "string",
            "description": "Date (year YYYY) of publication, distribution, etc."
          },
          "role": {
            "type": "string",
            "description": "The role of the publisher, distributor, etc."
          }
        }
      }
    },
    "publicationFrequency": {
      "type": "array",
      "description": "List of intervals at which a serial appears (e.g. daily, weekly, monthly, quarterly, etc.)",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "publicationRange": {
      "type": "array",
      "description": "The range of sequential designation/chronology of publication, or date range",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "publicationPeriod": {
      "type": "object",
      "description": "Publication period",
      "properties": {
        "start": {
          "type": "integer",
          "description": "Publication start year"
        },
        "end": {
          "type": "integer",
          "description": "Publication end year"
        }
      },
      "additionalProperties": false
    },
    "electronicAccess": {
      "type": "array",
      "description": "List of electronic access items",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "The value of the MARC tag field 856 2nd indicator, where the values are: no information provided, resource, version of resource, related resource, no display constant generated"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship between the electronic resource at the location identified and the item described in the record as a whole"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "instanceTypeId": {
      "type": "string",
      "description": "The unique term for the resource type whether it's from the RDA content term list of locally defined"
    },
    "instanceFormatIds": {
      "type": "array",
      "description": "The unique term for the format whether it's from the RDA carrier term list of locally defined",
      "items": {
        "type": "string"
      }
    },
    "physicalDescriptions": {
      "type": "array",
      "description": "Physical description of the described resource, including its extent, dimensions, and such other physical details as a description of any accompanying materials and unit type and size",
      "items": {
        "type": "string"
      }
    },
    "languages": {
      "type": "array",
      "description": "The set of languages used by the resource",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "type": "array",
      "description": "Bibliographic notes (e.g. general notes, specialized notes), and administrative notes",
      "items": {
        "type": "object",
        "properties": {
          "instanceNoteTypeId": {
            "description": "ID of the type of note",
            "$ref": "uuid.json"
          },
          "note": {
            "type": "string",
            "description": "Text content of the note"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "If true, determines that the note should not be visible for others than staff",
            "default": false
          }
        }
      }
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "modeOfIssuanceId": {
      "type": "string",
      "description": "RDA mode of issuance is a categorization reflecting whether a resource is issued in one or more parts, the way it is updated, and whether its termination is predetermined or not (e.g. monograph,  sequential monograph, serial; integrating Resource, other)"
    },
    "catalogedDate": {
      "type": "string",
      "description": "Date or timestamp on an instance for when is was considered cataloged"
    },
    "previouslyHeld": {
      "type": "boolean",
      "description": "Records the fact that the resource was previously held by the library for things like Hathi access, etc."
    },
    "staffSuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed for others than catalogers"
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "List of statistical code IDs",
      "items": {
        "type": "string"
      }
    },
    "sourceRecordFormat": {
      "description": "Format of the instance source record, if a source record exists",
      "type": "string",
      "enum": [
        "MARC-JSON"
      ],
      "readonly": true
    },
    "statusId": {
      "type": "string",
      "description": "Instance status term (e.g. cataloged, uncatalogued, batch loaded, temporary, other, not yet assigned)"
    },
    "statusUpdatedDate": {
      "type": "string",
      "description": "Date [or timestamp] for when the instance status was updated"
    },
    "tags": {
      "description": "arbitrary tags associated with this instance",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "metadata": {
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "natureOfContentTermIds": {
      "type": "array",
      "description": "Array of UUID for the Instance nature of content (e.g. bibliography, biography, exhibition catalogue, festschrift, newspaper, proceedings, research report, thesis or website)",
      "items": {
        "type": "string",
        "description": "Single UUID for the Instance nature of content",
        "$ref": "uuid.json"
      }
    },
    "isBoundWith": {
      "description": "Indicates if this Instance is included in a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "precedingTitles": {
      "description": "Array of preceding titles",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Id of the preceding title",
            "type": "string",
            "$ref": "uuid.json"
          },
          "precedingInstanceId": {
            "description": "Id of the preceding instance id",
            "type": "string",
            "$ref": "uuid.json"
          },
          "title": {
            "type": "string",
            "description": "The primary title (or label) associated with the resource"
          },
          "hrid": {
            "type": "string",
            "description": "The human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID"
          },
          "identifiers": {
            "type": "array",
            "description": "An extensible set of name-value pairs of identifiers associated with the resource",
            "minItems": 0,
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "description": "Resource identifier value"
                },
                "identifierTypeId": {
                  "type": "string",
                  "description": "Resource identifier type (e.g. ISBN, ISSN, LCCN, CODEN, Locally defined identifiers)"
                }
              },
              "additionalProperties": false,
              "required": [
                "value",
                "identifierTypeId"
              ]
            }
          }
        },
        "additionalProperties": false
      }
    },
    "succeedingTitles": {
      "description": "Array of succeeding titles",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Id of the succeeding title",
            "type": "string",
            "$ref": "uuid.json"
          },
          "succeedingInstanceId": {
            "description": "Id of the succeeding instance id",
            "type": "string",
            "$ref": "uuid.json"
          },
          "title": {
            "type": "string",
            "description": "The primary title (or label) associated with the resource"
          },
          "hrid": {
            "type": "string",
            "description": "The human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID"
          },
          "identifiers": {
            "type": "array",
            "description": "An extensible set of name-value pairs of identifiers associated with the resource",
            "minItems": 0,
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "description": "Resource identifier value"
                },
                "identifierTypeId": {
                  "type": "string",
                  "description": "Resource identifier type (e.g. ISBN, ISSN, LCCN, CODEN, Locally defined identifiers)"
                }
              },
              "additionalProperties": false,
              "required": [
                "value",
                "identifierTypeId"
              ]
            }
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "source",
    "title",
    "instanceTypeId"
  ]
}
get_instances(**kwargs)

Retrieve a list of instance items.

GET /inventory/instances

Parameters

**kwargs (properties) – Keyword Arguments

Keyword Arguments

  • offset (int) –

    (default=0) Skip over a number of elements by specifying an offset value for the query

    Example

    • 0

  • limit (int) –

    (default=10) Limit the number of elements returned in the response

    Example

    • 10

  • query (str) –

    A query expressed as a CQL string (see [dev.folio.org/reference/glossary#cql](https://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 (indexes for item and material type)

    Example

    • (username==”ab*” or personal.firstName==”ab*” or personal.lastName==”ab*”) and active==”true” sortby personal.lastName personal.firstName barcode

    • title=”uproot*”

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestError – Bad Request

  • OkapiRequestUnauthorized – Authentication is required

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "A collection of instance records",
  "type": "object",
  "properties": {
    "instances": {
      "description": "List of instance records",
      "id": "instances",
      "type": "array",
      "items": {
        "type": "object",
        "$ref": "instance.json"
      }
    },
    "totalRecords": {
      "type": "integer"
    }
  },
  "required": [
    "instances",
    "totalRecords"
  ]
}
get_item(itemId: str)

Retrieve item item with given {itemId}

GET /inventory/items/{itemId}

Parameters

itemId (str) –

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
get_items(**kwargs)

Retrieve a list of item items.

GET /inventory/items

Parameters

**kwargs (properties) – Keyword Arguments

Keyword Arguments

  • offset (int) –

    (default=0) Skip over a number of elements by specifying an offset value for the query

    Example

    • 0

  • limit (int) –

    (default=10) Limit the number of elements returned in the response

    Example

    • 10

  • query (str) –

    A query expressed as a CQL string (see [dev.folio.org/reference/glossary#cql](https://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 (indexes for item and material type)

    Example

    • (username==”ab*” or personal.firstName==”ab*” or personal.lastName==”ab*”) and active==”true” sortby personal.lastName personal.firstName barcode

    • barcode==”65345656554”

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestError – Bad Request

  • OkapiRequestUnauthorized – Authentication is required

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "A collection of item records",
  "type": "object",
  "properties": {
    "items": {
      "description": "List of item records",
      "id": "items",
      "type": "array",
      "items": {
        "type": "object",
        "$ref": "item.json"
      }
    },
    "totalRecords": {
      "type": "integer"
    }
  },
  "additionalProperties": false,
  "required": [
    "items",
    "totalRecords"
  ]
}
get_itemsByHoldingsIds(**kwargs)

Retrieve a list of itemsByHoldingsId items.

GET /inventory/items-by-holdings-id

Parameters

**kwargs (properties) – Keyword Arguments

Keyword Arguments

  • offset (int) –

    (default=0) Skip over a number of elements by specifying an offset value for the query

    Example

    • 0

  • limit (int) –

    (default=10) Limit the number of elements returned in the response

    Example

    • 10

  • query (str) –

    A query expressed as a CQL string (see [dev.folio.org/reference/glossary#cql](https://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.

    query by holdings record ID. This is a mandatory query parameter. An optional parameter, ‘relations’, can be passed outside of the query to restrict what Items are returned based on their type of relationship with the holdings record. Possible values of the ‘relations’ parameter are: ‘onlyBoundWiths’, ‘onlyBoundWithsSkipDirectlyLinkedItem’

    Example

    • (username==”ab*” or personal.firstName==”ab*” or personal.lastName==”ab*”) and active==”true” sortby personal.lastName personal.firstName barcode

    • holdingsRecordId==”[UUID]”

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestError – Bad Request

  • OkapiRequestUnauthorized – Authentication is required

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "A collection of item records",
  "type": "object",
  "properties": {
    "items": {
      "description": "List of item records",
      "id": "items",
      "type": "array",
      "items": {
        "type": "object",
        "$ref": "item.json"
      }
    },
    "totalRecords": {
      "type": "integer"
    }
  },
  "additionalProperties": false,
  "required": [
    "items",
    "totalRecords"
  ]
}
modify_holding(holdingsId: str, holding: dict)

Update Holdings by holdingsId

PUT /inventory/holdings/{holdingsId}

Parameters

  • holdingsId (str) –

  • holding (dict) – See Schema below

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestError – Bad Request

  • OkapiRequestConflict – Conflict

  • OkapiRequestFatalError – Server Error

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "A holdings record",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "the system assigned unique ID of the holdings record; UUID",
      "$ref": "./uuid.json"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "the human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID"
    },
    "holdingsTypeId": {
      "type": "string",
      "description": "unique ID for the type of this holdings record, a UUID",
      "$ref": "./uuid.json"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous ID(s) assigned to the holdings record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "instanceId": {
      "description": "Instance id",
      "type": "string",
      "$ref": "./uuid.json"
    },
    "permanentLocationId": {
      "type": "string",
      "description": "The permanent shelving location in which an item resides.",
      "$ref": "./uuid.json"
    },
    "temporaryLocationId": {
      "type": "string",
      "description": "Temporary location is the temporary location, shelving location, or holding which is a physical place where items are stored, or an Online location.",
      "$ref": "./uuid.json"
    },
    "effectiveLocationId": {
      "type": "string",
      "description": "Effective location is calculated by the system based on the values in the permanent and temporary locationId fields.",
      "$ref": "./uuid.json"
    },
    "electronicAccess": {
      "description": "Electronic access",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "uniform resource identifier (URI) is a string of characters designed for unambiguous identification of resources"
          },
          "linkText": {
            "type": "string",
            "description": "the value of the MARC tag field 856 2nd indicator, where the values are: no information provided, resource, version of resource, related resource, no display constant generated"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "relationship between the electronic resource at the location identified and the item described in the record as a whole"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "callNumberTypeId": {
      "type": "string",
      "description": "unique ID for the type of call number on a holdings record, a UUID",
      "$ref": "./uuid.json"
    },
    "callNumberPrefix": {
      "type": "string",
      "description": "Prefix of the call number on the holding level."
    },
    "callNumber": {
      "type": "string",
      "description": "Call Number is an identifier assigned to an item, usually printed on a label attached to the item."
    },
    "callNumberSuffix": {
      "type": "string",
      "description": "Suffix of the call number on the holding level."
    },
    "shelvingTitle": {
      "type": "string",
      "description": "Indicates the shelving form of title."
    },
    "acquisitionFormat": {
      "description": "Acquisition format",
      "type": "string"
    },
    "acquisitionMethod": {
      "description": "Acquisition method",
      "type": "string"
    },
    "receiptStatus": {
      "type": "string",
      "description": "Receipt status (e.g. pending, awaiting receipt, partially received, fully received, receipt not required, and cancelled)"
    },
    "notes": {
      "description": "Notes about action, copy, binding etc.",
      "type": "array",
      "items": {
        "type": "object",
        "$ref": "holdings-notes.json"
      }
    },
    "illPolicyId": {
      "type": "string",
      "description": "unique ID for an ILL policy, a UUID",
      "$ref": "./uuid.json"
    },
    "retentionPolicy": {
      "type": "string",
      "description": "Records information regarding how long we have agreed to keep something."
    },
    "digitizationPolicy": {
      "description": "Digitization policy",
      "type": "string"
    },
    "holdingsStatements": {
      "type": "array",
      "description": "Holdings statements",
      "items": {
        "type": "object",
        "properties": {
          "statement": {
            "type": "string",
            "description": "Specifices the exact content to which the library has access, typically for continuing publications."
          },
          "note": {
            "type": "string",
            "description": "Note attached to a holdings statement"
          },
          "staffNote": {
            "type": "string",
            "description": "Private note attached to a holdings statement"
          }
        }
      }
    },
    "holdingsStatementsForIndexes": {
      "description": "Holdings statements for indexes",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "statement": {
            "type": "string",
            "description": "Textual description of the holdings of indexes"
          },
          "note": {
            "type": "string",
            "description": "Note attached to a holdings statement"
          },
          "staffNote": {
            "type": "string",
            "description": "Private note attached to a holdings statement"
          }
        }
      }
    },
    "holdingsStatementsForSupplements": {
      "description": "Holdings statements for supplements",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "statement": {
            "type": "string",
            "description": "textual description of the holdings of supplementary material"
          },
          "note": {
            "type": "string",
            "description": "note attached to a holdings statement"
          },
          "staffNote": {
            "type": "string",
            "description": "Private note attached to a holdings statement"
          }
        }
      }
    },
    "copyNumber": {
      "type": "string",
      "description": "Item/Piece ID (usually barcode) for systems that do not use item records. Ability to designate the copy number if institution chooses to use copy numbers."
    },
    "numberOfItems": {
      "type": "string",
      "description": "Text (Number)"
    },
    "receivingHistory": {
      "description": "Receiving history",
      "type": "object",
      "properties": {
        "displayType": {
          "type": "string",
          "description": "Display hint. 1: Display fields separately. 2: Display fields concatenated"
        },
        "entries": {
          "type": "array",
          "description": "Entries",
          "items": {
            "type": "object",
            "properties": {
              "publicDisplay": {
                "type": "boolean",
                "description": "Defines if the receivingHistory should be visible to the public."
              },
              "enumeration": {
                "type": "string",
                "description": "This is the volume/issue number (e.g. v.71:no.6-2)"
              },
              "chronology": {
                "type": "string",
                "description": "Repeated element from Receiving history - Enumeration AND Receiving history - Chronology"
              }
            }
          }
        }
      }
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "records the fact that the record should not be displayed in a discovery system"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "List of statistical code IDs",
      "items": {
        "type": "string",
        "$ref": "./uuid.json"
      },
      "uniqueItems": true
    },
    "holdingsInstance": {
      "description": "Holdings Instance",
      "type": "object",
      "folio:$ref": "instance.json",
      "readonly": true,
      "folio:isVirtual": true,
      "folio:linkBase": "inventory/instances",
      "folio:linkFromField": "instanceId",
      "folio:linkToField": "id",
      "folio:includedElement": "instances.0"
    },
    "tags": {
      "description": "arbitrary tags associated with this holding",
      "id": "tags",
      "type": "object",
      "$ref": "./raml-util/schemas/tags.schema"
    },
    "sourceId": {
      "description": "UUID of the holdings records source",
      "type": "string",
      "$ref": "uuid.json"
    },
    "metadata": {
      "type": "object",
      "$ref": "./raml-util/schemas/metadata.schema",
      "readonly": true
    }
  },
  "additionalProperties": false,
  "required": [
    "instanceId",
    "permanentLocationId"
  ]
}
modify_instance(instanceId: str, instance: dict)

Update instance item with given {instanceId}

PUT /inventory/instances/{instanceId}

Parameters

  • instanceId (str) –

  • instance (dict) – See Schema below

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestError – Bad Request

  • OkapiRequestFatalError – Server Error

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An instance record",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The system assigned unique ID of the instance record"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID"
    },
    "matchKey": {
      "type": "string",
      "description": "An unique instance identifier matching a client-side bibliographic record identification. Could be an actual local identifier or a key generated from metadata in the local bibliographic record. Enables the client to determine if a client side bibliographic record already exists as an Instance in Inventory"
    },
    "source": {
      "type": "string",
      "description": "The metadata source and its format of the underlying record to the instance record. (e.g. FOLIO if it's a record created in Inventory;  MARC if it's a MARC record created in MARCcat or EPKB if it's a record coming from eHoldings)"
    },
    "parentInstances": {
      "description": "Array of parent instances",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Id of the parent instance",
            "type": "string"
          },
          "superInstanceId": {
            "description": "Id of the super instance",
            "type": "string"
          },
          "instanceRelationshipTypeId": {
            "description": "Id of the relationship type",
            "type": "string"
          }
        },
        "additionalProperties": false,
        "required": [
          "superInstanceId",
          "instanceRelationshipTypeId"
        ]
      }
    },
    "childInstances": {
      "description": "Child instances",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "subInstanceId": {
            "description": "Id of sub Instance",
            "type": "string"
          },
          "instanceRelationshipTypeId": {
            "description": "Id of the relationship type",
            "type": "string"
          }
        },
        "additionalProperties": false,
        "required": [
          "id",
          "subInstanceId",
          "instanceRelationshipTypeId"
        ]
      }
    },
    "title": {
      "type": "string",
      "description": "The primary title (or label) associated with the resource"
    },
    "indexTitle": {
      "type": "string",
      "description": "Title normalized for browsing and searching; based on the title with articles removed"
    },
    "alternativeTitles": {
      "type": "array",
      "description": "List of alternative titles for the resource (e.g. original language version title of a movie)",
      "items": {
        "type": "object",
        "properties": {
          "alternativeTitleTypeId": {
            "type": "string",
            "description": "ID for an alternative title qualifier"
          },
          "alternativeTitle": {
            "type": "string",
            "description": "An alternative title for the resource"
          },
          "authorityId": {
            "type": "string",
            "description": "UUID of authority record that controls an alternative title",
            "$ref": "uuid.json"
          }
        }
      },
      "uniqueItems": true
    },
    "editions": {
      "type": "array",
      "description": "The edition statement, imprint and other publication source information",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "series": {
      "type": "array",
      "description": "List of series titles associated with the resource (e.g. Harry Potter)",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "Series title value"
          },
          "authorityId": {
            "type": "string",
            "description": "UUID of authority record that controls an series title",
            "$ref": "uuid.json"
          }
        },
        "additionalProperties": false,
        "required": [
          "value"
        ]
      },
      "uniqueItems": true
    },
    "identifiers": {
      "type": "array",
      "description": "An extensible set of name-value pairs of identifiers associated with the resource",
      "minItems": 0,
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "Resource identifier value"
          },
          "identifierTypeId": {
            "type": "string",
            "description": "Resource identifier type (e.g. ISBN, ISSN, LCCN, CODEN, Locally defined identifiers)"
          }
        },
        "additionalProperties": false,
        "required": [
          "value",
          "identifierTypeId"
        ]
      }
    },
    "contributors": {
      "type": "array",
      "description": "List of contributors",
      "minItems": 0,
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Personal name, corporate name, meeting name"
          },
          "contributorTypeId": {
            "type": "string",
            "description": "ID for the contributor type term defined as a referencetable in settings"
          },
          "contributorTypeText": {
            "type": "string",
            "description": "Free text element for adding contributor type terms other that defined by the MARC code list for relators"
          },
          "contributorNameTypeId": {
            "type": "string",
            "description": "Contributor type terms defined by the MARC code list for relators"
          },
          "authorityId": {
            "type": "string",
            "description": "ID of authority record that controls the contributor",
            "$ref": "uuid.json"
          },
          "primary": {
            "type": "boolean",
            "description": "Whether this is the primary contributor"
          }
        },
        "additionalProperties": false,
        "required": [
          "name",
          "contributorNameTypeId"
        ]
      }
    },
    "subjects": {
      "type": "array",
      "description": "List of subject headings",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "Subject heading value"
          },
          "authorityId": {
            "type": "string",
            "description": "UUID of authority record that controls a subject heading",
            "$ref": "uuid.json"
          }
        },
        "additionalProperties": false,
        "required": [
          "value"
        ]
      },
      "uniqueItems": true
    },
    "classifications": {
      "type": "array",
      "description": "List of classifications",
      "minItems": 0,
      "items": {
        "type": "object",
        "properties": {
          "classificationNumber": {
            "type": "string",
            "description": "Classification (e.g. classification scheme, classification schedule)"
          },
          "classificationTypeId": {
            "type": "string",
            "description": "List of classification schemas (e.g. LC, Canadian Classification, NLM, National Agricultural Library, UDC, and Dewey)"
          }
        },
        "additionalProperties": false,
        "required": [
          "classificationNumber",
          "classificationTypeId"
        ]
      }
    },
    "publication": {
      "type": "array",
      "description": "List of publication items",
      "items": {
        "type": "object",
        "properties": {
          "publisher": {
            "type": "string",
            "description": "Name of publisher, distributor, etc."
          },
          "place": {
            "type": "string",
            "description": "Place of publication, distribution, etc."
          },
          "dateOfPublication": {
            "type": "string",
            "description": "Date (year YYYY) of publication, distribution, etc."
          },
          "role": {
            "type": "string",
            "description": "The role of the publisher, distributor, etc."
          }
        }
      }
    },
    "publicationFrequency": {
      "type": "array",
      "description": "List of intervals at which a serial appears (e.g. daily, weekly, monthly, quarterly, etc.)",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "publicationRange": {
      "type": "array",
      "description": "The range of sequential designation/chronology of publication, or date range",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "publicationPeriod": {
      "type": "object",
      "description": "Publication period",
      "properties": {
        "start": {
          "type": "integer",
          "description": "Publication start year"
        },
        "end": {
          "type": "integer",
          "description": "Publication end year"
        }
      },
      "additionalProperties": false
    },
    "electronicAccess": {
      "type": "array",
      "description": "List of electronic access items",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "The value of the MARC tag field 856 2nd indicator, where the values are: no information provided, resource, version of resource, related resource, no display constant generated"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship between the electronic resource at the location identified and the item described in the record as a whole"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "instanceTypeId": {
      "type": "string",
      "description": "The unique term for the resource type whether it's from the RDA content term list of locally defined"
    },
    "instanceFormatIds": {
      "type": "array",
      "description": "The unique term for the format whether it's from the RDA carrier term list of locally defined",
      "items": {
        "type": "string"
      }
    },
    "physicalDescriptions": {
      "type": "array",
      "description": "Physical description of the described resource, including its extent, dimensions, and such other physical details as a description of any accompanying materials and unit type and size",
      "items": {
        "type": "string"
      }
    },
    "languages": {
      "type": "array",
      "description": "The set of languages used by the resource",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "type": "array",
      "description": "Bibliographic notes (e.g. general notes, specialized notes), and administrative notes",
      "items": {
        "type": "object",
        "properties": {
          "instanceNoteTypeId": {
            "description": "ID of the type of note",
            "$ref": "uuid.json"
          },
          "note": {
            "type": "string",
            "description": "Text content of the note"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "If true, determines that the note should not be visible for others than staff",
            "default": false
          }
        }
      }
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "modeOfIssuanceId": {
      "type": "string",
      "description": "RDA mode of issuance is a categorization reflecting whether a resource is issued in one or more parts, the way it is updated, and whether its termination is predetermined or not (e.g. monograph,  sequential monograph, serial; integrating Resource, other)"
    },
    "catalogedDate": {
      "type": "string",
      "description": "Date or timestamp on an instance for when is was considered cataloged"
    },
    "previouslyHeld": {
      "type": "boolean",
      "description": "Records the fact that the resource was previously held by the library for things like Hathi access, etc."
    },
    "staffSuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed for others than catalogers"
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "List of statistical code IDs",
      "items": {
        "type": "string"
      }
    },
    "sourceRecordFormat": {
      "description": "Format of the instance source record, if a source record exists",
      "type": "string",
      "enum": [
        "MARC-JSON"
      ],
      "readonly": true
    },
    "statusId": {
      "type": "string",
      "description": "Instance status term (e.g. cataloged, uncatalogued, batch loaded, temporary, other, not yet assigned)"
    },
    "statusUpdatedDate": {
      "type": "string",
      "description": "Date [or timestamp] for when the instance status was updated"
    },
    "tags": {
      "description": "arbitrary tags associated with this instance",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "metadata": {
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "natureOfContentTermIds": {
      "type": "array",
      "description": "Array of UUID for the Instance nature of content (e.g. bibliography, biography, exhibition catalogue, festschrift, newspaper, proceedings, research report, thesis or website)",
      "items": {
        "type": "string",
        "description": "Single UUID for the Instance nature of content",
        "$ref": "uuid.json"
      }
    },
    "isBoundWith": {
      "description": "Indicates if this Instance is included in a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "precedingTitles": {
      "description": "Array of preceding titles",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Id of the preceding title",
            "type": "string",
            "$ref": "uuid.json"
          },
          "precedingInstanceId": {
            "description": "Id of the preceding instance id",
            "type": "string",
            "$ref": "uuid.json"
          },
          "title": {
            "type": "string",
            "description": "The primary title (or label) associated with the resource"
          },
          "hrid": {
            "type": "string",
            "description": "The human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID"
          },
          "identifiers": {
            "type": "array",
            "description": "An extensible set of name-value pairs of identifiers associated with the resource",
            "minItems": 0,
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "description": "Resource identifier value"
                },
                "identifierTypeId": {
                  "type": "string",
                  "description": "Resource identifier type (e.g. ISBN, ISSN, LCCN, CODEN, Locally defined identifiers)"
                }
              },
              "additionalProperties": false,
              "required": [
                "value",
                "identifierTypeId"
              ]
            }
          }
        },
        "additionalProperties": false
      }
    },
    "succeedingTitles": {
      "description": "Array of succeeding titles",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Id of the succeeding title",
            "type": "string",
            "$ref": "uuid.json"
          },
          "succeedingInstanceId": {
            "description": "Id of the succeeding instance id",
            "type": "string",
            "$ref": "uuid.json"
          },
          "title": {
            "type": "string",
            "description": "The primary title (or label) associated with the resource"
          },
          "hrid": {
            "type": "string",
            "description": "The human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID"
          },
          "identifiers": {
            "type": "array",
            "description": "An extensible set of name-value pairs of identifiers associated with the resource",
            "minItems": 0,
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "description": "Resource identifier value"
                },
                "identifierTypeId": {
                  "type": "string",
                  "description": "Resource identifier type (e.g. ISBN, ISSN, LCCN, CODEN, Locally defined identifiers)"
                }
              },
              "additionalProperties": false,
              "required": [
                "value",
                "identifierTypeId"
              ]
            }
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "source",
    "title",
    "instanceTypeId"
  ]
}
modify_item(itemId: str, item: dict)

Update item item with given {itemId}

PUT /inventory/items/{itemId}

Parameters

  • itemId (str) –

  • item (dict) – See Schema below

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestError – Bad Request

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
set_instance(instance: dict)

Create a new instance item.

POST /inventory/instances

Parameters

instance (dict) – See Schema below

Raises

  • OkapiRequestError – Bad Request

  • OkapiRequestUnauthorized – Authentication is required

  • OkapiRequestFatalError – Server Error

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

Headers

  • Location - URI to the created instance item

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An instance record",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The system assigned unique ID of the instance record"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID"
    },
    "matchKey": {
      "type": "string",
      "description": "An unique instance identifier matching a client-side bibliographic record identification. Could be an actual local identifier or a key generated from metadata in the local bibliographic record. Enables the client to determine if a client side bibliographic record already exists as an Instance in Inventory"
    },
    "source": {
      "type": "string",
      "description": "The metadata source and its format of the underlying record to the instance record. (e.g. FOLIO if it's a record created in Inventory;  MARC if it's a MARC record created in MARCcat or EPKB if it's a record coming from eHoldings)"
    },
    "parentInstances": {
      "description": "Array of parent instances",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Id of the parent instance",
            "type": "string"
          },
          "superInstanceId": {
            "description": "Id of the super instance",
            "type": "string"
          },
          "instanceRelationshipTypeId": {
            "description": "Id of the relationship type",
            "type": "string"
          }
        },
        "additionalProperties": false,
        "required": [
          "superInstanceId",
          "instanceRelationshipTypeId"
        ]
      }
    },
    "childInstances": {
      "description": "Child instances",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "subInstanceId": {
            "description": "Id of sub Instance",
            "type": "string"
          },
          "instanceRelationshipTypeId": {
            "description": "Id of the relationship type",
            "type": "string"
          }
        },
        "additionalProperties": false,
        "required": [
          "id",
          "subInstanceId",
          "instanceRelationshipTypeId"
        ]
      }
    },
    "title": {
      "type": "string",
      "description": "The primary title (or label) associated with the resource"
    },
    "indexTitle": {
      "type": "string",
      "description": "Title normalized for browsing and searching; based on the title with articles removed"
    },
    "alternativeTitles": {
      "type": "array",
      "description": "List of alternative titles for the resource (e.g. original language version title of a movie)",
      "items": {
        "type": "object",
        "properties": {
          "alternativeTitleTypeId": {
            "type": "string",
            "description": "ID for an alternative title qualifier"
          },
          "alternativeTitle": {
            "type": "string",
            "description": "An alternative title for the resource"
          },
          "authorityId": {
            "type": "string",
            "description": "UUID of authority record that controls an alternative title",
            "$ref": "uuid.json"
          }
        }
      },
      "uniqueItems": true
    },
    "editions": {
      "type": "array",
      "description": "The edition statement, imprint and other publication source information",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "series": {
      "type": "array",
      "description": "List of series titles associated with the resource (e.g. Harry Potter)",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "Series title value"
          },
          "authorityId": {
            "type": "string",
            "description": "UUID of authority record that controls an series title",
            "$ref": "uuid.json"
          }
        },
        "additionalProperties": false,
        "required": [
          "value"
        ]
      },
      "uniqueItems": true
    },
    "identifiers": {
      "type": "array",
      "description": "An extensible set of name-value pairs of identifiers associated with the resource",
      "minItems": 0,
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "Resource identifier value"
          },
          "identifierTypeId": {
            "type": "string",
            "description": "Resource identifier type (e.g. ISBN, ISSN, LCCN, CODEN, Locally defined identifiers)"
          }
        },
        "additionalProperties": false,
        "required": [
          "value",
          "identifierTypeId"
        ]
      }
    },
    "contributors": {
      "type": "array",
      "description": "List of contributors",
      "minItems": 0,
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Personal name, corporate name, meeting name"
          },
          "contributorTypeId": {
            "type": "string",
            "description": "ID for the contributor type term defined as a referencetable in settings"
          },
          "contributorTypeText": {
            "type": "string",
            "description": "Free text element for adding contributor type terms other that defined by the MARC code list for relators"
          },
          "contributorNameTypeId": {
            "type": "string",
            "description": "Contributor type terms defined by the MARC code list for relators"
          },
          "authorityId": {
            "type": "string",
            "description": "ID of authority record that controls the contributor",
            "$ref": "uuid.json"
          },
          "primary": {
            "type": "boolean",
            "description": "Whether this is the primary contributor"
          }
        },
        "additionalProperties": false,
        "required": [
          "name",
          "contributorNameTypeId"
        ]
      }
    },
    "subjects": {
      "type": "array",
      "description": "List of subject headings",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "Subject heading value"
          },
          "authorityId": {
            "type": "string",
            "description": "UUID of authority record that controls a subject heading",
            "$ref": "uuid.json"
          }
        },
        "additionalProperties": false,
        "required": [
          "value"
        ]
      },
      "uniqueItems": true
    },
    "classifications": {
      "type": "array",
      "description": "List of classifications",
      "minItems": 0,
      "items": {
        "type": "object",
        "properties": {
          "classificationNumber": {
            "type": "string",
            "description": "Classification (e.g. classification scheme, classification schedule)"
          },
          "classificationTypeId": {
            "type": "string",
            "description": "List of classification schemas (e.g. LC, Canadian Classification, NLM, National Agricultural Library, UDC, and Dewey)"
          }
        },
        "additionalProperties": false,
        "required": [
          "classificationNumber",
          "classificationTypeId"
        ]
      }
    },
    "publication": {
      "type": "array",
      "description": "List of publication items",
      "items": {
        "type": "object",
        "properties": {
          "publisher": {
            "type": "string",
            "description": "Name of publisher, distributor, etc."
          },
          "place": {
            "type": "string",
            "description": "Place of publication, distribution, etc."
          },
          "dateOfPublication": {
            "type": "string",
            "description": "Date (year YYYY) of publication, distribution, etc."
          },
          "role": {
            "type": "string",
            "description": "The role of the publisher, distributor, etc."
          }
        }
      }
    },
    "publicationFrequency": {
      "type": "array",
      "description": "List of intervals at which a serial appears (e.g. daily, weekly, monthly, quarterly, etc.)",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "publicationRange": {
      "type": "array",
      "description": "The range of sequential designation/chronology of publication, or date range",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "publicationPeriod": {
      "type": "object",
      "description": "Publication period",
      "properties": {
        "start": {
          "type": "integer",
          "description": "Publication start year"
        },
        "end": {
          "type": "integer",
          "description": "Publication end year"
        }
      },
      "additionalProperties": false
    },
    "electronicAccess": {
      "type": "array",
      "description": "List of electronic access items",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "The value of the MARC tag field 856 2nd indicator, where the values are: no information provided, resource, version of resource, related resource, no display constant generated"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship between the electronic resource at the location identified and the item described in the record as a whole"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "instanceTypeId": {
      "type": "string",
      "description": "The unique term for the resource type whether it's from the RDA content term list of locally defined"
    },
    "instanceFormatIds": {
      "type": "array",
      "description": "The unique term for the format whether it's from the RDA carrier term list of locally defined",
      "items": {
        "type": "string"
      }
    },
    "physicalDescriptions": {
      "type": "array",
      "description": "Physical description of the described resource, including its extent, dimensions, and such other physical details as a description of any accompanying materials and unit type and size",
      "items": {
        "type": "string"
      }
    },
    "languages": {
      "type": "array",
      "description": "The set of languages used by the resource",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "type": "array",
      "description": "Bibliographic notes (e.g. general notes, specialized notes), and administrative notes",
      "items": {
        "type": "object",
        "properties": {
          "instanceNoteTypeId": {
            "description": "ID of the type of note",
            "$ref": "uuid.json"
          },
          "note": {
            "type": "string",
            "description": "Text content of the note"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "If true, determines that the note should not be visible for others than staff",
            "default": false
          }
        }
      }
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "modeOfIssuanceId": {
      "type": "string",
      "description": "RDA mode of issuance is a categorization reflecting whether a resource is issued in one or more parts, the way it is updated, and whether its termination is predetermined or not (e.g. monograph,  sequential monograph, serial; integrating Resource, other)"
    },
    "catalogedDate": {
      "type": "string",
      "description": "Date or timestamp on an instance for when is was considered cataloged"
    },
    "previouslyHeld": {
      "type": "boolean",
      "description": "Records the fact that the resource was previously held by the library for things like Hathi access, etc."
    },
    "staffSuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed for others than catalogers"
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "List of statistical code IDs",
      "items": {
        "type": "string"
      }
    },
    "sourceRecordFormat": {
      "description": "Format of the instance source record, if a source record exists",
      "type": "string",
      "enum": [
        "MARC-JSON"
      ],
      "readonly": true
    },
    "statusId": {
      "type": "string",
      "description": "Instance status term (e.g. cataloged, uncatalogued, batch loaded, temporary, other, not yet assigned)"
    },
    "statusUpdatedDate": {
      "type": "string",
      "description": "Date [or timestamp] for when the instance status was updated"
    },
    "tags": {
      "description": "arbitrary tags associated with this instance",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "metadata": {
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "natureOfContentTermIds": {
      "type": "array",
      "description": "Array of UUID for the Instance nature of content (e.g. bibliography, biography, exhibition catalogue, festschrift, newspaper, proceedings, research report, thesis or website)",
      "items": {
        "type": "string",
        "description": "Single UUID for the Instance nature of content",
        "$ref": "uuid.json"
      }
    },
    "isBoundWith": {
      "description": "Indicates if this Instance is included in a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "precedingTitles": {
      "description": "Array of preceding titles",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Id of the preceding title",
            "type": "string",
            "$ref": "uuid.json"
          },
          "precedingInstanceId": {
            "description": "Id of the preceding instance id",
            "type": "string",
            "$ref": "uuid.json"
          },
          "title": {
            "type": "string",
            "description": "The primary title (or label) associated with the resource"
          },
          "hrid": {
            "type": "string",
            "description": "The human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID"
          },
          "identifiers": {
            "type": "array",
            "description": "An extensible set of name-value pairs of identifiers associated with the resource",
            "minItems": 0,
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "description": "Resource identifier value"
                },
                "identifierTypeId": {
                  "type": "string",
                  "description": "Resource identifier type (e.g. ISBN, ISSN, LCCN, CODEN, Locally defined identifiers)"
                }
              },
              "additionalProperties": false,
              "required": [
                "value",
                "identifierTypeId"
              ]
            }
          }
        },
        "additionalProperties": false
      }
    },
    "succeedingTitles": {
      "description": "Array of succeeding titles",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Id of the succeeding title",
            "type": "string",
            "$ref": "uuid.json"
          },
          "succeedingInstanceId": {
            "description": "Id of the succeeding instance id",
            "type": "string",
            "$ref": "uuid.json"
          },
          "title": {
            "type": "string",
            "description": "The primary title (or label) associated with the resource"
          },
          "hrid": {
            "type": "string",
            "description": "The human readable ID, also called eye readable ID. A system-assigned sequential ID which maps to the Instance ID"
          },
          "identifiers": {
            "type": "array",
            "description": "An extensible set of name-value pairs of identifiers associated with the resource",
            "minItems": 0,
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "type": "string",
                  "description": "Resource identifier value"
                },
                "identifierTypeId": {
                  "type": "string",
                  "description": "Resource identifier type (e.g. ISBN, ISSN, LCCN, CODEN, Locally defined identifiers)"
                }
              },
              "additionalProperties": false,
              "required": [
                "value",
                "identifierTypeId"
              ]
            }
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "source",
    "title",
    "instanceTypeId"
  ]
}
set_item(item: dict)

Create a new item item.

POST /inventory/items

Parameters

item (dict) – See Schema below

Raises

  • OkapiRequestError – Bad Request

  • OkapiRequestUnauthorized – Authentication is required

  • OkapiRequestFatalError – Server Error

Headers

  • Location - URI to the created item item

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
set_itemsByHoldingsId(itemsByHoldingsId: dict)

Create a new itemsByHoldingsId item.

POST /inventory/items-by-holdings-id

Parameters

itemsByHoldingsId (dict) – See Schema below

Raises

  • OkapiRequestError – Bad Request

  • OkapiRequestUnauthorized – Authentication is required

  • OkapiRequestFatalError – Server Error

Headers

  • Location - URI to the created itemsByHoldingsId item

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
set_markInProcess(itemId: str)

POST /inventory/items/{itemId}/mark-in-process

Parameters

itemId (str) –

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
set_markInProcessNonRequestable(itemId: str)

POST /inventory/items/{itemId}/mark-in-process-non-requestable

Parameters

itemId (str) –

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
set_markIntellectualItem(itemId: str)

POST /inventory/items/{itemId}/mark-intellectual-item

Parameters

itemId (str) –

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
set_markLongMissing(itemId: str)

POST /inventory/items/{itemId}/mark-long-missing

Parameters

itemId (str) –

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
set_markMissing(itemId: str)

POST /inventory/items/{itemId}/mark-missing

Parameters

itemId (str) –

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
set_markRestricted(itemId: str)

POST /inventory/items/{itemId}/mark-restricted

Parameters

itemId (str) –

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
set_markUnavailable(itemId: str)

POST /inventory/items/{itemId}/mark-unavailable

Parameters

itemId (str) –

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
set_markUnknown(itemId: str)

POST /inventory/items/{itemId}/mark-unknown

Parameters

itemId (str) –

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}
set_markWithdrawn(itemId: str)

POST /inventory/items/{itemId}/mark-withdrawn

Parameters

itemId (str) –

Returns

See Schema below

Return type

dict

Raises

  • OkapiRequestNotFound – Not Found

  • OkapiRequestUnprocessableEntity – Unprocessable Entity

  • OkapiRequestFatalError – Server Error

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "An item record",
  "type": "object",
  "properties": {
    "id": {
      "description": "Item id",
      "type": "string"
    },
    "_version": {
      "type": "integer",
      "description": "Record version for optimistic locking"
    },
    "hrid": {
      "type": "string",
      "description": "The human readable ID, also called eye readable ID. A system-assigned sequential alternate ID"
    },
    "holdingsRecordId": {
      "description": "ID of the holdings record the item is a member of",
      "type": "string"
    },
    "formerIds": {
      "type": "array",
      "description": "Previous identifiers assigned to the item",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "discoverySuppress": {
      "type": "boolean",
      "description": "Records the fact that the record should not be displayed in a discovery system"
    },
    "displaySummary": {
      "description": "Display summary about the item",
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Resouce title (read only, inherited from associated instance record)",
      "readonly": true
    },
    "contributorNames": {
      "description": "A list of contributor names",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "The contributor name",
            "type": "string"
          }
        }
      }
    },
    "callNumber": {
      "type": "string",
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record)",
      "readonly": true
    },
    "barcode": {
      "description": "Text, with input likely validated by the barcode scanner",
      "type": "string"
    },
    "effectiveShelvingOrder": {
      "type": "string",
      "description": "A system generated normalization of the call number that allows for call number sorting in reports and search results",
      "readonly": true
    },
    "accessionNumber": {
      "type": "string",
      "description": "Accession number is also called inventar number. Accession number is a unique number assigned to an item in the order in which it is added to a library collection. Most libraries assign accession numbers in continous numerical sequece, but some use a code system to indicate type of material and/or year of accession in addition to order of accession"
    },
    "itemLevelCallNumber": {
      "description": "Call number is an identifier assigned to an item, usually printed on a label attached to the item, and used to determine its physical position in a shelving sequence (e.g. K1 .M44, read only, inherited from associated holdings record). The item level call number, is the call number on item level",
      "type": "string"
    },
    "itemLevelCallNumberPrefix": {
      "description": "Prefix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberSuffix": {
      "description": "Suffix of the call number on the item level",
      "type": "string"
    },
    "itemLevelCallNumberTypeId": {
      "description": "Call number type, refers to a call-number-type reference record",
      "type": "string"
    },
    "effectiveCallNumberComponents": {
      "type": "object",
      "description": "Elements of a full call number generated from the item or holding",
      "properties": {
        "callNumber": {
          "type": "string",
          "description": "Effective Call Number is an identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "prefix": {
          "type": "string",
          "description": "Effective Call Number Prefix is the prefix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "suffix": {
          "type": "string",
          "description": "Effective Call Number Suffix is the suffix of the identifier assigned to an item or its holding and associated with the item.",
          "readonly": true
        },
        "typeId": {
          "type": "string",
          "description": "Effective Call Number Type Id is the call number type id assigned to the item or associated holding.",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    },
    "volume": {
      "description": "Volume is intended for monographs when a multipart monograph (e.g. a biography of Gerorge Bernard Shaw in three volumes)",
      "type": "string"
    },
    "enumeration": {
      "description": "Enumeration is the descriptive information for the numbering scheme of a serial, usually identified by level and a descriptive caption, e.g., level 0 = v. and level 1 = no. This means that each issue of the serial has a volume and an issue number that would appear (e.g. v.71:no.6-2)",
      "type": "string"
    },
    "chronology": {
      "description": "Chronology is the descriptive information for the dating scheme of a serial, usually identified by level, e.g., level 0 = year level 1 = month. This means that each issue of the serial has a month and a year on each issue (e.g. 1985:July-Dec.)",
      "type": "string"
    },
    "yearCaption": {
      "description": "In multipart monographs, a caption is characters used to label a level of chronology (e.g. 'year 1985')",
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "itemIdentifier": {
      "description": "Item identifier number, e.g. imported from the union catalogue (read only)",
      "type": "string"
    },
    "copyNumber": {
      "description": "Copy number is the piece identifier. The copy number reflects if the library has a copy of a single-volume monograph; a copy of a multi-volume, (e.g. Copy 1, or C.7.)",
      "type": "string"
    },
    "numberOfPieces": {
      "description": "Number of pieces. Used when an item is checked out or returned to verify that all parts are present (e.g. 7 CDs in a set)",
      "type": "string"
    },
    "descriptionOfPieces": {
      "description": "Text which descripe the pieces",
      "type": "string"
    },
    "numberOfMissingPieces": {
      "description": "Number of missing pieces",
      "type": "string"
    },
    "missingPieces": {
      "description": "Text which descripes the missing pieces",
      "type": "string"
    },
    "missingPiecesDate": {
      "description": "Date when the piece(s) went missing",
      "type": "string"
    },
    "itemDamagedStatusId": {
      "description": "Item Damage status Id, refers to an Item damage Status ID reference record",
      "type": "string"
    },
    "itemDamagedStatusDate": {
      "description": "Date when damage status was last changed",
      "type": "string"
    },
    "administrativeNotes": {
      "type": "array",
      "description": "Administrative notes",
      "minItems": 0,
      "items": {
        "type": "string"
      }
    },
    "notes": {
      "description": "notes",
      "type": "array",
      "items": {
        "$ref": "item-notes.json"
      }
    },
    "circulationNotes": {
      "type": "array",
      "description": "Notes to be displayed in circulation processes",
      "items": {
        "type": "object",
        "properties": {
          "noteType": {
            "type": "string",
            "description": "Type of circulation process that the note applies to",
            "enum": [
              "Check in",
              "Check out"
            ]
          },
          "note": {
            "type": "string",
            "description": "Text to display"
          },
          "staffOnly": {
            "type": "boolean",
            "description": "Records the fact that the note should only be displayed for staff",
            "default": false
          },
          "source": {
            "type": "object",
            "description": "The user who added/updated the note. The property is generated by the server and needed to support sorting.",
            "readonly": true,
            "properties": {
              "id": {
                "type": "string",
                "description": "The id of the user who added/updated the note",
                "readonly": true
              },
              "personal": {
                "type": "object",
                "description": "Personal information about the user",
                "readonly": true,
                "properties": {
                  "lastName": {
                    "type": "string",
                    "description": "The user's last name",
                    "readonly": true
                  },
                  "firstName": {
                    "type": "string",
                    "description": "The user's first name",
                    "readonly": true
                  }
                }
              }
            }
          },
          "date": {
            "type": "string",
            "description": "Date and time the record is added/updated. The property is generated by the server and needed to support sorting.",
            "readonly": true
          }
        },
        "additionalProperties": false
      }
    },
    "status": {
      "description": "The status of the item",
      "type": "object",
      "properties": {
        "name": {
          "description": "Name of the item state (e.g. Available, Checked out, In transit, Awaiting pickup, On order). Default value is set to: Available",
          "type": "string",
          "enum": [
            "Aged to lost",
            "Available",
            "Awaiting delivery",
            "Awaiting pickup",
            "Checked out",
            "Claimed returned",
            "Declared lost",
            "Lost and paid",
            "Long missing",
            "Missing",
            "In process",
            "In process (non-requestable)",
            "In transit",
            "Intellectual item",
            "On order",
            "Order closed",
            "Paged",
            "Restricted",
            "Unavailable",
            "Unknown",
            "Withdrawn"
          ]
        },
        "date": {
          "description": "Date of the current item state. E.g. date set when item state was changed by the Check out app",
          "type": "string",
          "readonly": true,
          "format": "date-time"
        }
      },
      "additionalProperties": false,
      "required": [
        "name"
      ]
    },
    "materialType": {
      "description": "Material type define what type of thing the item is",
      "type": "object",
      "properties": {
        "id": {
          "description": "Material type Id, refers to a material type reference record",
          "type": "string"
        },
        "name": {
          "description": "Material type name (e.g. Audio book, Audio disc, Computer file, Pamphelet) ",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "isBoundWith": {
      "description": "Indicates if this Item is a bound-with",
      "type": "boolean",
      "default": false,
      "readonly": true
    },
    "boundWithTitles": {
      "description": "List of titles that are bound together within this Item",
      "type": "array",
      "items": {
        "type": "object",
        "description": "A title that is bound with other titles within this Item",
        "properties": {
          "briefHoldingsRecord": {
            "type": "object",
            "description": "Information about a holdings record that links a title to the bound-with Item",
            "properties": {
              "id": {
                "description": "The UUID of the holdingsRecord",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the holdingsRecord",
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "briefInstance": {
            "type": "object",
            "description": "Information about an Instance / title that is bound with other title within this Item",
            "properties": {
              "id": {
                "description": "The UUID of the Instance",
                "type": "string"
              },
              "hrid": {
                "description": "The human-readable ID of the Instance",
                "type": "string"
              },
              "title": {
                "description": "The title of the Instance",
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "readonly": true
    },
    "permanentLoanType": {
      "description": "Permanent loan type, is the default loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLoanType": {
      "description": "Temporary loan type, is the temporary loan type for a given item. Loan types are tenant-defined in a reference table in Settings, Inventory, Item, Loan type (e.g. Can circulate, Course reserves, Reading room, Selected)",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary loan type Id, refers to a loan type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary loan type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "permanentLocation": {
      "description": "Permanent item location is the default location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Permanent location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Permanent location type name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "temporaryLocation": {
      "description": "Temporary item location is the temporarily location, shelving location, or holding which is a physical place where items are stored, or an Online location. The location is defined by Institutions, Campuses, libraries, and locations. Permanent location can be assigned at the holding level, and be overridden at the item level if needed",
      "type": "object",
      "properties": {
        "id": {
          "description": "Temporary location Id, refers to a location type reference record",
          "type": "string"
        },
        "name": {
          "description": "Temporary location name",
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "id"
      ]
    },
    "effectiveLocation": {
      "type": "object",
      "description": "The effective location is used by FOLIO and other integrated systems to know the current home location for the item (read only, derived from locations on HoldingsRecord and Item)",
      "readonly": true,
      "properties": {
        "id": {
          "type": "string",
          "readonly": true
        },
        "name": {
          "description": "Effective location name",
          "type": "string",
          "readonly": true
        }
      }
    },
    "electronicAccess": {
      "description": "Whether an item is available electronically",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "string",
            "description": "Uniform Resource Identifier\u00a0(URI) is a\u00a0string\u00a0of\u00a0characters\u00a0designed for unambiguous\u00a0identification\u00a0of\u00a0resources"
          },
          "linkText": {
            "type": "string",
            "description": "Link text is used for display in place of the URL"
          },
          "materialsSpecification": {
            "type": "string",
            "description": "Materials specified is used to specify to what portion or aspect of the resource the electronic location and access information applies (e.g. a portion or subset of the item is electronic, or a related electronic resource is being linked to the record)"
          },
          "publicNote": {
            "type": "string",
            "description": "URL public note to be displayed in the discovery"
          },
          "relationshipId": {
            "type": "string",
            "description": "Relationship Id, refers to a Relationship type reference record. Relationship between the electronic resource at the location identified and the item described in the record as a whole. (E.g. values from MARC 21, tag field 856 2nd indicator, where the values are: No information provided, Resource, Version of resource, Related resource, No display constant generate"
          }
        },
        "additionalProperties": false,
        "required": [
          "uri"
        ]
      }
    },
    "inTransitDestinationServicePointId": {
      "description": "Service point an item is intended to be transited to (should only be present when in transit)",
      "type": "string",
      "$ref": "uuid.json"
    },
    "statisticalCodeIds": {
      "type": "array",
      "description": "Statistical code Id, refers to a Statistical code reference record",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "purchaseOrderLineIdentifier": {
      "type": "string",
      "description": "ID referencing a remote purchase order object related to this item"
    },
    "metadata": {
      "description": "Metadata about creation and changes, provided by the server (client should not provide)",
      "type": "object",
      "$ref": "raml-util/schemas/metadata.schema",
      "readonly": true
    },
    "tags": {
      "description": "arbitrary tags associated with this item",
      "id": "tags",
      "type": "object",
      "$ref": "raml-util/schemas/tags.schema"
    },
    "lastCheckIn": {
      "type": "object",
      "additionalProperties": false,
      "description": "Information about when an item was last checked in",
      "properties": {
        "dateTime": {
          "type": "string",
          "description": "Date and time of the last check in of the item.",
          "format": "date-time",
          "readonly": true
        },
        "servicePointId": {
          "type": "string",
          "description": "Service point ID being used by a staff member when item was scanned in Check in app.",
          "$ref": "uuid.json",
          "readonly": true
        },
        "staffMemberId": {
          "type": "string",
          "description": "ID a staff member who scanned the item",
          "$ref": "uuid.json",
          "readonly": true
        }
      }
    }
  },
  "additionalProperties": false,
  "required": [
    "materialType",
    "permanentLoanType",
    "status"
  ]
}