Download OpenAPI specification:Download
The API supports two sets of endpoints, one targetted at library staff and the other at at library users.
Those endpoints under the /public
path are aimed at delivering functionality tailored to library users and offer
a more restricted set of functions, overrides and data in thier responses for data privacy and library policy
reasons. Many of these endpoints do not require authentication for fetching public data, though an authenticated
session will expose additional options and allow users to see more data where it is part of their own record.
All other endpoints are targetted at the staff interface level and allow for additional functionality and a more unrestricted view of data. These endpoints, however, have a level of redaction built in for resources that the api consumer should not have access to. For example, user data for users who do not belong to the same library or library group of your api user will be reduced to just minimum neccesary for a valid response. Object keys will be consistent for all responses, but their values may be removed depending on access.
The API supports the following authentication mechanisms
Both Basic authentication and the OAuth2 flow, need to be enabled by system preferences.
The API uses existing user profiles to restrict access to resources based on user permissions and the library the API user is assigned to. This may result, at times, in resources being returned in a redacted form with all keys present but sensative values nulled.
We do not yet support OAuth Scopes or the Authorization Code grant flow.
The API uses standard HTTP status codes to indicate the success or failure of the API call. The body of the response will be JSON in the following format:
{
"error": "Current settings prevent the passed due date to be applied",
"error_code": "invalid_due_date"
}
Note: Some routes might offer additional attributes in their error responses but that"s subject to change and thus not documented.
The API allows for some advanced response filtering using a JSON based query syntax. The query can be added to the requests:
q=
For simple field equality matches we can use { "fieldname": "value" }
where the fieldname
matches one of the fields as described in the particular endpoints response object.
We can refine that with more complex matching clauses by nesting a the clause into the
object; { "fieldname": { "clause": "value" } }
.
Available matching clauses include =
, !=
, <
, >
, <=
, >=
and -not
. We also support -like
and -not_like
string comparisons with %
used to denote wildcards, thus you can pass
{ "fieldname": { "-like": "value%" } }
to do a 'starts with' string match for example.
We can filter on multiple fields by adding them to the JSON respresentation. Adding at HASH
level will result in an "AND" query, whilst combinding them in an ARRAY
will result in an
"OR" query: { "field1": "value2", "field2": "value2" }
will filter the response to only those
results with both field1 containing value2 AND field2 containing value2 for example.
There is a collection of special operators also available to you, including:
-in
- Expects an array of values to perform an OR match against-not_in
- Expects an array of values to perform a NOR match against-between
- Expects two values which the value of the field is expected to fall between-not_between
- Expects two values which the value of the field is expected to fall outside of-ident
- Expects a second field name to match the two field values against-regexp
- Expects a perl compatible regular expression for which the value should matchLogic and nesting is also supported and you may use -and
and -or
to change the logic of an ARRAY
or HASH as described above.
Additionally, if you are requesting related data be embedded into the response one can query on the related data using dot notation in the field names.
The following request would return any patron with firstname "Henry" and lastname "Acevedo";
curl -u koha:koha --request GET "http://127.0.0.1:8081/api/v1/patrons/" --data-raw '{ "surname": "Acevedo", "firstname": "Henry" }'
The following request would return any patron whose lastname begins with "Ace";
curl -u koha:koha --request GET "http://127.0.0.1:8081/api/v1/patrons/" --data-raw '{ "surname": { "-like": "Ace%" }'
The following request would return any patron whose lastname is "Acevedo" OR "Bernardo"
curl -u koha:koha --request GET "http://127.0.0.1:8081/api/v1/patrons/" --data-raw '{ "surname": [ "Acevedo", "Bernardo" ] }'
The following request embeds the related patron extended attributes data and filters on it.
curl -u koha:koha =--request GET 'http://127.0.0.1:8081/api/v1/patrons/' --header 'x-koha-embed: extended_attributes' --data-raw '{ "extended_attributes.code": "internet", "extended_attributes.attribute": "1" }'
This optional header allows the api consumer to request additional related data to be returned in the api response. It also allows for cross referencing in the queries as described above. It accepts a comma delimited list of relation names.
Relations may on occasion also support dot delimited nesting to allow traversal.
This optional header should be passed to give your api request a library context; If it is not included in the request, then the request context will default to using your api comsumer"s assigned home library.
article_request_id required | integer Article request identifier |
cancellation_reason | string Article request cancellation reason |
notes | string Article request custom cancellation reason |
{- "error": "string",
- "error_code": "string"
}
patron_id required | integer Internal patron identifier |
article_request_id required | integer Article request identifier |
cancellation_reason | string Article request cancellation reason |
notes | string Article request custom cancellation reason |
{- "error": "string",
- "error_code": "string"
}
name | string Search on profile's name |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "profile_id": 0,
- "name": "string",
- "matcher_id": 0,
- "template_id": 0,
- "overlay_action": "string",
- "nomatch_action": "string",
- "item_action": "string",
- "parse_items": true,
- "record_type": "string",
- "encoding": "string",
- "format": "string",
- "comments": "string"
}
]
A JSON object containing a import batch profile
name | string name of this profile |
matcher_id | integer or null the id of the match rule used (matchpoints.matcher_id) |
template_id | integer or null the id of the marc modification template |
overlay_action | string or null how to handle duplicate records |
nomatch_action | string or null how to handle records where no match is found |
item_action | string or null what to do with item records |
parse_items | boolean or null should items be parsed |
record_type | string or null type of record in the batch |
encoding | string or null file encoding |
format | string or null marc format |
comments | string or null any comments added when the file was uploaded |
{- "name": "string",
- "matcher_id": 0,
- "template_id": 0,
- "overlay_action": "string",
- "nomatch_action": "string",
- "item_action": "string",
- "parse_items": true,
- "record_type": "string",
- "encoding": "string",
- "format": "string",
- "comments": "string"
}
{- "profile_id": 0,
- "name": "string",
- "matcher_id": 0,
- "template_id": 0,
- "overlay_action": "string",
- "nomatch_action": "string",
- "item_action": "string",
- "parse_items": true,
- "record_type": "string",
- "encoding": "string",
- "format": "string",
- "comments": "string"
}
import_batch_profile_id required | integer Internal profile identifier |
A JSON object containing a import batch profile
name | string name of this profile |
matcher_id | integer or null the id of the match rule used (matchpoints.matcher_id) |
template_id | integer or null the id of the marc modification template |
overlay_action | string or null how to handle duplicate records |
nomatch_action | string or null how to handle records where no match is found |
item_action | string or null what to do with item records |
parse_items | boolean or null should items be parsed |
record_type | string or null type of record in the batch |
encoding | string or null file encoding |
format | string or null marc format |
comments | string or null any comments added when the file was uploaded |
{- "name": "string",
- "matcher_id": 0,
- "template_id": 0,
- "overlay_action": "string",
- "nomatch_action": "string",
- "item_action": "string",
- "parse_items": true,
- "record_type": "string",
- "encoding": "string",
- "format": "string",
- "comments": "string"
}
{- "profile_id": 0,
- "name": "string",
- "matcher_id": 0,
- "template_id": 0,
- "overlay_action": "string",
- "nomatch_action": "string",
- "item_action": "string",
- "parse_items": true,
- "record_type": "string",
- "encoding": "string",
- "format": "string",
- "comments": "string"
}
This resource returns a list of patron allowed to be a manager for baskets
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "extended_attributes" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "patron_id": 0,
- "cardnumber": "string",
- "surname": "string",
- "firstname": "string",
- "middle_name": "string",
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "pronouns": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": "string",
- "phone": "string",
- "mobile": "string",
- "fax": "string",
- "secondary_email": "string",
- "secondary_phone": "string",
- "altaddress_street_number": "string",
- "altaddress_street_type": "string",
- "altaddress_address": "string",
- "altaddress_address2": "string",
- "altaddress_city": "string",
- "altaddress_state": "string",
- "altaddress_postal_code": "string",
- "altaddress_country": "string",
- "altaddress_email": "string",
- "altaddress_phone": "string",
- "date_of_birth": "2019-08-24",
- "library_id": "string",
- "category_id": "string",
- "date_enrolled": "2019-08-24",
- "expiry_date": "2019-08-24",
- "date_renewed": "2019-08-24",
- "incorrect_address": true,
- "patron_card_lost": true,
- "restricted": true,
- "staff_notes": "string",
- "relationship_type": "string",
- "gender": "string",
- "userid": "string",
- "opac_notes": "string",
- "altaddress_notes": "string",
- "statistics_1": "string",
- "statistics_2": "string",
- "autorenew_checkouts": true,
- "altcontact_firstname": "string",
- "altcontact_surname": "string",
- "altcontact_address": "string",
- "altcontact_address2": "string",
- "altcontact_city": "string",
- "altcontact_state": "string",
- "altcontact_postal_code": "string",
- "altcontact_country": "string",
- "altcontact_phone": "string",
- "sms_number": "string",
- "sms_provider_id": 0,
- "privacy": 0,
- "privacy_guarantor_checkouts": 0,
- "privacy_guarantor_fines": true,
- "check_previous_checkout": "string",
- "updated_on": "2019-08-24T14:15:22Z",
- "last_seen": "2019-08-24T14:15:22Z",
- "lang": "string",
- "login_attempts": 0,
- "overdrive_auth_token": "string",
- "anonymized": true,
- "extended_attributes": [
- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
], - "checkouts_count": 0,
- "overdues_count": 0,
- "account_balance": 0,
- "library": { },
- "protected": true,
- "_strings": { }
}
]
Add a bibliographic record to Koha. An optional x-framework-id
may be passed to specify the cataloguing framework to be used (instead
of the default).
The request body is expected to contain a MARC record in the format specified in
the Content-type
header you pass. Possible values for this header and the corresponding
record formats expected are listed below:
x-framework-id | string Framework id. Use when content type is not application/json |
x-record-schema | string Enum: "MARC21" "UNIMARC" March schema. One of MARC21 or UNIMARC |
x-confirm-not-duplicate | integer Confirm the posted element is not a duplicate |
x-record-source-id | string Internal record source identifier. |
{- "error": "string",
- "error_code": "string"
}
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
{- "error": "string",
- "error_code": "string"
}
Updates a bibliographic record to Koha. An optional x-framework-id
may be passed, to specify the cataloguing framework to be used (instead
of the default).
The request body is expected to contain a MARC record in the format specified by
the Content-type
header passed. Possible values for this headers and the corresponding
record formats expected are listed below:
biblio_id required | integer Record internal identifier |
x-framework-id | string Framework id. Use when content type is not application/json |
x-record-schema | string Enum: "MARC21" "UNIMARC" March schema. One of MARC21 or UNIMARC |
x-confirm-not-duplicate | integer Confirm the posted element is not a duplicate |
{- "error": "string",
- "error_code": "string"
}
biblio_id required | integer Record internal identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
bookable | boolean Limit to items that are bookable |
x-koha-embed | Array of strings Items Enum: "+strings" "home_library" "holding_library" "biblio.title" "checkout" "checkout.patron" "transfer" "transfer+strings" "first_hold" "first_hold+strings" "first_hold.patron" "first_hold.desk" "recall" "recall+strings" "recall.patron" "item_type" "in_bundle" "bundle_host" "bundle_items_lost+count" "bundle_items_not_lost+count" "course_item.course_reserves.course" "analytics_count" "cover_image_ids" "item_group_item.item_group.description" "serial_item.serial" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
]
biblio_id required | integer Record internal identifier |
A JSON object containing information about the new item
item_id | integer Internal item identifier |
biblio_id | integer Internal identifier for the parent bibliographic record |
external_id | string or null The item's barcode |
acquisition_date | string or null <date> The date the item was acquired |
acquisition_source | string or null Information about the acquisition source (it is not really a vendor id) |
bookable | boolean Allow bookings on this item. |
home_library_id | string or null Internal library id for the library the item belongs to |
purchase_price | number or null Purchase price |
replacement_price | number or null Cost the library charges to replace the item (e.g. if lost) |
replacement_price_date | string or null <date> The date the replacement price is effective from |
last_checkout_date | string or null <date> The date the item was last checked out |
last_seen_date | string or null <date-time> The date the item barcode was last scanned |
not_for_loan_status | integer Authorized value defining why this item is not for loan |
effective_not_for_loan_status | integer Authorized value defining why this item is not for not_for_loan_status |
damaged_status | integer Authorized value defining this item as damaged |
damaged_date | string or null The date and time an item was last marked as damaged, NULL if not damaged |
lost_status | integer Authorized value defining this item as lost |
lost_date | string or null <date-time> The date and time an item was last marked as lost, NULL if not lost |
withdrawn | integer Authorized value defining this item as withdrawn |
withdrawn_date | string or null <date-time> The date and time an item was last marked as withdrawn, NULL if not withdrawn |
callnumber | string or null Call number for this item |
coded_location_qualifier | string or null Coded location qualifier |
checkouts_count | integer or null Number of times this item has been checked out/issued |
renewals_count | integer or null Number of times this item has been renewed |
localuse | integer or null Number of times this item has been recorded for localuse |
holds_count | integer or null Number of times this item has been placed on hold/reserved |
restricted_status | integer or null Authorized value defining use restrictions for this item |
public_notes | string or null Public notes on this item |
internal_notes | string or null Non-public notes on this item |
holding_library_id | string or null Library that is currently in possession item |
timestamp | string <date-time> Date and time this item was last altered |
location | string or null Authorized value for the shelving location for this item |
permanent_location | string or null Linked to the CART and PROC temporary locations feature, stores the permanent shelving location |
checked_out_date | string or null <date> Defines if item is checked out (NULL for not checked out, and checkout date for checked out) |
call_number_source | string or null Classification source used on this item |
call_number_sort | string or null ? |
collection_code | string or null Authorized value for the collection code associated with this item |
materials_notes | string or null Materials specified |
uri | string or null URL for the item |
item_type_id | string or null Itemtype defining the type for this item |
effective_item_type_id | string or null Effective itemtype defining the type for this item_id |
extended_subfields | string or null Additional 952 subfields in XML format |
serial_issue_number | string or null serial enumeration/chronology for the item |
copy_number | string or null Copy number |
inventory_number | string or null Inventory number |
new_status | string or null 'new' value, whatever free-text information. |
exclude_from_local_holds_priority | boolean Exclude this item from local holds priority. |
return_claims | Array of any An array of all return claims associated with this item |
return_claim | object or null |
home_library | object or null |
holding_library | object or null |
cover_image_ids | Array of any or null |
item_group_item | object or null |
serial_item | object or null |
biblio | object or null |
checkout | object or null |
transfer | object or null |
first_hold | object or null |
recall | object or null |
item_type | object or null |
in_bundle | boolean or null |
bundle_host | object or null |
bundle_items_lost_count | integer or null Number of lost items in the bundle |
bundle_items_not_lost_count | integer or null Number of items not lost in the bundle |
course_item | object or null |
analytics_count | integer or null |
_strings | object or null A return claims object if one exists that's unresolved |
{- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
{- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
biblio_id required | integer Record internal identifier |
item_id required | integer Internal item identifier |
A JSON object containing information about the item
item_id | integer Internal item identifier |
biblio_id | integer Internal identifier for the parent bibliographic record |
external_id | string or null The item's barcode |
acquisition_date | string or null <date> The date the item was acquired |
acquisition_source | string or null Information about the acquisition source (it is not really a vendor id) |
bookable | boolean Allow bookings on this item. |
home_library_id | string or null Internal library id for the library the item belongs to |
purchase_price | number or null Purchase price |
replacement_price | number or null Cost the library charges to replace the item (e.g. if lost) |
replacement_price_date | string or null <date> The date the replacement price is effective from |
last_checkout_date | string or null <date> The date the item was last checked out |
last_seen_date | string or null <date-time> The date the item barcode was last scanned |
not_for_loan_status | integer Authorized value defining why this item is not for loan |
effective_not_for_loan_status | integer Authorized value defining why this item is not for not_for_loan_status |
damaged_status | integer Authorized value defining this item as damaged |
damaged_date | string or null The date and time an item was last marked as damaged, NULL if not damaged |
lost_status | integer Authorized value defining this item as lost |
lost_date | string or null <date-time> The date and time an item was last marked as lost, NULL if not lost |
withdrawn | integer Authorized value defining this item as withdrawn |
withdrawn_date | string or null <date-time> The date and time an item was last marked as withdrawn, NULL if not withdrawn |
callnumber | string or null Call number for this item |
coded_location_qualifier | string or null Coded location qualifier |
checkouts_count | integer or null Number of times this item has been checked out/issued |
renewals_count | integer or null Number of times this item has been renewed |
localuse | integer or null Number of times this item has been recorded for localuse |
holds_count | integer or null Number of times this item has been placed on hold/reserved |
restricted_status | integer or null Authorized value defining use restrictions for this item |
public_notes | string or null Public notes on this item |
internal_notes | string or null Non-public notes on this item |
holding_library_id | string or null Library that is currently in possession item |
timestamp | string <date-time> Date and time this item was last altered |
location | string or null Authorized value for the shelving location for this item |
permanent_location | string or null Linked to the CART and PROC temporary locations feature, stores the permanent shelving location |
checked_out_date | string or null <date> Defines if item is checked out (NULL for not checked out, and checkout date for checked out) |
call_number_source | string or null Classification source used on this item |
call_number_sort | string or null ? |
collection_code | string or null Authorized value for the collection code associated with this item |
materials_notes | string or null Materials specified |
uri | string or null URL for the item |
item_type_id | string or null Itemtype defining the type for this item |
effective_item_type_id | string or null Effective itemtype defining the type for this item_id |
extended_subfields | string or null Additional 952 subfields in XML format |
serial_issue_number | string or null serial enumeration/chronology for the item |
copy_number | string or null Copy number |
inventory_number | string or null Inventory number |
new_status | string or null 'new' value, whatever free-text information. |
exclude_from_local_holds_priority | boolean Exclude this item from local holds priority. |
return_claims | Array of any An array of all return claims associated with this item |
return_claim | object or null |
home_library | object or null |
holding_library | object or null |
cover_image_ids | Array of any or null |
item_group_item | object or null |
serial_item | object or null |
biblio | object or null |
checkout | object or null |
transfer | object or null |
first_hold | object or null |
recall | object or null |
item_type | object or null |
in_bundle | boolean or null |
bundle_host | object or null |
bundle_items_lost_count | integer or null Number of lost items in the bundle |
bundle_items_not_lost_count | integer or null Number of items not lost in the bundle |
course_item | object or null |
analytics_count | integer or null |
_strings | object or null A return claims object if one exists that's unresolved |
{- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
{- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
biblio_id required | integer Record internal identifier |
patron_id required | integer Internal patron identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
Query filter sent through request"s body
{ }
[- {
- "library_id": "string",
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "postal_code": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "illemail": "string",
- "reply_to_email": "string",
- "return_path_email": "string",
- "url": "string",
- "ip": "string",
- "notes": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "pickup_items": [
- 0
], - "public": true,
- "smtp_server": { },
- "needs_override": true,
- "library_hours": [
- null
], - "cash_registers": [
- null
], - "desks": [
- null
]
}
]
biblio_id required | string Bilblionumber |
JSON Object with params and an optional marc record in MARC-in-JSON format
biblio_id_to_merge required | integer Biblionumber from which to merge |
rules | string or null Internally identifier of a merge algoritm. Now two identifier are supported, 'override' and 'override_ext'. 'override' is to use when you the bibliographic data of biblio_id as resulting bibliographic data. The null value is equivalent of 'override'. 'override_ext' is to use only with a value in datarecord field. In fact is mandatory to use if you insert a record inside datarecord field. |
framework_to_use | string or null Framework code, you can use it only with a value in datarecord field. With null value it uses the framework code of record to be merged into. |
datarecord | object or null Bibliographic record used as result of the merge. It uses the format MARC-in-JSON |
{- "biblio_id_to_merge": 0,
- "rules": "string",
- "framework_to_use": "string",
- "datarecord": { }
}
{- "error": "string",
- "error_code": "string"
}
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
{- "error": "string",
- "error_code": "string"
}
biblio_id required | integer Record internal identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "+strings" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
]
biblio_id required | integer Record internal identifier |
A JSON object containing rating information
rating required | integer or null the rating |
{- "rating": 0
}
{- "rating": 0,
- "average": 0,
- "count": 0
}
biblio_id | string Case insensative search on booking biblio_id |
item_id | string Case insensative search on booking item_id |
patron_id | string Case insensative search on booking patron_id |
start_date | string Case Insensative search on booking start_date |
end_date | string Case Insensative search on booking end_date |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Enum: "biblio" "item" "patron" "pickup_library" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "biblio_id": 0,
- "biblio": { },
- "booking_id": 0,
- "end_date": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "item": { },
- "patron_id": 0,
- "patron": { },
- "pickup_library_id": "string",
- "pickup_library": { },
- "start_date": "2019-08-24T14:15:22Z"
}
]
A JSON object containing informations about the new booking
biblio_id required | integer Internal identifier for the parent bibliographic record |
biblio | object Embedable biblio representation |
booking_id | integer Internal booking identifier |
end_date required | string <date-time> Start date and time of this booking |
item_id required | integer or null Internal item identifier |
item | object or null Embedable item representation |
patron_id required | integer Internal patron identifier |
patron | object or null Embedable patron representation |
pickup_library_id required | string Internal pickup_library identifier |
pickup_library | object or null Embedable pickup_library representation |
start_date required | string <date-time> Start date and time of this booking |
{- "biblio_id": 0,
- "biblio": { },
- "booking_id": 0,
- "end_date": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "item": { },
- "patron_id": 0,
- "patron": { },
- "pickup_library_id": "string",
- "pickup_library": { },
- "start_date": "2019-08-24T14:15:22Z"
}
{- "biblio_id": 0,
- "biblio": { },
- "booking_id": 0,
- "end_date": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "item": { },
- "patron_id": 0,
- "patron": { },
- "pickup_library_id": "string",
- "pickup_library": { },
- "start_date": "2019-08-24T14:15:22Z"
}
booking_id required | integer Booking identifier |
{- "biblio_id": 0,
- "biblio": { },
- "booking_id": 0,
- "end_date": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "item": { },
- "patron_id": 0,
- "patron": { },
- "pickup_library_id": "string",
- "pickup_library": { },
- "start_date": "2019-08-24T14:15:22Z"
}
booking_id required | integer Booking identifier |
A booking object
biblio_id required | integer Internal identifier for the parent bibliographic record |
biblio | object Embedable biblio representation |
booking_id | integer Internal booking identifier |
end_date required | string <date-time> Start date and time of this booking |
item_id required | integer or null Internal item identifier |
item | object or null Embedable item representation |
patron_id required | integer Internal patron identifier |
patron | object or null Embedable patron representation |
pickup_library_id required | string Internal pickup_library identifier |
pickup_library | object or null Embedable pickup_library representation |
start_date required | string <date-time> Start date and time of this booking |
{- "biblio_id": 0,
- "biblio": { },
- "booking_id": 0,
- "end_date": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "item": { },
- "patron_id": 0,
- "patron": { },
- "pickup_library_id": "string",
- "pickup_library": { },
- "start_date": "2019-08-24T14:15:22Z"
}
{- "biblio_id": 0,
- "biblio": { },
- "booking_id": 0,
- "end_date": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "item": { },
- "patron_id": 0,
- "patron": { },
- "pickup_library_id": "string",
- "pickup_library": { },
- "start_date": "2019-08-24T14:15:22Z"
}
biblio_id required | integer Record internal identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Enum: "item" "patron" "pickup_library" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "biblio_id": 0,
- "biblio": { },
- "booking_id": 0,
- "end_date": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "item": { },
- "patron_id": 0,
- "patron": { },
- "pickup_library_id": "string",
- "pickup_library": { },
- "start_date": "2019-08-24T14:15:22Z"
}
]
library_id required | string Internal library identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "cash_register_id": 0,
- "name": "string",
- "library_id": "string",
- "description": "string",
- "starting_float": 0,
- "archived": true,
- "library_default": true
}
]
cash_register_id required | integer Cash register internal identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Value: "manager" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "cashup_id": 0,
- "cash_register_id": 0,
- "manager_id": 0,
- "manager": { },
- "amount": 0,
- "timestamp": "2019-08-24T14:15:22Z",
- "summary": { }
}
]
cashup_id required | integer Cashup internal identifier |
x-koha-embed | Array of strings Items Value: "summary" Embed list sent as a request header |
{- "cashup_id": 0,
- "cash_register_id": 0,
- "manager_id": 0,
- "manager": { },
- "amount": 0,
- "timestamp": "2019-08-24T14:15:22Z",
- "summary": { }
}
biblio_id required | integer Record internal identifier |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
q | Array of strings Query filter sent as a request parameter |
checked_in | boolean By default, current checkouts are returned, when this is true then checked in checkouts are returned as result. |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "issuer" "item" "patron" "library" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
]
patron_id | integer Internal patron identifier |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
q | Array of strings Query filter sent as a request parameter |
checked_in | boolean By default, current checkouts are returned, when this is true then checked in checkouts are returned as result. |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "issuer" "renewals" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
]
confirmation | string A JWT confirmation token |
A JSON object containing information about the new checkout
checkout_id | integer internally assigned checkout identifier |
patron_id | integer Internal patron identifier |
item_id | integer or null internal identifier of checked out item |
due_date | string <date-time> Due date |
library_id | string or null code of the library the item was checked out |
issuer_id | integer or null internally assigned for the user that processed the checkout |
checkin_date | string or null <date-time> Date the item was returned |
last_renewed_date | string or null <date-time> Date the item was last renewed |
renewals_count | integer or null Number of renewals |
unseen_renewals | integer or null Number of consecutive unseen renewals |
auto_renew | boolean Auto renewal |
auto_renew_error | string or null Auto renewal error |
timestamp | string Last update time |
checkout_date | string <date-time> Date the item was issued |
onsite_checkout | boolean On site checkout |
note | string or null Issue note text |
note_date | string or null <date> Datetime of the issue note |
note_seen | boolean or null has the note been seen already |
issuer | object or null The object representing the checkout issuer |
item | object or null The object representing the checked out item |
library | object or null The object representing the checkout library |
patron | object or null The object representing the checkout patron |
{- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
{- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
checkout_id required | integer Internal checkout identifier |
x-koha-embed | Array of strings Items Enum: "issuer" "renewals" Embed list sent as a request header |
{- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
checkout_id required | integer Internal checkout identifier |
{- "allows_renewal": true,
- "max_renewals": 0,
- "current_renewals": 0,
- "unseen_renewals": 0,
- "error": "string"
}
checkout_id required | integer Internal checkout identifier |
seen | integer Item was seen flag |
{- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
checkout_id required | integer Internal checkout identifier |
x-koha-embed | Array of strings Items Value: "renewer" Embed list sent as a request header |
[- {
- "renewal_id": 0,
- "checkout_id": 0,
- "interface": "string",
- "renewer_id": 0,
- "renewal_date": "2019-08-24T14:15:22Z",
- "seen": true,
- "timestamp": "string",
- "renewal_type": "Automatic",
- "renewer": { }
}
]
checkout_id required | integer Internal checkout identifier |
seen | integer Item was seen flag |
{- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
patron_id | integer Internal patron identifier |
item_id | integer Internal item identifier |
{- "blockers": { },
- "confirms": { },
- "warnings": { },
- "confirmation_token": "string"
}
patron_id required | integer Internal patron identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Value: "cancellation_requested" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
]
patron_id | integer Internal patron identifier |
item_id | integer Internal item identifier |
{- "blockers": { },
- "confirms": { },
- "warnings": { },
- "confirmation_token": "string"
}
patron_id required | integer Internal patron identifier |
confirmation | string A JWT confirmation token |
A JSON object containing information about the new checkout
checkout_id | integer internally assigned checkout identifier |
patron_id | integer Internal patron identifier |
item_id | integer or null internal identifier of checked out item |
due_date | string <date-time> Due date |
library_id | string or null code of the library the item was checked out |
issuer_id | integer or null internally assigned for the user that processed the checkout |
checkin_date | string or null <date-time> Date the item was returned |
last_renewed_date | string or null <date-time> Date the item was last renewed |
renewals_count | integer or null Number of renewals |
unseen_renewals | integer or null Number of consecutive unseen renewals |
auto_renew | boolean Auto renewal |
auto_renew_error | string or null Auto renewal error |
timestamp | string Last update time |
checkout_date | string <date-time> Date the item was issued |
onsite_checkout | boolean On site checkout |
note | string or null Issue note text |
note_date | string or null <date> Datetime of the issue note |
note_seen | boolean or null has the note been seen already |
issuer | object or null The object representing the checkout issuer |
item | object or null The object representing the checked out item |
library | object or null The object representing the checkout library |
patron | object or null The object representing the checkout patron |
{- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
{- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
library_id required | string Internal library identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "desk_id": 0,
- "name": "string",
- "library_id": "string"
}
]
name | string Case insensative search on city name |
state | string Case insensative search on city state |
country | string Case insensative search on city country |
postal_code | string Case Insensative search on city postal code |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "city_id": 0,
- "name": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string"
}
]
A JSON object containing informations about the new hold
name required | string city name |
state required | string or null city state |
postal_code required | string or null city postal code |
country required | string or null city country |
{- "name": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string"
}
{- "city_id": 0,
- "name": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string"
}
city_id required | integer City internal identifier |
A city object
name required | string city name |
state required | string or null city state |
postal_code required | string or null city postal code |
country required | string or null city country |
{- "name": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string"
}
{- "city_id": 0,
- "name": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string"
}
club_id required | integer Internal club identifier |
A JSON object containing informations about the new hold
biblio_id | integer or null Internal biblio identifier |
item_id | integer or null Internal item identifier |
pickup_library_id required | string Internal library identifier for the pickup library |
expiration_date | string or null <date> Hold end date |
notes | string or null Notes related to this hold |
item_type | string or null Limit hold on one itemtype (ignored for item-level holds) |
default_patron_home | integer For each patron, set pickup location to patron's home library if possible |
{- "biblio_id": 0,
- "item_id": 0,
- "pickup_library_id": "string",
- "expiration_date": "2019-08-24",
- "notes": "string",
- "item_type": "string",
- "default_patron_home": 0
}
{- "club_hold_id": 0,
- "club_id": 0,
- "biblio_id": 0,
- "item_id": "string",
- "date_created": "2019-08-24T14:15:22Z"
}
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "vendor" "basket" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "id": 0,
- "type": "string",
- "transfer_date": "2019-08-24",
- "vendor_id": "string",
- "vendor": { },
- "edi_acct": "string",
- "status": "string",
- "basket_id": "string",
- "basket": { },
- "raw_msg": "string",
- "filename": "string"
}
]
agreement_id | integer Case insensitive search on agreement agreement_id |
vendor_id | integer Case insensitive search on agreement vendor_id |
name | string Case insensitive search on agreement name |
description | string Case insensitive search on agreement description |
status | string Case insensitive search on agreement status |
closure_reason | string Case insensitive search on agreement closure_reason |
is_perpetual | boolean Case insensitive search on agreement is_perpetual |
renewal_priority | string Case insensitive search on agreement renewal_priority |
license_info | string Case insensitive search on agreement license_info |
max_expiration_date | string <date> filter by expired agreements |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Enum: "user_roles" "vendor" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "agreement_id": 0,
- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "status": "string",
- "closure_reason": "string",
- "is_perpetual": true,
- "renewal_priority": "string",
- "license_info": "string",
- "periods": [
- {
- "agreement_period_id": 0,
- "agreement_id": 0,
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "cancellation_deadline": "2019-08-24",
- "notes": "string"
}
], - "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "agreement_relationships": [
- {
- "agreement_id": 0,
- "related_agreement_id": 0,
- "relationship": "supersedes",
- "notes": "string"
}
], - "agreement_licenses": [
- {
- "agreement_license_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "status": "string",
- "physical_location": "string",
- "notes": "string",
- "uri": "string"
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_type": "string",
- "file_description": "string",
- "file_content": "string",
- "uploaded_on": "2019-08-24T14:15:22Z",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
]
A JSON object containing information about the new agreement
vendor_id | integer or null foreign key to aqbooksellers | ||||||||||||||||||
name required | string name of the agreement | ||||||||||||||||||
description | string or null description of the agreement | ||||||||||||||||||
status required | string current status of the agreement | ||||||||||||||||||
closure_reason | string or null reason of the closure | ||||||||||||||||||
is_perpetual required | boolean is the agreement perpetual | ||||||||||||||||||
renewal_priority | string or null priority of the renewal | ||||||||||||||||||
license_info | string or null info about the license | ||||||||||||||||||
Array of objects (erm_agreement_period) periods defined for this agreement | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects (erm_user_role) role for users | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects (erm_agreement_relationship) agreement relationships | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects (erm_agreement_license) agreement licenses | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects (erm_document) documents | |||||||||||||||||||
Array
| |||||||||||||||||||
vendor | object or null Information about the vendor |
{- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "status": "string",
- "closure_reason": "string",
- "is_perpetual": true,
- "renewal_priority": "string",
- "license_info": "string",
- "periods": [
- {
- "agreement_id": 0,
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "cancellation_deadline": "2019-08-24",
- "notes": "string"
}
], - "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "agreement_relationships": [
- {
- "agreement_id": 0,
- "related_agreement_id": 0,
- "relationship": "supersedes",
- "notes": "string"
}
], - "agreement_licenses": [
- {
- "agreement_license_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "status": "string",
- "physical_location": "string",
- "notes": "string",
- "uri": "string"
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_description": "string",
- "file_content": "string",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
[- {
- "agreement_id": 0,
- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "status": "string",
- "closure_reason": "string",
- "is_perpetual": true,
- "renewal_priority": "string",
- "license_info": "string",
- "periods": [
- {
- "agreement_period_id": 0,
- "agreement_id": 0,
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "cancellation_deadline": "2019-08-24",
- "notes": "string"
}
], - "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "agreement_relationships": [
- {
- "agreement_id": 0,
- "related_agreement_id": 0,
- "relationship": "supersedes",
- "notes": "string"
}
], - "agreement_licenses": [
- {
- "agreement_license_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "status": "string",
- "physical_location": "string",
- "notes": "string",
- "uri": "string"
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_type": "string",
- "file_description": "string",
- "file_content": "string",
- "uploaded_on": "2019-08-24T14:15:22Z",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
]
agreement_id required | integer Agreement internal identifier |
x-koha-embed | Array of strings Items Enum: "periods" "user_roles" "user_roles.patron" "agreement_licenses" "agreement_licenses.license" "agreement_relationships" "agreement_relationships.agreement" "agreement_relationships.related_agreement" "agreement_packages" "agreement_packages.package" "documents" "vendor" Embed list sent as a request header |
[- {
- "agreement_id": 0,
- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "status": "string",
- "closure_reason": "string",
- "is_perpetual": true,
- "renewal_priority": "string",
- "license_info": "string",
- "periods": [
- {
- "agreement_period_id": 0,
- "agreement_id": 0,
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "cancellation_deadline": "2019-08-24",
- "notes": "string"
}
], - "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "agreement_relationships": [
- {
- "agreement_id": 0,
- "related_agreement_id": 0,
- "relationship": "supersedes",
- "notes": "string"
}
], - "agreement_licenses": [
- {
- "agreement_license_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "status": "string",
- "physical_location": "string",
- "notes": "string",
- "uri": "string"
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_type": "string",
- "file_description": "string",
- "file_content": "string",
- "uploaded_on": "2019-08-24T14:15:22Z",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
]
agreement_id required | integer Agreement internal identifier |
x-koha-embed | Array of strings Items Enum: "periods" "user_roles" "agreement_licenses" "agreement_relationships" "documents" Embed list sent as a request header |
A JSON object containing new information about existing agreement
vendor_id | integer or null foreign key to aqbooksellers | ||||||||||||||||||
name required | string name of the agreement | ||||||||||||||||||
description | string or null description of the agreement | ||||||||||||||||||
status required | string current status of the agreement | ||||||||||||||||||
closure_reason | string or null reason of the closure | ||||||||||||||||||
is_perpetual required | boolean is the agreement perpetual | ||||||||||||||||||
renewal_priority | string or null priority of the renewal | ||||||||||||||||||
license_info | string or null info about the license | ||||||||||||||||||
Array of objects (erm_agreement_period) periods defined for this agreement | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects (erm_user_role) role for users | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects (erm_agreement_relationship) agreement relationships | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects (erm_agreement_license) agreement licenses | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects (erm_document) documents | |||||||||||||||||||
Array
| |||||||||||||||||||
vendor | object or null Information about the vendor |
{- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "status": "string",
- "closure_reason": "string",
- "is_perpetual": true,
- "renewal_priority": "string",
- "license_info": "string",
- "periods": [
- {
- "agreement_id": 0,
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "cancellation_deadline": "2019-08-24",
- "notes": "string"
}
], - "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "agreement_relationships": [
- {
- "agreement_id": 0,
- "related_agreement_id": 0,
- "relationship": "supersedes",
- "notes": "string"
}
], - "agreement_licenses": [
- {
- "agreement_license_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "status": "string",
- "physical_location": "string",
- "notes": "string",
- "uri": "string"
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_description": "string",
- "file_content": "string",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
[- {
- "agreement_id": 0,
- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "status": "string",
- "closure_reason": "string",
- "is_perpetual": true,
- "renewal_priority": "string",
- "license_info": "string",
- "periods": [
- {
- "agreement_period_id": 0,
- "agreement_id": 0,
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "cancellation_deadline": "2019-08-24",
- "notes": "string"
}
], - "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "agreement_relationships": [
- {
- "agreement_id": 0,
- "related_agreement_id": 0,
- "relationship": "supersedes",
- "notes": "string"
}
], - "agreement_licenses": [
- {
- "agreement_license_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "status": "string",
- "physical_location": "string",
- "notes": "string",
- "uri": "string"
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_type": "string",
- "file_description": "string",
- "file_content": "string",
- "uploaded_on": "2019-08-24T14:15:22Z",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
]
erm_counter_files_id | integer Case insensitive search on counter_file erm_counter_files_id |
usage_data_provider_id | integer Case insensitive search on counter_file usage_data_provider_id |
filename | string Case insensitive search on counter_file filename |
type | string Case insensitive search on counter_file type |
file_content | string Case insensitive search on counter_file file_content |
date_uploaded | string Case insensitive search on counter_file date_uploaded |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "counter_logs" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "erm_counter_files_id": 0,
- "usage_data_provider_id": 0,
- "type": "string",
- "filename": "string",
- "file_content": "string",
- "date_uploaded": "2019-08-24T14:15:22Z",
- "counter_logs": [
- {
- "erm_counter_log_id": 0,
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
}
]
usage_data_provider_id | integer Case insensitive search on counter_log usage_data_provider_id |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
Query filter sent through request"s body
{ }
[- {
- "erm_counter_log_id": 0,
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
Query filter sent through request"s body
{ }
[- {
- "id": "string",
- "name": "string",
- "abbrev": "string",
- "content_provider_name": "string",
- "host_types": [
- { }
], - "address": "string",
- "address_country": { },
- "website": "string",
- "contact": { },
- "reports": [
- { }
], - "sushi_services": [
- { }
], - "audited": true
}
]
erm_default_usage_report_id | integer Case insensitive search on erm_default_usage_report_id |
report_name | integer Case insensitive search on default_usage_report report_name |
report_url_params | integer Case insensitive search on default_usage_report report_url_params |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
Query filter sent through request"s body
{ }
[- {
- "erm_default_usage_report_id": 0,
- "report_name": "string",
- "report_url_params": "string"
}
]
A JSON object containing information about the new default_usage_report
report_name required | string report_name |
report_url_params required | string report_url_params |
{- "report_name": "string",
- "report_url_params": "string"
}
[- {
- "erm_default_usage_report_id": 0,
- "report_name": "string",
- "report_url_params": "string"
}
]
provider required | string Provider name |
package_id | string Case insensitive search on package package_id |
vendor_id | integer Case insensitive search on package vendor_id |
name | string Case insensitive search on package name |
external_package_id | integer Case insensitive search on package external_package_id |
package_type | string Case insensitive search on package type |
content_type | string Case insensitive search on package content_type |
notes | string Case insensitive search on package notes |
created_on | string Case insensitive search on package creation date |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Enum: "vendor" "vendor.name" "resources+count" "resources" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "package_id": "string",
- "vendor_id": 0,
- "name": "string",
- "provider": "string",
- "external_id": "string",
- "koha_internal_id": 0,
- "package_type": "string",
- "content_type": "string",
- "notes": "string",
- "created_on": "string",
- "package_agreements": [
- {
- "package_id": 0,
- "agreement_id": 0
}
], - "resources": [
- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "vendor": { },
- "is_selected": true,
- "resources_count": 0
}
]
provider required | string Provider name |
A JSON object containing information about the new package
vendor_id | integer or null foreign key to aqbooksellers | ||||||||||||||||||||
name required | string name of the package | ||||||||||||||||||||
provider | string or null external id of the package | ||||||||||||||||||||
external_id | string or null external id of the package | ||||||||||||||||||||
koha_internal_id | integer or null internal id of the package | ||||||||||||||||||||
package_type | string or null type of the package | ||||||||||||||||||||
content_type | string or null content type of the package | ||||||||||||||||||||
notes | string or null notes about the package | ||||||||||||||||||||
created_on | string or null date of creation | ||||||||||||||||||||
Array of objects (erm_eholdings_package_agreement) agreements | |||||||||||||||||||||
Array
| |||||||||||||||||||||
Array of objects (erm_eholdings_resource) resources | |||||||||||||||||||||
Array
| |||||||||||||||||||||
vendor | object or null | ||||||||||||||||||||
is_selected | boolean or null | ||||||||||||||||||||
resources_count | integer or null |
{- "vendor_id": 0,
- "name": "string",
- "provider": "string",
- "external_id": "string",
- "koha_internal_id": 0,
- "package_type": "string",
- "content_type": "string",
- "notes": "string",
- "created_on": "string",
- "package_agreements": [
- {
- "agreement_id": 0
}
], - "resources": [
- {
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "vendor": { },
- "is_selected": true,
- "resources_count": 0
}
[- {
- "package_id": "string",
- "vendor_id": 0,
- "name": "string",
- "provider": "string",
- "external_id": "string",
- "koha_internal_id": 0,
- "package_type": "string",
- "content_type": "string",
- "notes": "string",
- "created_on": "string",
- "package_agreements": [
- {
- "package_id": 0,
- "agreement_id": 0
}
], - "resources": [
- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "vendor": { },
- "is_selected": true,
- "resources_count": 0
}
]
provider required | string Provider name |
package_id required | string Package internal identifier |
x-koha-embed | Array of strings Items Enum: "package_agreements" "package_agreements.agreement" "resources+count" "vendor" Embed list sent as a request header |
[- {
- "package_id": "string",
- "vendor_id": 0,
- "name": "string",
- "provider": "string",
- "external_id": "string",
- "koha_internal_id": 0,
- "package_type": "string",
- "content_type": "string",
- "notes": "string",
- "created_on": "string",
- "package_agreements": [
- {
- "package_id": 0,
- "agreement_id": 0
}
], - "resources": [
- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "vendor": { },
- "is_selected": true,
- "resources_count": 0
}
]
provider required | string Provider name |
package_id required | string Package internal identifier |
x-koha-embed | Array of strings Items Enum: "agreements" "resources" Embed list sent as a request header |
A JSON object containing new information about existing package
vendor_id | integer or null foreign key to aqbooksellers | ||||||||||||||||||||
name required | string name of the package | ||||||||||||||||||||
provider | string or null external id of the package | ||||||||||||||||||||
external_id | string or null external id of the package | ||||||||||||||||||||
koha_internal_id | integer or null internal id of the package | ||||||||||||||||||||
package_type | string or null type of the package | ||||||||||||||||||||
content_type | string or null content type of the package | ||||||||||||||||||||
notes | string or null notes about the package | ||||||||||||||||||||
created_on | string or null date of creation | ||||||||||||||||||||
Array of objects (erm_eholdings_package_agreement) agreements | |||||||||||||||||||||
Array
| |||||||||||||||||||||
Array of objects (erm_eholdings_resource) resources | |||||||||||||||||||||
Array
| |||||||||||||||||||||
vendor | object or null | ||||||||||||||||||||
is_selected | boolean or null | ||||||||||||||||||||
resources_count | integer or null |
{- "vendor_id": 0,
- "name": "string",
- "provider": "string",
- "external_id": "string",
- "koha_internal_id": 0,
- "package_type": "string",
- "content_type": "string",
- "notes": "string",
- "created_on": "string",
- "package_agreements": [
- {
- "agreement_id": 0
}
], - "resources": [
- {
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "vendor": { },
- "is_selected": true,
- "resources_count": 0
}
[- {
- "package_id": "string",
- "vendor_id": 0,
- "name": "string",
- "provider": "string",
- "external_id": "string",
- "koha_internal_id": 0,
- "package_type": "string",
- "content_type": "string",
- "notes": "string",
- "created_on": "string",
- "package_agreements": [
- {
- "package_id": 0,
- "agreement_id": 0
}
], - "resources": [
- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "vendor": { },
- "is_selected": true,
- "resources_count": 0
}
]
provider required | string Provider name |
package_id required | string Package internal identifier |
A JSON object containing the fields to edit
is_selected | boolean Add or remove this package from remote holdings |
{- "is_selected": true
}
{- "is_selected": true
}
provider required | string Provider name |
package_id required | string Package internal identifier |
resource_id | string Case insensitive search on resource_id |
started_on | string Case insensitive search on started_on |
ended_on | string Case insensitive search on ended_on |
proxy | string Case insensitive search on proxy |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "title" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
]
provider required | string Provider name |
resource_id | string Case insensitive search on resource_id |
package_id | string Case insensitive search on package_id |
vendor_id | integer Case insensitive search on title vendor_id |
started_on | string Case insensitive search on started_on |
ended_on | string Case insensitive search on ended_on |
proxy | string Case insensitive search on proxy |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
Query filter sent through request"s body
{ }
[- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
]
provider required | string Provider name |
resource_id required | string Resource internal identifier |
x-koha-embed | Array of strings Items Enum: "title" "package" "vendor" Embed list sent as a request header |
[- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
]
provider required | string Provider name |
resource_id required | string Resource internal identifier |
A JSON object containing the fields to edit
is_selected | boolean Add or remove this resource from remote holdings |
{- "is_selected": true
}
{- "is_selected": true
}
provider required | string Provider name |
title_id | integer Case insensitive search on title title_id |
publication_title | string Case insensitive search on title publication_title |
external_id | string Case insensitive search on title external_id |
print_identifier | string Case insensitive search on title print_identifier |
online_identifier | string Case insensitive search on title online_identifier |
date_first_issue_online | string Case insensitive search on title date_first_issue_online |
num_first_vol_online | string Case insensitive search on title num_first_vol_online |
num_first_issue_online | string Case insensitive search on title num_first_issue_online |
date_last_issue_online | string Case insensitive search on title date_last_issue_online |
num_last_vol_online | string Case insensitive search on title num_last_vol_online |
num_last_issue_online | string Case insensitive search on title num_last_issue_online |
title_url | string Case insensitive search on title title_url |
first_author | string Case insensitive search on title first_author |
embargo_info | string Case insensitive search on title embargo_info |
coverage_depth | string Case insensitive search on title coverage_depth |
notes | string Case insensitive search on title notes |
publisher_name | string Case insensitive search on title publisher_name |
publication_type | string Case insensitive search on title publication_type |
date_monograph_published_print | string Case insensitive search on title date_monograph_published_print |
date_monograph_published_online | string Case insensitive search on title date_monograph_published_online |
monograph_volume | string Case insensitive search on title monograph_volume |
monograph_edition | string Case insensitive search on title monograph_edition |
first_editor | string Case insensitive search on title first_editor |
parent_publication_title_id | string Case insensitive search on title parent_publication_title_id |
preceding_publication_title_id | string Case insensitive search on title preceding_publication_title_id |
access_type | string Case insensitive search on title access_type |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "resources.package" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "title_id": 0,
- "biblio_id": 0,
- "publication_title": "string",
- "external_id": "string",
- "print_identifier": "string",
- "online_identifier": "string",
- "date_first_issue_online": "string",
- "num_first_vol_online": "string",
- "num_first_issue_online": "string",
- "date_last_issue_online": "string",
- "num_last_vol_online": "string",
- "num_last_issue_online": "string",
- "title_url": "string",
- "first_author": "string",
- "embargo_info": "string",
- "coverage_depth": "string",
- "notes": "string",
- "publisher_name": "string",
- "publication_type": "string",
- "date_monograph_published_print": "string",
- "date_monograph_published_online": "string",
- "monograph_volume": "string",
- "monograph_edition": "string",
- "first_editor": "string",
- "parent_publication_title_id": "string",
- "preceding_publication_title_id": "string",
- "access_type": "string",
- "is_selected": true,
- "resources": [
- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "create_linked_biblio": true
}
]
provider required | string Provider name |
A JSON object containing information about the new title
publication_title required | string publication_title of the title | ||||||||||||||||||||
external_id | string or null External id of the title | ||||||||||||||||||||
print_identifier | string or null print_identifier of the title | ||||||||||||||||||||
online_identifier | string or null online_identifier of the title | ||||||||||||||||||||
date_first_issue_online | string or null date_first_issue_online of the title | ||||||||||||||||||||
num_first_vol_online | string or null num_first_vol_online of the title | ||||||||||||||||||||
num_first_issue_online | string or null num_first_issue_online of the title | ||||||||||||||||||||
date_last_issue_online | string or null date_last_issue_online of the title | ||||||||||||||||||||
num_last_vol_online | string or null num_last_vol_online of the title | ||||||||||||||||||||
num_last_issue_online | string or null num_last_issue_online of the title | ||||||||||||||||||||
title_url | string or null title_url of the title | ||||||||||||||||||||
first_author | string or null first_author of the title | ||||||||||||||||||||
embargo_info | string or null embargo_info of the title | ||||||||||||||||||||
coverage_depth | string or null coverage_depth of the title | ||||||||||||||||||||
notes | string or null notes of the title | ||||||||||||||||||||
publisher_name | string or null publisher_name of the title | ||||||||||||||||||||
publication_type | string or null publication_type of the title | ||||||||||||||||||||
date_monograph_published_print | string or null date_monograph_published_print of the title | ||||||||||||||||||||
date_monograph_published_online | string or null date_monograph_published_online of the title | ||||||||||||||||||||
monograph_volume | string or null monograph_volume of the title | ||||||||||||||||||||
monograph_edition | string or null monograph_edition of the title | ||||||||||||||||||||
first_editor | string or null first_editor of the title | ||||||||||||||||||||
parent_publication_title_id | string or null parent_publication_title_id of the title | ||||||||||||||||||||
preceding_publication_title_id | string or null preceding_publication_title_id of the title | ||||||||||||||||||||
access_type | string or null access_type of the title | ||||||||||||||||||||
is_selected | boolean or null if the title is selected in the KB | ||||||||||||||||||||
Array of objects (erm_eholdings_resource) Resource containing this title | |||||||||||||||||||||
Array
| |||||||||||||||||||||
create_linked_biblio | boolean or null should a linked biblio be created |
{- "publication_title": "string",
- "external_id": "string",
- "print_identifier": "string",
- "online_identifier": "string",
- "date_first_issue_online": "string",
- "num_first_vol_online": "string",
- "num_first_issue_online": "string",
- "date_last_issue_online": "string",
- "num_last_vol_online": "string",
- "num_last_issue_online": "string",
- "title_url": "string",
- "first_author": "string",
- "embargo_info": "string",
- "coverage_depth": "string",
- "notes": "string",
- "publisher_name": "string",
- "publication_type": "string",
- "date_monograph_published_print": "string",
- "date_monograph_published_online": "string",
- "monograph_volume": "string",
- "monograph_edition": "string",
- "first_editor": "string",
- "parent_publication_title_id": "string",
- "preceding_publication_title_id": "string",
- "access_type": "string",
- "is_selected": true,
- "resources": [
- {
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "create_linked_biblio": true
}
[- {
- "title_id": 0,
- "biblio_id": 0,
- "publication_title": "string",
- "external_id": "string",
- "print_identifier": "string",
- "online_identifier": "string",
- "date_first_issue_online": "string",
- "num_first_vol_online": "string",
- "num_first_issue_online": "string",
- "date_last_issue_online": "string",
- "num_last_vol_online": "string",
- "num_last_issue_online": "string",
- "title_url": "string",
- "first_author": "string",
- "embargo_info": "string",
- "coverage_depth": "string",
- "notes": "string",
- "publisher_name": "string",
- "publication_type": "string",
- "date_monograph_published_print": "string",
- "date_monograph_published_online": "string",
- "monograph_volume": "string",
- "monograph_edition": "string",
- "first_editor": "string",
- "parent_publication_title_id": "string",
- "preceding_publication_title_id": "string",
- "access_type": "string",
- "is_selected": true,
- "resources": [
- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "create_linked_biblio": true
}
]
The list_id of the list to import
list_id | string |
package_id | string |
{- "list_id": "string",
- "package_id": "string"
}
{- "job_id": "string"
}
The file to import
file | object |
package_id | string |
create_linked_biblio | boolean |
{- "file": { },
- "package_id": "string",
- "create_linked_biblio": true
}
{- "job_ids": [
- null
], - "invalid_columns": [
- null
], - "valid_columns": [
- null
], - "invalid_filetype": 0,
- "warnings": { }
}
provider required | string Provider name |
title_id required | integer Title internal identifier |
x-koha-embed | Array of strings Items Enum: "resources" "resources.package" Embed list sent as a request header |
[- {
- "title_id": 0,
- "biblio_id": 0,
- "publication_title": "string",
- "external_id": "string",
- "print_identifier": "string",
- "online_identifier": "string",
- "date_first_issue_online": "string",
- "num_first_vol_online": "string",
- "num_first_issue_online": "string",
- "date_last_issue_online": "string",
- "num_last_vol_online": "string",
- "num_last_issue_online": "string",
- "title_url": "string",
- "first_author": "string",
- "embargo_info": "string",
- "coverage_depth": "string",
- "notes": "string",
- "publisher_name": "string",
- "publication_type": "string",
- "date_monograph_published_print": "string",
- "date_monograph_published_online": "string",
- "monograph_volume": "string",
- "monograph_edition": "string",
- "first_editor": "string",
- "parent_publication_title_id": "string",
- "preceding_publication_title_id": "string",
- "access_type": "string",
- "is_selected": true,
- "resources": [
- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "create_linked_biblio": true
}
]
provider required | string Provider name |
title_id required | integer Title internal identifier |
x-koha-embed | Array of strings Items Enum: "resources" "resources.package" Embed list sent as a request header |
A JSON object containing new information about existing title
publication_title required | string publication_title of the title | ||||||||||||||||||||
external_id | string or null External id of the title | ||||||||||||||||||||
print_identifier | string or null print_identifier of the title | ||||||||||||||||||||
online_identifier | string or null online_identifier of the title | ||||||||||||||||||||
date_first_issue_online | string or null date_first_issue_online of the title | ||||||||||||||||||||
num_first_vol_online | string or null num_first_vol_online of the title | ||||||||||||||||||||
num_first_issue_online | string or null num_first_issue_online of the title | ||||||||||||||||||||
date_last_issue_online | string or null date_last_issue_online of the title | ||||||||||||||||||||
num_last_vol_online | string or null num_last_vol_online of the title | ||||||||||||||||||||
num_last_issue_online | string or null num_last_issue_online of the title | ||||||||||||||||||||
title_url | string or null title_url of the title | ||||||||||||||||||||
first_author | string or null first_author of the title | ||||||||||||||||||||
embargo_info | string or null embargo_info of the title | ||||||||||||||||||||
coverage_depth | string or null coverage_depth of the title | ||||||||||||||||||||
notes | string or null notes of the title | ||||||||||||||||||||
publisher_name | string or null publisher_name of the title | ||||||||||||||||||||
publication_type | string or null publication_type of the title | ||||||||||||||||||||
date_monograph_published_print | string or null date_monograph_published_print of the title | ||||||||||||||||||||
date_monograph_published_online | string or null date_monograph_published_online of the title | ||||||||||||||||||||
monograph_volume | string or null monograph_volume of the title | ||||||||||||||||||||
monograph_edition | string or null monograph_edition of the title | ||||||||||||||||||||
first_editor | string or null first_editor of the title | ||||||||||||||||||||
parent_publication_title_id | string or null parent_publication_title_id of the title | ||||||||||||||||||||
preceding_publication_title_id | string or null preceding_publication_title_id of the title | ||||||||||||||||||||
access_type | string or null access_type of the title | ||||||||||||||||||||
is_selected | boolean or null if the title is selected in the KB | ||||||||||||||||||||
Array of objects (erm_eholdings_resource) Resource containing this title | |||||||||||||||||||||
Array
| |||||||||||||||||||||
create_linked_biblio | boolean or null should a linked biblio be created |
{- "publication_title": "string",
- "external_id": "string",
- "print_identifier": "string",
- "online_identifier": "string",
- "date_first_issue_online": "string",
- "num_first_vol_online": "string",
- "num_first_issue_online": "string",
- "date_last_issue_online": "string",
- "num_last_vol_online": "string",
- "num_last_issue_online": "string",
- "title_url": "string",
- "first_author": "string",
- "embargo_info": "string",
- "coverage_depth": "string",
- "notes": "string",
- "publisher_name": "string",
- "publication_type": "string",
- "date_monograph_published_print": "string",
- "date_monograph_published_online": "string",
- "monograph_volume": "string",
- "monograph_edition": "string",
- "first_editor": "string",
- "parent_publication_title_id": "string",
- "preceding_publication_title_id": "string",
- "access_type": "string",
- "is_selected": true,
- "resources": [
- {
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "create_linked_biblio": true
}
[- {
- "title_id": 0,
- "biblio_id": 0,
- "publication_title": "string",
- "external_id": "string",
- "print_identifier": "string",
- "online_identifier": "string",
- "date_first_issue_online": "string",
- "num_first_vol_online": "string",
- "num_first_issue_online": "string",
- "date_last_issue_online": "string",
- "num_last_vol_online": "string",
- "num_last_issue_online": "string",
- "title_url": "string",
- "first_author": "string",
- "embargo_info": "string",
- "coverage_depth": "string",
- "notes": "string",
- "publisher_name": "string",
- "publication_type": "string",
- "date_monograph_published_print": "string",
- "date_monograph_published_online": "string",
- "monograph_volume": "string",
- "monograph_edition": "string",
- "first_editor": "string",
- "parent_publication_title_id": "string",
- "preceding_publication_title_id": "string",
- "access_type": "string",
- "is_selected": true,
- "resources": [
- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
], - "create_linked_biblio": true
}
]
provider required | string Provider name |
title_id required | integer Title internal identifier |
resource_id | string Case insensitive search on resource_id |
started_on | string Case insensitive search on started_on |
ended_on | string Case insensitive search on ended_on |
proxy | string Case insensitive search on proxy |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "title.publication_title" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "resource_id": "string",
- "title_id": 0,
- "package_id": "string",
- "vendor_id": 0,
- "started_on": "string",
- "ended_on": "string",
- "proxy": "string",
- "is_selected": true,
- "title": { },
- "package": { },
- "vendor": { }
}
]
license_id | integer Case insensitive search on license license_id |
vendor_id | integer Case insensitive search on agreement vendor_id |
name | string Case insensitive search on license name |
type | string Case insensitive search on license type |
status | string Case insensitive search on license status |
started_on | string Case insensitive search on license start date |
ended_on | string Case insensitive search on license end date |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "vendor" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "license_id": 0,
- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "type": "string",
- "status": "string",
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_type": "string",
- "file_description": "string",
- "file_content": "string",
- "uploaded_on": "2019-08-24T14:15:22Z",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
]
A JSON object containing information about the new agreement's license
vendor_id | integer or null foreign key to aqbooksellers | ||||||||||||||||||
name required | string name of the license | ||||||||||||||||||
description | string or null description of the license | ||||||||||||||||||
type required | string description of the license | ||||||||||||||||||
status required | string status of the license | ||||||||||||||||||
started_on | string or null <date> Start of the license | ||||||||||||||||||
ended_on | string or null <date> End of the license | ||||||||||||||||||
Array of objects (erm_user_role) role for users | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects (erm_document) documents | |||||||||||||||||||
Array
| |||||||||||||||||||
vendor | object or null Information about the vendor |
{- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "type": "string",
- "status": "string",
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_description": "string",
- "file_content": "string",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
[- {
- "license_id": 0,
- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "type": "string",
- "status": "string",
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_type": "string",
- "file_description": "string",
- "file_content": "string",
- "uploaded_on": "2019-08-24T14:15:22Z",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
]
license_id required | integer License internal identifier |
x-koha-embed | Array of strings Items Enum: "user_roles" "user_roles.patron" "vendor" "documents" Embed list sent as a request header |
[- {
- "license_id": 0,
- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "type": "string",
- "status": "string",
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_type": "string",
- "file_description": "string",
- "file_content": "string",
- "uploaded_on": "2019-08-24T14:15:22Z",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
]
license_id required | integer License internal identifier |
x-koha-embed | Array of strings Items Enum: "user_roles" "documents" Embed list sent as a request header |
a json object containing new information about existing license
vendor_id | integer or null foreign key to aqbooksellers | ||||||||||||||||||
name required | string name of the license | ||||||||||||||||||
description | string or null description of the license | ||||||||||||||||||
type required | string description of the license | ||||||||||||||||||
status required | string status of the license | ||||||||||||||||||
started_on | string or null <date> Start of the license | ||||||||||||||||||
ended_on | string or null <date> End of the license | ||||||||||||||||||
Array of objects (erm_user_role) role for users | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects (erm_document) documents | |||||||||||||||||||
Array
| |||||||||||||||||||
vendor | object or null Information about the vendor |
{- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "type": "string",
- "status": "string",
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_description": "string",
- "file_content": "string",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
[- {
- "license_id": 0,
- "vendor_id": 0,
- "name": "string",
- "description": "string",
- "type": "string",
- "status": "string",
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "user_roles": [
- {
- "user_role_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "user_id": 0,
- "role": "string",
- "patron": { }
}
], - "documents": [
- {
- "document_id": 0,
- "agreement_id": 0,
- "license_id": 0,
- "file_name": "string",
- "file_type": "string",
- "file_description": "string",
- "file_content": "string",
- "uploaded_on": "2019-08-24T14:15:22Z",
- "physical_location": "string",
- "uri": "string",
- "notes": "string"
}
], - "vendor": { }
}
]
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
Query filter sent through request"s body
{ }
[- {
- "id": "string",
- "data_host": "string",
- "counter_release": "string",
- "contact": [
- { }
], - "url": "string",
- "customer_id_info": "string",
- "requestor_id_required": true,
- "requestor_id_info": "string",
- "api_key_required": true,
- "api_key_info": "string",
- "platform_specific_info": "string",
- "platform_attr_required": true,
- "credentials_auto_expire": true,
- "credentials_auto_expire_info": "string",
- "request_volume_limits_applied": true,
- "request_volume_limits_info": "string",
- "ip_address_authorization": true,
- "ip_address_authorization_info": "string",
- "customizations_in_place": true,
- "customizations_info": "string",
- "notification_count": 0,
- "notifications_url": "string",
- "migrations": [
- { }
]
}
]
usage_data_provider_id | integer Case insensitive search on usage_data_provider usage_data_provider_id |
name | string Case insensitive search on usage_data_provider name |
description | string Case insensitive search on usage_data_provider description |
active | integer Case insensitive search on usage_data_provider active |
method | string Case insensitive search on usage_data_provider method |
aggregator | string Case insensitive search on usage_data_provider aggregator |
service_type | string Case insensitive search on usage_data_provider service_type |
service_url | string Case insensitive search on usage_data_provider service_url |
report_release | string Case insensitive search on usage_data_provider report_release |
customer_id | string Case insensitive search on usage_data_provider customer_id |
requestor_id | string Case insensitive search on usage_data_provider requestor_id |
api_key | string Case insensitive search on usage_data_provider api_key |
requestor_name | string Case insensitive search on usage_data_provider requestor_name |
requestor_email | string Case insensitive search on usage_data_provider requestor_email |
report_types | string Case insensitive search on usage_data_provider report_types |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "counter_files" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "erm_usage_data_provider_id": 0,
- "name": "string",
- "description": "string",
- "active": 0,
- "method": "string",
- "aggregator": "string",
- "service_type": "string",
- "service_url": "string",
- "report_release": "string",
- "customer_id": "string",
- "requestor_id": "string",
- "api_key": "string",
- "requestor_name": "string",
- "requestor_email": "string",
- "report_types": "string",
- "metric_type": "string",
- "counter_files": [
- {
- "erm_counter_files_id": 0,
- "usage_data_provider_id": 0,
- "type": "string",
- "filename": "string",
- "file_content": "string",
- "date_uploaded": "2019-08-24T14:15:22Z",
- "counter_logs": [
- {
- "erm_counter_log_id": 0,
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
}
], - "erm_usage_titles": [
- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "proprietary_id": "string",
- "platform": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "isbn": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_items": [
- {
- "item_id": 0,
- "item": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_platforms": [
- {
- "platform_id": 0,
- "platform": "string",
- "usage_data_provider_id": 0,
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_databases": [
- {
- "database_id": 0,
- "database": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "earliest_title": "string",
- "latest_title": "string",
- "earliest_platform": "string",
- "latest_platform": "string",
- "earliest_item": "string",
- "latest_item": "string",
- "earliest_database": "string",
- "latest_database": "string",
- "last_run": "string"
}
]
A JSON object containing information about the new usage_data_provider
name required | string name of the data provider | ||||||||||||||||||||||||||||||
description | string or null description of the data provider | ||||||||||||||||||||||||||||||
active | integer or null status of the harvester | ||||||||||||||||||||||||||||||
method | string or null method of the harvester | ||||||||||||||||||||||||||||||
aggregator | string or null aggregator of the harvester | ||||||||||||||||||||||||||||||
service_type | string or null service_type of the harvester | ||||||||||||||||||||||||||||||
service_url required | string or null service_url of the harvester | ||||||||||||||||||||||||||||||
report_release required | string or null report_release of the harvester | ||||||||||||||||||||||||||||||
customer_id required | string or null customer_id of the harvester | ||||||||||||||||||||||||||||||
requestor_id required | string or null requestor_id of the harvester | ||||||||||||||||||||||||||||||
api_key | string or null api_key of the harvester | ||||||||||||||||||||||||||||||
requestor_name | string or null requestor_name of the harvester | ||||||||||||||||||||||||||||||
requestor_email | string or null requestor_email of the harvester | ||||||||||||||||||||||||||||||
report_types | string or null report types of the harvester | ||||||||||||||||||||||||||||||
metric_type | string or null metric type of the harvester when reporting | ||||||||||||||||||||||||||||||
Array of objects (erm_counter_file) counter files | |||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||
Array of objects (erm_usage_title) usage titles | |||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||
Array of objects (erm_usage_item) usage items | |||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||
Array of objects (erm_usage_platform) usage platforms | |||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||
Array of objects (erm_usage_database) usage databases | |||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||
earliest_title | string or null time period of data harvested | ||||||||||||||||||||||||||||||
latest_title | string or null time period of data harvested | ||||||||||||||||||||||||||||||
earliest_platform | string or null time period of data harvested | ||||||||||||||||||||||||||||||
latest_platform | string or null time period of data harvested | ||||||||||||||||||||||||||||||
earliest_item | string or null time period of data harvested | ||||||||||||||||||||||||||||||
latest_item | string or null time period of data harvested | ||||||||||||||||||||||||||||||
earliest_database | string or null time period of data harvested | ||||||||||||||||||||||||||||||
latest_database | string or null time period of data harvested | ||||||||||||||||||||||||||||||
last_run | string or null last time the harvester was run |
{- "name": "string",
- "description": "string",
- "active": 0,
- "method": "string",
- "aggregator": "string",
- "service_type": "string",
- "service_url": "string",
- "report_release": "string",
- "customer_id": "string",
- "requestor_id": "string",
- "api_key": "string",
- "requestor_name": "string",
- "requestor_email": "string",
- "report_types": "string",
- "metric_type": "string",
- "counter_files": [
- {
- "usage_data_provider_id": 0,
- "type": "string",
- "filename": "string",
- "file_content": "string",
- "date_uploaded": "2019-08-24T14:15:22Z",
- "counter_logs": [
- {
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
}
], - "erm_usage_titles": [
- {
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "proprietary_id": "string",
- "platform": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "isbn": "string",
- "erm_usage_muses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_items": [
- {
- "item": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "erm_usage_muses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_platforms": [
- {
- "platform": "string",
- "usage_data_provider_id": 0,
- "erm_usage_muses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_databases": [
- {
- "database": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "earliest_title": "string",
- "latest_title": "string",
- "earliest_platform": "string",
- "latest_platform": "string",
- "earliest_item": "string",
- "latest_item": "string",
- "earliest_database": "string",
- "latest_database": "string",
- "last_run": "string"
}
[- {
- "erm_usage_data_provider_id": 0,
- "name": "string",
- "description": "string",
- "active": 0,
- "method": "string",
- "aggregator": "string",
- "service_type": "string",
- "service_url": "string",
- "report_release": "string",
- "customer_id": "string",
- "requestor_id": "string",
- "api_key": "string",
- "requestor_name": "string",
- "requestor_email": "string",
- "report_types": "string",
- "metric_type": "string",
- "counter_files": [
- {
- "erm_counter_files_id": 0,
- "usage_data_provider_id": 0,
- "type": "string",
- "filename": "string",
- "file_content": "string",
- "date_uploaded": "2019-08-24T14:15:22Z",
- "counter_logs": [
- {
- "erm_counter_log_id": 0,
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
}
], - "erm_usage_titles": [
- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "proprietary_id": "string",
- "platform": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "isbn": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_items": [
- {
- "item_id": 0,
- "item": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_platforms": [
- {
- "platform_id": 0,
- "platform": "string",
- "usage_data_provider_id": 0,
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_databases": [
- {
- "database_id": 0,
- "database": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "earliest_title": "string",
- "latest_title": "string",
- "earliest_platform": "string",
- "latest_platform": "string",
- "earliest_item": "string",
- "latest_item": "string",
- "earliest_database": "string",
- "latest_database": "string",
- "last_run": "string"
}
]
erm_usage_data_provider_id required | integer ERM usage_data_provider internal identifier |
x-koha-embed | Array of strings Items Enum: "counter_files" "erm_usage_titles.erm_usage_muses" Embed list sent as a request header |
[- {
- "erm_usage_data_provider_id": 0,
- "name": "string",
- "description": "string",
- "active": 0,
- "method": "string",
- "aggregator": "string",
- "service_type": "string",
- "service_url": "string",
- "report_release": "string",
- "customer_id": "string",
- "requestor_id": "string",
- "api_key": "string",
- "requestor_name": "string",
- "requestor_email": "string",
- "report_types": "string",
- "metric_type": "string",
- "counter_files": [
- {
- "erm_counter_files_id": 0,
- "usage_data_provider_id": 0,
- "type": "string",
- "filename": "string",
- "file_content": "string",
- "date_uploaded": "2019-08-24T14:15:22Z",
- "counter_logs": [
- {
- "erm_counter_log_id": 0,
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
}
], - "erm_usage_titles": [
- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "proprietary_id": "string",
- "platform": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "isbn": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_items": [
- {
- "item_id": 0,
- "item": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_platforms": [
- {
- "platform_id": 0,
- "platform": "string",
- "usage_data_provider_id": 0,
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_databases": [
- {
- "database_id": 0,
- "database": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "earliest_title": "string",
- "latest_title": "string",
- "earliest_platform": "string",
- "latest_platform": "string",
- "earliest_item": "string",
- "latest_item": "string",
- "earliest_database": "string",
- "latest_database": "string",
- "last_run": "string"
}
]
erm_usage_data_provider_id required | integer ERM usage_data_provider internal identifier |
x-koha-embed | Array of strings Embed list sent as a request header |
a json object containing new information about existing usage_data_provider
name required | string name of the data provider | ||||||||||||||||||||||||||||||
description | string or null description of the data provider | ||||||||||||||||||||||||||||||
active | integer or null status of the harvester | ||||||||||||||||||||||||||||||
method | string or null method of the harvester | ||||||||||||||||||||||||||||||
aggregator | string or null aggregator of the harvester | ||||||||||||||||||||||||||||||
service_type | string or null service_type of the harvester | ||||||||||||||||||||||||||||||
service_url required | string or null service_url of the harvester | ||||||||||||||||||||||||||||||
report_release required | string or null report_release of the harvester | ||||||||||||||||||||||||||||||
customer_id required | string or null customer_id of the harvester | ||||||||||||||||||||||||||||||
requestor_id required | string or null requestor_id of the harvester | ||||||||||||||||||||||||||||||
api_key | string or null api_key of the harvester | ||||||||||||||||||||||||||||||
requestor_name | string or null requestor_name of the harvester | ||||||||||||||||||||||||||||||
requestor_email | string or null requestor_email of the harvester | ||||||||||||||||||||||||||||||
report_types | string or null report types of the harvester | ||||||||||||||||||||||||||||||
metric_type | string or null metric type of the harvester when reporting | ||||||||||||||||||||||||||||||
Array of objects (erm_counter_file) counter files | |||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||
Array of objects (erm_usage_title) usage titles | |||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||
Array of objects (erm_usage_item) usage items | |||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||
Array of objects (erm_usage_platform) usage platforms | |||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||
Array of objects (erm_usage_database) usage databases | |||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||
earliest_title | string or null time period of data harvested | ||||||||||||||||||||||||||||||
latest_title | string or null time period of data harvested | ||||||||||||||||||||||||||||||
earliest_platform | string or null time period of data harvested | ||||||||||||||||||||||||||||||
latest_platform | string or null time period of data harvested | ||||||||||||||||||||||||||||||
earliest_item | string or null time period of data harvested | ||||||||||||||||||||||||||||||
latest_item | string or null time period of data harvested | ||||||||||||||||||||||||||||||
earliest_database | string or null time period of data harvested | ||||||||||||||||||||||||||||||
latest_database | string or null time period of data harvested | ||||||||||||||||||||||||||||||
last_run | string or null last time the harvester was run |
{- "name": "string",
- "description": "string",
- "active": 0,
- "method": "string",
- "aggregator": "string",
- "service_type": "string",
- "service_url": "string",
- "report_release": "string",
- "customer_id": "string",
- "requestor_id": "string",
- "api_key": "string",
- "requestor_name": "string",
- "requestor_email": "string",
- "report_types": "string",
- "metric_type": "string",
- "counter_files": [
- {
- "usage_data_provider_id": 0,
- "type": "string",
- "filename": "string",
- "file_content": "string",
- "date_uploaded": "2019-08-24T14:15:22Z",
- "counter_logs": [
- {
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
}
], - "erm_usage_titles": [
- {
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "proprietary_id": "string",
- "platform": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "isbn": "string",
- "erm_usage_muses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_items": [
- {
- "item": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "erm_usage_muses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_platforms": [
- {
- "platform": "string",
- "usage_data_provider_id": 0,
- "erm_usage_muses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_databases": [
- {
- "database": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "earliest_title": "string",
- "latest_title": "string",
- "earliest_platform": "string",
- "latest_platform": "string",
- "earliest_item": "string",
- "latest_item": "string",
- "earliest_database": "string",
- "latest_database": "string",
- "last_run": "string"
}
[- {
- "erm_usage_data_provider_id": 0,
- "name": "string",
- "description": "string",
- "active": 0,
- "method": "string",
- "aggregator": "string",
- "service_type": "string",
- "service_url": "string",
- "report_release": "string",
- "customer_id": "string",
- "requestor_id": "string",
- "api_key": "string",
- "requestor_name": "string",
- "requestor_email": "string",
- "report_types": "string",
- "metric_type": "string",
- "counter_files": [
- {
- "erm_counter_files_id": 0,
- "usage_data_provider_id": 0,
- "type": "string",
- "filename": "string",
- "file_content": "string",
- "date_uploaded": "2019-08-24T14:15:22Z",
- "counter_logs": [
- {
- "erm_counter_log_id": 0,
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
}
], - "erm_usage_titles": [
- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "proprietary_id": "string",
- "platform": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "isbn": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_items": [
- {
- "item_id": 0,
- "item": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_platforms": [
- {
- "platform_id": 0,
- "platform": "string",
- "usage_data_provider_id": 0,
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_databases": [
- {
- "database_id": 0,
- "database": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "earliest_title": "string",
- "latest_title": "string",
- "earliest_platform": "string",
- "latest_platform": "string",
- "earliest_item": "string",
- "latest_item": "string",
- "earliest_database": "string",
- "latest_database": "string",
- "last_run": "string"
}
]
erm_usage_data_provider_id required | integer ERM usage_data_provider internal identifier |
A JSON object with the begin and end dates
begin_date | string <date> begin date of the harvest |
end_date | string <date> end date of the harvest |
{- "begin_date": "2019-08-24",
- "end_date": "2019-08-24"
}
[- {
- "erm_usage_data_provider_id": 0,
- "name": "string",
- "description": "string",
- "active": 0,
- "method": "string",
- "aggregator": "string",
- "service_type": "string",
- "service_url": "string",
- "report_release": "string",
- "customer_id": "string",
- "requestor_id": "string",
- "api_key": "string",
- "requestor_name": "string",
- "requestor_email": "string",
- "report_types": "string",
- "metric_type": "string",
- "counter_files": [
- {
- "erm_counter_files_id": 0,
- "usage_data_provider_id": 0,
- "type": "string",
- "filename": "string",
- "file_content": "string",
- "date_uploaded": "2019-08-24T14:15:22Z",
- "counter_logs": [
- {
- "erm_counter_log_id": 0,
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
}
], - "erm_usage_titles": [
- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "proprietary_id": "string",
- "platform": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "isbn": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_items": [
- {
- "item_id": 0,
- "item": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_platforms": [
- {
- "platform_id": 0,
- "platform": "string",
- "usage_data_provider_id": 0,
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_databases": [
- {
- "database_id": 0,
- "database": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "earliest_title": "string",
- "latest_title": "string",
- "earliest_platform": "string",
- "latest_platform": "string",
- "earliest_item": "string",
- "latest_item": "string",
- "earliest_database": "string",
- "latest_database": "string",
- "last_run": "string"
}
]
erm_usage_data_provider_id required | integer ERM usage_data_provider internal identifier |
A JSON object containing information about the new counter_file
usage_data_provider_id required | integer usage_data_provider_id of the counter_files | ||||||||||||
type | string or null type of the counter_files | ||||||||||||
filename required | string filename | ||||||||||||
file_content required | string file_content | ||||||||||||
date_uploaded | string <date-time> Timestamp for the date of upload | ||||||||||||
Array of objects (erm_counter_log) counter logs | |||||||||||||
Array
|
{- "usage_data_provider_id": 0,
- "type": "string",
- "filename": "string",
- "file_content": "string",
- "date_uploaded": "2019-08-24T14:15:22Z",
- "counter_logs": [
- {
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
}
[- {
- "erm_usage_data_provider_id": 0,
- "name": "string",
- "description": "string",
- "active": 0,
- "method": "string",
- "aggregator": "string",
- "service_type": "string",
- "service_url": "string",
- "report_release": "string",
- "customer_id": "string",
- "requestor_id": "string",
- "api_key": "string",
- "requestor_name": "string",
- "requestor_email": "string",
- "report_types": "string",
- "metric_type": "string",
- "counter_files": [
- {
- "erm_counter_files_id": 0,
- "usage_data_provider_id": 0,
- "type": "string",
- "filename": "string",
- "file_content": "string",
- "date_uploaded": "2019-08-24T14:15:22Z",
- "counter_logs": [
- {
- "erm_counter_log_id": 0,
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
}
], - "erm_usage_titles": [
- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "proprietary_id": "string",
- "platform": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "isbn": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_items": [
- {
- "item_id": 0,
- "item": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_platforms": [
- {
- "platform_id": 0,
- "platform": "string",
- "usage_data_provider_id": 0,
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_databases": [
- {
- "database_id": 0,
- "database": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "earliest_title": "string",
- "latest_title": "string",
- "earliest_platform": "string",
- "latest_platform": "string",
- "earliest_item": "string",
- "latest_item": "string",
- "earliest_database": "string",
- "latest_database": "string",
- "last_run": "string"
}
]
erm_usage_data_provider_id required | integer ERM usage_data_provider internal identifier |
[- {
- "erm_usage_data_provider_id": 0,
- "name": "string",
- "description": "string",
- "active": 0,
- "method": "string",
- "aggregator": "string",
- "service_type": "string",
- "service_url": "string",
- "report_release": "string",
- "customer_id": "string",
- "requestor_id": "string",
- "api_key": "string",
- "requestor_name": "string",
- "requestor_email": "string",
- "report_types": "string",
- "metric_type": "string",
- "counter_files": [
- {
- "erm_counter_files_id": 0,
- "usage_data_provider_id": 0,
- "type": "string",
- "filename": "string",
- "file_content": "string",
- "date_uploaded": "2019-08-24T14:15:22Z",
- "counter_logs": [
- {
- "erm_counter_log_id": 0,
- "counter_files_id": 0,
- "borrowernumber": 0,
- "importdate": "2019-08-24T14:15:22Z",
- "filename": "string",
- "logdetails": "string",
- "usage_data_provider_id": 0
}
]
}
], - "erm_usage_titles": [
- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "proprietary_id": "string",
- "platform": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "isbn": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_items": [
- {
- "item_id": 0,
- "item": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_platforms": [
- {
- "platform_id": 0,
- "platform": "string",
- "usage_data_provider_id": 0,
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "erm_usage_databases": [
- {
- "database_id": 0,
- "database": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
], - "earliest_title": "string",
- "latest_title": "string",
- "earliest_platform": "string",
- "latest_platform": "string",
- "earliest_item": "string",
- "latest_item": "string",
- "earliest_database": "string",
- "latest_database": "string",
- "last_run": "string"
}
]
database_id | integer Case insensitive search on usage_database database_id |
database | string Case insensitive search on usage_database database |
usage_data_provider_id | string Case insensitive search on usage_database usage_data_provider_id |
platform | string Case insensitive search on usage_database platform |
publisher | string Case insensitive search on usage_database publisher |
publisher_id | string Case insensitive search on usage_title publisher_id |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Enum: "erm_usage_muses" "erm_usage_yuses" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "database_id": 0,
- "database": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
]
item_id | integer Case insensitive search on usage_item item_id |
item | string Case insensitive search on usage_item item |
usage_data_provider_id | string Case insensitive search on usage_item usage_data_provider_id |
platform | string Case insensitive search on usage_item platform |
publisher | string Case insensitive search on usage_item publisher |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Enum: "erm_usage_muses" "erm_usage_yuses" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "item_id": 0,
- "item": "string",
- "usage_data_provider_id": 0,
- "platform": "string",
- "publisher": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
]
platform_id | integer Case insensitive search on usage_platform platform_id |
platform | string Case insensitive search on usage_platform platform |
usage_data_provider_id | string Case insensitive search on usage_platform usage_data_provider_id |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Enum: "erm_usage_muses" "erm_usage_yuses" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "platform_id": 0,
- "platform": "string",
- "usage_data_provider_id": 0,
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
]
title_id | integer Case insensitive search on usage_title title_id |
title | string Case insensitive search on usage_title title |
usage_data_provider_id | string Case insensitive search on usage_title usage_data_provider_id |
title_doi | string Case insensitive search on usage_title title_doi |
print_issn | string Case insensitive search on usage_title print_issn |
online_issn | string Case insensitive search on usage_title online_issn |
title_uri | string Case insensitive search on usage_title title_uri |
publisher | string Case insensitive search on usage_title publisher |
publisher_id | string Case insensitive search on usage_title publisher_id |
yop | string Case insensitive search on usage_title yop |
isbn | string Case insensitive search on usage_title isbn |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Enum: "erm_usage_muses" "erm_usage_yuses" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "proprietary_id": "string",
- "platform": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "isbn": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
]
data_type required | string ERM custom report data type |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "erm_usage_muses" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
]
data_type required | string ERM custom report data type |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "erm_usage_yuses" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
]
data_type required | string ERM custom report data type |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "erm_usage_muses" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
]
data_type required | string ERM custom report data type |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Enum: "erm_usage_titles.erm_usage_muses" "erm_usage_platforms.erm_usage_muses" "erm_usage_databases.erm_usage_muses" "erm_usage_items.erm_usage_muses" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "title_id": 0,
- "title": "string",
- "usage_data_provider_id": 0,
- "title_doi": "string",
- "print_issn": "string",
- "online_issn": "string",
- "title_uri": "string",
- "provider_name": "string",
- "metric_type": "string",
- "publisher": "string",
- "publisher_id": "string",
- "erm_usage_muses": [
- {
- "monthly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "month": 0,
- "usage_count": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
], - "erm_usage_yuses": [
- {
- "yearly_usage_summary_id": 0,
- "title_id": 0,
- "platform_id": 0,
- "database_id": 0,
- "item_id": 0,
- "usage_data_provider_id": 0,
- "year": 0,
- "totalcount": 0,
- "metric_type": "string",
- "access_type": "string",
- "yop": "string",
- "report_type": "string"
}
]
}
]
This resource returns a list of patron allowed to be users of the ERM module
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "extended_attributes" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "patron_id": 0,
- "cardnumber": "string",
- "surname": "string",
- "firstname": "string",
- "middle_name": "string",
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "pronouns": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": "string",
- "phone": "string",
- "mobile": "string",
- "fax": "string",
- "secondary_email": "string",
- "secondary_phone": "string",
- "altaddress_street_number": "string",
- "altaddress_street_type": "string",
- "altaddress_address": "string",
- "altaddress_address2": "string",
- "altaddress_city": "string",
- "altaddress_state": "string",
- "altaddress_postal_code": "string",
- "altaddress_country": "string",
- "altaddress_email": "string",
- "altaddress_phone": "string",
- "date_of_birth": "2019-08-24",
- "library_id": "string",
- "category_id": "string",
- "date_enrolled": "2019-08-24",
- "expiry_date": "2019-08-24",
- "date_renewed": "2019-08-24",
- "incorrect_address": true,
- "patron_card_lost": true,
- "restricted": true,
- "staff_notes": "string",
- "relationship_type": "string",
- "gender": "string",
- "userid": "string",
- "opac_notes": "string",
- "altaddress_notes": "string",
- "statistics_1": "string",
- "statistics_2": "string",
- "autorenew_checkouts": true,
- "altcontact_firstname": "string",
- "altcontact_surname": "string",
- "altcontact_address": "string",
- "altcontact_address2": "string",
- "altcontact_city": "string",
- "altcontact_state": "string",
- "altcontact_postal_code": "string",
- "altcontact_country": "string",
- "altcontact_phone": "string",
- "sms_number": "string",
- "sms_provider_id": 0,
- "privacy": 0,
- "privacy_guarantor_checkouts": 0,
- "privacy_guarantor_fines": true,
- "check_previous_checkout": "string",
- "updated_on": "2019-08-24T14:15:22Z",
- "last_seen": "2019-08-24T14:15:22Z",
- "lang": "string",
- "login_attempts": 0,
- "overdrive_auth_token": "string",
- "anonymized": true,
- "extended_attributes": [
- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
], - "checkouts_count": 0,
- "overdues_count": 0,
- "account_balance": 0,
- "library": { },
- "protected": true,
- "_strings": { }
}
]
name | string Case insensitive search on fund name |
fund_owner_id | integer Display only the funds that belongs to the given patron ID |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "fund_id": 0,
- "code": "string",
- "name": "string",
- "library_id": "string",
- "total_amount": 0,
- "warn_at_percentage": 0,
- "warn_at_amount": 0,
- "notes": "string",
- "budget_id": 0,
- "timestamp": "2019-08-24T14:15:22Z",
- "fund_owner_id": 0,
- "fund_access": 0,
- "parent_fund_id": 0,
- "statistic1_auth_value_category": "string",
- "statistic2_auth_value_category": "string"
}
]
This resource returns a list of patron allowed to be owner of funds
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "extended_attributes" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "patron_id": 0,
- "cardnumber": "string",
- "surname": "string",
- "firstname": "string",
- "middle_name": "string",
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "pronouns": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": "string",
- "phone": "string",
- "mobile": "string",
- "fax": "string",
- "secondary_email": "string",
- "secondary_phone": "string",
- "altaddress_street_number": "string",
- "altaddress_street_type": "string",
- "altaddress_address": "string",
- "altaddress_address2": "string",
- "altaddress_city": "string",
- "altaddress_state": "string",
- "altaddress_postal_code": "string",
- "altaddress_country": "string",
- "altaddress_email": "string",
- "altaddress_phone": "string",
- "date_of_birth": "2019-08-24",
- "library_id": "string",
- "category_id": "string",
- "date_enrolled": "2019-08-24",
- "expiry_date": "2019-08-24",
- "date_renewed": "2019-08-24",
- "incorrect_address": true,
- "patron_card_lost": true,
- "restricted": true,
- "staff_notes": "string",
- "relationship_type": "string",
- "gender": "string",
- "userid": "string",
- "opac_notes": "string",
- "altaddress_notes": "string",
- "statistics_1": "string",
- "statistics_2": "string",
- "autorenew_checkouts": true,
- "altcontact_firstname": "string",
- "altcontact_surname": "string",
- "altcontact_address": "string",
- "altcontact_address2": "string",
- "altcontact_city": "string",
- "altcontact_state": "string",
- "altcontact_postal_code": "string",
- "altcontact_country": "string",
- "altcontact_phone": "string",
- "sms_number": "string",
- "sms_provider_id": 0,
- "privacy": 0,
- "privacy_guarantor_checkouts": 0,
- "privacy_guarantor_fines": true,
- "check_previous_checkout": "string",
- "updated_on": "2019-08-24T14:15:22Z",
- "last_seen": "2019-08-24T14:15:22Z",
- "lang": "string",
- "login_attempts": 0,
- "overdrive_auth_token": "string",
- "anonymized": true,
- "extended_attributes": [
- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
], - "checkouts_count": 0,
- "overdues_count": 0,
- "account_balance": 0,
- "library": { },
- "protected": true,
- "_strings": { }
}
]
This resource returns a list of patron allowed to be owner of funds
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "extended_attributes" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "patron_id": 0,
- "cardnumber": "string",
- "surname": "string",
- "firstname": "string",
- "middle_name": "string",
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "pronouns": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": "string",
- "phone": "string",
- "mobile": "string",
- "fax": "string",
- "secondary_email": "string",
- "secondary_phone": "string",
- "altaddress_street_number": "string",
- "altaddress_street_type": "string",
- "altaddress_address": "string",
- "altaddress_address2": "string",
- "altaddress_city": "string",
- "altaddress_state": "string",
- "altaddress_postal_code": "string",
- "altaddress_country": "string",
- "altaddress_email": "string",
- "altaddress_phone": "string",
- "date_of_birth": "2019-08-24",
- "library_id": "string",
- "category_id": "string",
- "date_enrolled": "2019-08-24",
- "expiry_date": "2019-08-24",
- "date_renewed": "2019-08-24",
- "incorrect_address": true,
- "patron_card_lost": true,
- "restricted": true,
- "staff_notes": "string",
- "relationship_type": "string",
- "gender": "string",
- "userid": "string",
- "opac_notes": "string",
- "altaddress_notes": "string",
- "statistics_1": "string",
- "statistics_2": "string",
- "autorenew_checkouts": true,
- "altcontact_firstname": "string",
- "altcontact_surname": "string",
- "altcontact_address": "string",
- "altcontact_address2": "string",
- "altcontact_city": "string",
- "altcontact_state": "string",
- "altcontact_postal_code": "string",
- "altcontact_country": "string",
- "altcontact_phone": "string",
- "sms_number": "string",
- "sms_provider_id": 0,
- "privacy": 0,
- "privacy_guarantor_checkouts": 0,
- "privacy_guarantor_fines": true,
- "check_previous_checkout": "string",
- "updated_on": "2019-08-24T14:15:22Z",
- "last_seen": "2019-08-24T14:15:22Z",
- "lang": "string",
- "login_attempts": 0,
- "overdrive_auth_token": "string",
- "anonymized": true,
- "extended_attributes": [
- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
], - "checkouts_count": 0,
- "overdues_count": 0,
- "account_balance": 0,
- "library": { },
- "protected": true,
- "_strings": { }
}
]
hold_id | integer Internal hold identifier |
patron_id | integer Internal patron identifier |
hold_date | string <date> Hold |
biblio_id | integer Internal biblio identifier |
item_group_id | integer Internal item group identifier |
pickup_library_id | string Internal library identifier for the pickup library |
cancellation_date | string <date> The date the hold was cancelled |
notes | string Notes related to this hold |
priority | integer Where in the queue the patron sits |
status | string Found status |
timestamp | string Time of latest update |
item_id | integer Internal item identifier |
waiting_date | string Date the item was marked as waiting for the patron |
expiration_date | string Date the hold expires |
lowest_priority | boolean Lowest priority |
suspended | boolean Suspended |
suspended_until | string Suspended until |
non_priority | boolean Non priority hold |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
old | boolean By default, current holds are returned, when this is true then old holds are returned as result. |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "cancellation_requested" "biblio" "pickup_library" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "hold_id": 0,
- "patron_id": 0,
- "hold_date": "2019-08-24",
- "biblio_id": 0,
- "item_group_id": "string",
- "pickup_library_id": "string",
- "desk_id": 0,
- "cancellation_date": "2019-08-24",
- "cancellation_reason": "string",
- "notes": "string",
- "priority": 0,
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "waiting_date": "2019-08-24",
- "expiration_date": "2019-08-24",
- "lowest_priority": true,
- "suspended": true,
- "suspended_until": "2019-08-24T14:15:22Z",
- "non_priority": true,
- "item_type": "string",
- "item_level": true,
- "cancellation_requested": true,
- "biblio": { },
- "item": { },
- "pickup_library": { }
}
]
x-koha-override | Array of strings Items Value: "any" Overrides list sent as a request header |
A JSON object containing informations about the new hold
patron_id required | integer Internal patron identifier |
biblio_id | integer or null Internal biblio identifier |
item_group_id | integer or null Internal item group identifier |
hold_date | string or null <date> The date the hold was placed |
item_id | integer or null Internal item identifier |
pickup_library_id required | string Internal library identifier for the pickup library |
expiration_date | string or null <date> Hold end date |
notes | string or null Notes related to this hold |
item_type | string or null Limit hold on one itemtype (ignored for item-level holds) |
non_priority | boolean or null Set this hold as non priority |
{- "patron_id": 0,
- "biblio_id": 0,
- "item_group_id": 0,
- "hold_date": "2019-08-24",
- "item_id": 0,
- "pickup_library_id": "string",
- "expiration_date": "2019-08-24",
- "notes": "string",
- "item_type": "string",
- "non_priority": true
}
{- "hold_id": 0,
- "patron_id": 0,
- "hold_date": "2019-08-24",
- "biblio_id": 0,
- "item_group_id": "string",
- "pickup_library_id": "string",
- "desk_id": 0,
- "cancellation_date": "2019-08-24",
- "cancellation_reason": "string",
- "notes": "string",
- "priority": 0,
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "waiting_date": "2019-08-24",
- "expiration_date": "2019-08-24",
- "lowest_priority": true,
- "suspended": true,
- "suspended_until": "2019-08-24T14:15:22Z",
- "non_priority": true,
- "item_type": "string",
- "item_level": true,
- "cancellation_requested": true,
- "biblio": { },
- "item": { },
- "pickup_library": { }
}
hold_id required | integer Internal hold identifier |
A JSON object containing fields to modify
priority | integer >= 1 Position in waiting queue |
pickup_library_id | string Internal library identifier for the pickup library |
suspended_until | string <date-time> Date until which the hold has been suspended |
{- "priority": 1,
- "pickup_library_id": "string",
- "suspended_until": "2019-08-24T14:15:22Z"
}
{- "hold_id": 0,
- "patron_id": 0,
- "hold_date": "2019-08-24",
- "biblio_id": 0,
- "item_group_id": "string",
- "pickup_library_id": "string",
- "desk_id": 0,
- "cancellation_date": "2019-08-24",
- "cancellation_reason": "string",
- "notes": "string",
- "priority": 0,
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "waiting_date": "2019-08-24",
- "expiration_date": "2019-08-24",
- "lowest_priority": true,
- "suspended": true,
- "suspended_until": "2019-08-24T14:15:22Z",
- "non_priority": true,
- "item_type": "string",
- "item_level": true,
- "cancellation_requested": true,
- "biblio": { },
- "item": { },
- "pickup_library": { }
}
This route is being deprecated and will be removed in future releases. Please migrate your project to use PATCH /holds/{hold_id} instead.
hold_id required | integer Internal hold identifier |
A JSON object containing fields to modify
priority | integer >= 1 Position in waiting queue |
pickup_library_id | string Internal library identifier for the pickup library |
suspended_until | string <date-time> Date until which the hold has been suspended |
{- "priority": 1,
- "pickup_library_id": "string",
- "suspended_until": "2019-08-24T14:15:22Z"
}
{- "hold_id": 0,
- "patron_id": 0,
- "hold_date": "2019-08-24",
- "biblio_id": 0,
- "item_group_id": "string",
- "pickup_library_id": "string",
- "desk_id": 0,
- "cancellation_date": "2019-08-24",
- "cancellation_reason": "string",
- "notes": "string",
- "priority": 0,
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "waiting_date": "2019-08-24",
- "expiration_date": "2019-08-24",
- "lowest_priority": true,
- "suspended": true,
- "suspended_until": "2019-08-24T14:15:22Z",
- "non_priority": true,
- "item_type": "string",
- "item_level": true,
- "cancellation_requested": true,
- "biblio": { },
- "item": { },
- "pickup_library": { }
}
hold_id required | integer Internal hold identifier |
x-koha-override | Array of strings Items Value: "cancellation-request-flow" Overrides list sent as a request header |
{- "error": "string",
- "error_code": "string"
}
Set a new pickup location for the hold
hold_id required | integer Internal hold identifier |
Pickup location
pickup_library_id | string Internal identifier for the pickup library |
{- "pickup_library_id": "string"
}
{- "pickup_library_id": "string"
}
hold_id required | integer Internal hold identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-override | Array of strings Items Value: "any" Overrides list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "library_id": "string",
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "postal_code": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "illemail": "string",
- "reply_to_email": "string",
- "return_path_email": "string",
- "url": "string",
- "ip": "string",
- "notes": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "pickup_items": [
- 0
], - "public": true,
- "smtp_server": { },
- "needs_override": true,
- "library_hours": [
- null
], - "cash_registers": [
- null
], - "desks": [
- null
]
}
]
hold_id required | integer Internal hold identifier |
An integer representing the new priority to be set for the hold
0
0
hold_id required | integer Internal hold identifier |
A JSON object containing fields to modify
end_date | string <date> Date the hold suspension expires |
{- "end_date": "2019-08-24"
}
{- "error": "string",
- "error_code": "string"
}
patron_id required | integer Internal patron identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
old | boolean By default, current holds are returned, when this is true then old holds are returned as result. |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "cancellation_requested" "biblio" "item" "pickup_library" "pickup_library.branchname" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "hold_id": 0,
- "patron_id": 0,
- "hold_date": "2019-08-24",
- "biblio_id": 0,
- "item_group_id": "string",
- "pickup_library_id": "string",
- "desk_id": 0,
- "cancellation_date": "2019-08-24",
- "cancellation_reason": "string",
- "notes": "string",
- "priority": 0,
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "waiting_date": "2019-08-24",
- "expiration_date": "2019-08-24",
- "lowest_priority": true,
- "suspended": true,
- "suspended_until": "2019-08-24T14:15:22Z",
- "non_priority": true,
- "item_type": "string",
- "item_level": true,
- "cancellation_requested": true,
- "biblio": { },
- "item": { },
- "pickup_library": { }
}
]
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Value: "domains" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "identity_provider_id": 0,
- "code": "string",
- "description": "string",
- "protocol": "OAuth",
- "mapping": { },
- "matchpoint": "email",
- "config": { },
- "icon_url": "string",
- "domains": [
- null
]
}
]
A JSON object containing OAuth provider parameters.
The config
object required attributes depends on the chosen protocol
Requires:
Requires:
code required | string Identity provider code |
description | string User-oriented description for the provider |
protocol required | string Enum: "OAuth" "OIDC" "CAS (not implemented)" "LDAP (not implemented)" Authentication protocol |
mapping | object or null Attribute mapping |
matchpoint | string Enum: "email" "userid" "cardnumber" Patron attribute that will be used to match |
config required | object Configuration |
icon_url | string or null Icon url |
domains | Array of any or null Configured domains for the identity provider |
{- "code": "string",
- "description": "string",
- "protocol": "OAuth",
- "mapping": { },
- "matchpoint": "email",
- "config": { },
- "icon_url": "string",
- "domains": [
- null
]
}
{- "identity_provider_id": 0,
- "code": "string",
- "description": "string",
- "protocol": "OAuth",
- "mapping": { },
- "matchpoint": "email",
- "config": { },
- "icon_url": "string",
- "domains": [
- null
]
}
identity_provider_id required | integer Identity provider internal identifier |
x-koha-embed | Array of strings Items Value: "domains" Embed list sent as a request header |
{- "identity_provider_id": 0,
- "code": "string",
- "description": "string",
- "protocol": "OAuth",
- "mapping": { },
- "matchpoint": "email",
- "config": { },
- "icon_url": "string",
- "domains": [
- null
]
}
identity_provider_id required | integer Identity provider internal identifier |
A JSON object containing OAuth provider parameters.
The config
object required attributes depends on the chosen protocol
Requires:
Requires:
code required | string Identity provider code |
description | string User-oriented description for the provider |
protocol required | string Enum: "OAuth" "OIDC" "CAS (not implemented)" "LDAP (not implemented)" Authentication protocol |
mapping | object or null Attribute mapping |
matchpoint | string Enum: "email" "userid" "cardnumber" Patron attribute that will be used to match |
config required | object Configuration |
icon_url | string or null Icon url |
domains | Array of any or null Configured domains for the identity provider |
{- "code": "string",
- "description": "string",
- "protocol": "OAuth",
- "mapping": { },
- "matchpoint": "email",
- "config": { },
- "icon_url": "string",
- "domains": [
- null
]
}
{- "identity_provider_id": 0,
- "code": "string",
- "description": "string",
- "protocol": "OAuth",
- "mapping": { },
- "matchpoint": "email",
- "config": { },
- "icon_url": "string",
- "domains": [
- null
]
}
identity_provider_id required | integer Identity provider internal identifier |
{- "error": "string",
- "error_code": "string"
}
identity_provider_id required | integer Identity provider internal identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Value: "domains" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "identity_provider_domain_id": 0,
- "identity_provider_id": 0,
- "domain": "string",
- "auto_register": true,
- "update_on_auth": true,
- "default_library_id": "string",
- "default_category_id": "string",
- "allow_opac": true,
- "allow_staff": true
}
]
identity_provider_id required | integer Identity provider internal identifier |
An identity provider domain object
identity_provider_id | integer Internally assigned identity provider identifier |
domain required | string or null Matching domain ('*' used as wildcard) |
auto_register required | boolean If patrons will be generated on login if required |
update_on_auth required | boolean If patron data is updated on login |
default_library_id required | string or null Internal identifier for the default library to be assigned to the new patrons |
default_category_id required | string or null Internal identifier for the default patron's category |
allow_opac required | boolean If this domain can be used for OPAC login |
allow_staff required | boolean If this domain can be used for staff login |
{- "identity_provider_id": 0,
- "domain": "string",
- "auto_register": true,
- "update_on_auth": true,
- "default_library_id": "string",
- "default_category_id": "string",
- "allow_opac": true,
- "allow_staff": true
}
{- "identity_provider_domain_id": 0,
- "identity_provider_id": 0,
- "domain": "string",
- "auto_register": true,
- "update_on_auth": true,
- "default_library_id": "string",
- "default_category_id": "string",
- "allow_opac": true,
- "allow_staff": true
}
identity_provider_id required | integer Identity provider internal identifier |
identity_provider_domain_id required | integer Identity provider domain internal identifier |
{- "identity_provider_domain_id": 0,
- "identity_provider_id": 0,
- "domain": "string",
- "auto_register": true,
- "update_on_auth": true,
- "default_library_id": "string",
- "default_category_id": "string",
- "allow_opac": true,
- "allow_staff": true
}
identity_provider_id required | integer Identity provider internal identifier |
identity_provider_domain_id required | integer Identity provider domain internal identifier |
An identity provider domain object
identity_provider_id | integer Internally assigned identity provider identifier |
domain required | string or null Matching domain ('*' used as wildcard) |
auto_register required | boolean If patrons will be generated on login if required |
update_on_auth required | boolean If patron data is updated on login |
default_library_id required | string or null Internal identifier for the default library to be assigned to the new patrons |
default_category_id required | string or null Internal identifier for the default patron's category |
allow_opac required | boolean If this domain can be used for OPAC login |
allow_staff required | boolean If this domain can be used for staff login |
{- "identity_provider_id": 0,
- "domain": "string",
- "auto_register": true,
- "update_on_auth": true,
- "default_library_id": "string",
- "default_category_id": "string",
- "allow_opac": true,
- "allow_staff": true
}
{- "identity_provider_domain_id": 0,
- "identity_provider_id": 0,
- "domain": "string",
- "auto_register": true,
- "update_on_auth": true,
- "default_library_id": "string",
- "default_category_id": "string",
- "allow_opac": true,
- "allow_staff": true
}
identity_provider_id required | integer Identity provider internal identifier |
identity_provider_domain_id required | integer Identity provider domain internal identifier |
{- "error": "string",
- "error_code": "string"
}
x-koha-embed | Array of strings Items Value: "statuses+strings" Embed list sent as a request header |
[- {
- "ill_backend_id": "string",
- "capabilities": { },
- "statuses": [
- {
- "str": "string",
- "code": "string",
- "type": "string",
- "backend": "string",
- "category": "string"
}
]
}
]
ill_backend_id required | string ILL backend id/name |
x-koha-embed | Array of strings Items Value: "statuses+strings" Embed list sent as a request header |
{- "ill_backend_id": "string",
- "capabilities": { },
- "statuses": [
- {
- "str": "string",
- "code": "string",
- "type": "string",
- "backend": "string",
- "category": "string"
}
]
}
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "+strings" "requests" "requests+count" "patron" "library" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "ill_batch_id": 0,
- "name": "string",
- "backend": "string",
- "cardnumber": "string",
- "patron_id": "string",
- "library_id": "string",
- "status_code": "string",
- "patron": { },
- "library": { },
- "requests": [
- null
], - "requests_count": 0,
- "status": { },
- "_strings": { }
}
]
x-koha-embed | Array of strings Items Enum: "+strings" "requests" "requests+count" "patron" "library" Embed list sent as a request header |
A JSON object containing informations about the new batch
ill_batch_id | integer Internal ILL batch identifier |
name required | string Name of the ILL batch |
backend required | string Backend name |
cardnumber | string Library assigned user identifier of the ILL batch |
patron_id | string Internal identifier the patron of the ILL batch |
library_id required | string Internal identifier for the ILL batch's library |
status_code required | string Code of the status of the ILL batch |
patron | object or null The patron associated with the batch |
library | object or null The library associated with the batch |
requests | Array of any or null The requests in this batch (x-koha-embed) |
requests_count | integer or null The number of requests in this batch (x-koha-embed) |
status | object or null The status associated with the batch (x-koha-embed) |
_strings | object or null Expanded coded fields (x-koha-embed) |
{- "ill_batch_id": 0,
- "name": "string",
- "backend": "string",
- "cardnumber": "string",
- "patron_id": "string",
- "library_id": "string",
- "status_code": "string",
- "patron": { },
- "library": { },
- "requests": [
- null
], - "requests_count": 0,
- "status": { },
- "_strings": { }
}
{- "ill_batch_id": 0,
- "name": "string",
- "backend": "string",
- "cardnumber": "string",
- "patron_id": "string",
- "library_id": "string",
- "status_code": "string",
- "patron": { },
- "library": { },
- "requests": [
- null
], - "requests_count": 0,
- "status": { },
- "_strings": { }
}
ill_batch_id required | string ILL batch id/name/contents |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "+strings" "requests" "requests+count" "patron" "library" Embed list sent as a request header |
Query filter sent through request"s body
{ }
{- "ill_batch_id": 0,
- "name": "string",
- "backend": "string",
- "cardnumber": "string",
- "patron_id": "string",
- "library_id": "string",
- "status_code": "string",
- "patron": { },
- "library": { },
- "requests": [
- null
], - "requests_count": 0,
- "status": { },
- "_strings": { }
}
ill_batch_id required | integer Internal ILL batch identifier |
A JSON object containing information on the batch
ill_batch_id | integer Internal ILL batch identifier |
name required | string Name of the ILL batch |
backend required | string Backend name |
cardnumber | string Library assigned user identifier of the ILL batch |
patron_id | string Internal identifier the patron of the ILL batch |
library_id required | string Internal identifier for the ILL batch's library |
status_code required | string Code of the status of the ILL batch |
patron | object or null The patron associated with the batch |
library | object or null The library associated with the batch |
requests | Array of any or null The requests in this batch (x-koha-embed) |
requests_count | integer or null The number of requests in this batch (x-koha-embed) |
status | object or null The status associated with the batch (x-koha-embed) |
_strings | object or null Expanded coded fields (x-koha-embed) |
{- "ill_batch_id": 0,
- "name": "string",
- "backend": "string",
- "cardnumber": "string",
- "patron_id": "string",
- "library_id": "string",
- "status_code": "string",
- "patron": { },
- "library": { },
- "requests": [
- null
], - "requests_count": 0,
- "status": { },
- "_strings": { }
}
{- "ill_batch_id": 0,
- "name": "string",
- "backend": "string",
- "cardnumber": "string",
- "patron_id": "string",
- "library_id": "string",
- "status_code": "string",
- "patron": { },
- "library": { },
- "requests": [
- null
], - "requests_count": 0,
- "status": { },
- "_strings": { }
}
A JSON object containing informations about the new batch status
id | string Internal ILL batch status identifier |
name required | string Status name |
code required | string Unique, immutable status code |
is_system required | boolean Is this status required for system operation |
{- "id": "string",
- "name": "string",
- "code": "string",
- "is_system": true
}
{- "id": "string",
- "name": "string",
- "code": "string",
- "is_system": true
}
ill_batchstatus_code required | string Internal ILL batch status identifier |
A JSON object containing information on the batch status
id | string Internal ILL batch status identifier |
name required | string Status name |
code required | string Unique, immutable status code |
is_system required | boolean Is this status required for system operation |
{- "id": "string",
- "name": "string",
- "code": "string",
- "is_system": true
}
{- "id": "string",
- "name": "string",
- "code": "string",
- "is_system": true
}
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "+strings" "biblio" "comments" "comments+count" "extended_attributes" "ill_batch" "library" "id_prefix" "patron" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "ill_request_id": 0,
- "biblio_id": 0,
- "ill_batch_id": 0,
- "patron_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "requested_date": "2019-08-24",
- "replied_date": "2019-08-24",
- "timestamp": "2019-08-24T14:15:22Z",
- "completed_date": "2019-08-24",
- "access_url": "string",
- "status": "string",
- "medium": "string",
- "cost": "string",
- "paid_price": "string",
- "opac_notes": "string",
- "staff_notes": "string",
- "ill_backend_id": "string",
- "ill_backend_request_id": "string",
- "status_av": "string",
- "biblio": { },
- "comments": [
- null
], - "comments_count": 0,
- "extended_attributes": [
- null
], - "ill_batch": { },
- "library": { },
- "id_prefix": "string",
- "patron": { },
- "_strings": { }
}
]
A JSON object containing informations about the new request
ill_request_id | integer Internal ILL request identifier |
biblio_id | integer or null Internal bibliographic record identifier |
ill_batch_id | integer or null Batch id this requests belongs to |
patron_id | integer or null Internal patron id |
due_date | string or null <date-time> Date and time the request item should be due when checked out |
library_id | string Internal library identifier |
requested_date | string or null <date> Date the request was placed by the patron |
replied_date | string or null <date> FIXME |
timestamp | string <date-time> Date and time of last object update |
completed_date | string or null <date> Date the request was marked as completed |
access_url | string or null A URL for accessing the item |
status | string The status the request is at. Note: This is defined by each backend. Please refer to the specific backend's documentation or code to understand the possible values. |
medium | string or null Description of the ILL item medium |
cost | string or null Default request cost |
paid_price | string or null Effective request cost |
opac_notes | string or null Note that is visible to the patron |
staff_notes | string or null Interal staff note about the request |
ill_backend_id | string The ILL backend identifier string |
ill_backend_request_id | string or null Backend-specific request id |
status_av | string or null The authorised value category the field is linked to |
biblio | object or null The linked biblio object (x-koha-embed) |
comments | Array of any or null The linked comment objects (x-koha-embed) |
comments_count | integer or null The linked comment objects count (x-koha-embed) |
extended_attributes | Array of any or null The linked extended ill request attributes (x-koha-embed) |
ill_batch | object or null The linked ill batch object (x-koha-embed) |
library | object or null The linked library object (x-koha-embed) |
id_prefix | string or null The id_prefix of the request (x-koha-embed) |
patron | object or null The linked patron object (x-koha-embed) |
_strings | object or null Expanded coded fiels (x-koha-embed) |
{- "ill_request_id": 0,
- "biblio_id": 0,
- "ill_batch_id": 0,
- "patron_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "requested_date": "2019-08-24",
- "replied_date": "2019-08-24",
- "timestamp": "2019-08-24T14:15:22Z",
- "completed_date": "2019-08-24",
- "access_url": "string",
- "status": "string",
- "medium": "string",
- "cost": "string",
- "paid_price": "string",
- "opac_notes": "string",
- "staff_notes": "string",
- "ill_backend_id": "string",
- "ill_backend_request_id": "string",
- "status_av": "string",
- "biblio": { },
- "comments": [
- null
], - "comments_count": 0,
- "extended_attributes": [
- null
], - "ill_batch": { },
- "library": { },
- "id_prefix": "string",
- "patron": { },
- "_strings": { }
}
{- "ill_request_id": 0,
- "biblio_id": 0,
- "ill_batch_id": 0,
- "patron_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "requested_date": "2019-08-24",
- "replied_date": "2019-08-24",
- "timestamp": "2019-08-24T14:15:22Z",
- "completed_date": "2019-08-24",
- "access_url": "string",
- "status": "string",
- "medium": "string",
- "cost": "string",
- "paid_price": "string",
- "opac_notes": "string",
- "staff_notes": "string",
- "ill_backend_id": "string",
- "ill_backend_request_id": "string",
- "status_av": "string",
- "biblio": { },
- "comments": [
- null
], - "comments_count": 0,
- "extended_attributes": [
- null
], - "ill_batch": { },
- "library": { },
- "id_prefix": "string",
- "patron": { },
- "_strings": { }
}
import_batch_id required | integer An import_batch ID |
import_record_id required | integer An import_record ID |
A JSON object containing fields to modify
candidate_match_id | integer Candidate match to choose |
{- "candidate_match_id": 0
}
{- "error": "string",
- "error_code": "string"
}
import_batch_id required | integer An import_batch ID |
import_record_id required | integer An import_record ID |
{- "error": "string",
- "error_code": "string"
}
biblio_id required | string Internal identifier for the parent bibliographic record |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "items" Embed list sent as a request header |
Query filter sent through request"s body
{ }
biblio_id required | string Internal identifier for the parent bibliographic record |
A JSON object representing an item group
description | string ItemGroup description |
display_order | integer Position in waiting queue |
{- "description": "string",
- "display_order": 0
}
biblio_id required | string Internal identifier for the parent bibliographic record |
item_group_id required | string Internal identifier for the item_group |
x-koha-embed | Array of strings Items Value: "items" Embed list sent as a request header |
biblio_id required | string Internal identifier for the parent bibliographic record |
item_group_id required | string Internal identifier for the item group |
x-koha-embed | Array of strings Items Value: "items" Embed list sent as a request header |
A JSON object with the new values for the item group
description | string ItemGroup description |
display_order | integer Position in waiting queue |
{- "description": "string",
- "display_order": 0
}
biblio_id required | string Internal identifier for the parent bibliographic record |
item_group_id required | string Internal identifier for the item group |
x-koha-embed | Array of strings Items Value: "items" Embed list sent as a request header |
A JSON object containing an item_id
item_id | integer Internal identifier for an item to be linked |
{- "item_id": 0
}
biblio_id required | string Internal identifier for the parent bibliographic record |
item_group_id required | string Internal identifier for the item group |
item_id required | string Internal identifier for the item |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "record_source_id": 0,
- "name": "string",
- "can_be_edited": true
}
]
A JSON object containing informations about the new record source
name required | string Record source name |
can_be_edited | boolean If records from this source can be edited |
{- "name": "string",
- "can_be_edited": true
}
{- "record_source_id": 0,
- "name": "string",
- "can_be_edited": true
}
record_source_id required | integer Internal record source identifier |
{- "record_source_id": 0,
- "name": "string",
- "can_be_edited": true
}
record_source_id required | integer Internal record source identifier |
A JSON object containing informations about the new record source
name required | string Record source name |
can_be_edited | boolean If records from this source can be edited |
{- "name": "string",
- "can_be_edited": true
}
{- "record_source_id": 0,
- "name": "string",
- "can_be_edited": true
}
external_id | string Search on the item's barcode |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Enum: "+strings" "biblio" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
]
item_id required | integer Internal item identifier |
x-koha-embed | Array of strings Items Value: "+strings" Embed list sent as a request header |
{- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
item_id required | integer Internal item identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
Query filter sent through request"s body
{ }
[- {
- "biblio_id": 0,
- "biblio": { },
- "booking_id": 0,
- "end_date": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "item": { },
- "patron_id": 0,
- "patron": { },
- "pickup_library_id": "string",
- "pickup_library": { },
- "start_date": "2019-08-24T14:15:22Z"
}
]
item_id required | integer Internal item identifier |
A JSON object containing information about the new bundle link
item_id | integer or null Internal item identifier |
external_id | string or null Item barcode |
force_checkin | boolean or null |
ignore_holds | boolean or null |
{- "item_id": 0,
- "external_id": "string",
- "force_checkin": true,
- "ignore_holds": true
}
[- {
- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
]
item_id required | integer Internal item identifier |
external_id | string Search on the item's barcode |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Enum: "biblio" "checkout" "return_claims" "return_claim" "return_claim.patron" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
]
item_id required | integer Internal item identifier |
bundled_item_id required | string Internal identifier for the bundled item |
{- "error": "string",
- "error_code": "string"
}
item_id required | integer Internal item identifier |
patron_id required | integer Internal patron identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "library_id": "string",
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "postal_code": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "illemail": "string",
- "reply_to_email": "string",
- "return_path_email": "string",
- "url": "string",
- "ip": "string",
- "notes": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "pickup_items": [
- 0
], - "public": true,
- "smtp_server": { },
- "needs_override": true,
- "library_hours": [
- null
], - "cash_registers": [
- null
], - "desks": [
- null
]
}
]
external_id | string Search on the item's barcode |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "+strings" "biblio" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
]
biblio_id required | integer Record internal identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "+strings" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
]
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "translated_descriptions" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "item_type_id": "string",
- "parent_type": "string",
- "description": "string",
- "rentalcharge": 0,
- "daily_rental_charge": 0,
- "daily_rental_charge_calendar": true,
- "hourly_rental_charge": 0,
- "hourly_rental_charge_calendar": true,
- "default_replacement_cost": 0,
- "process_fee": 0,
- "not_for_loan_status": true,
- "image_url": "string",
- "summary": "string",
- "checkin_message": "string",
- "checkin_message_type": "string",
- "sip_media_type": "string",
- "hide_in_opac": true,
- "searchcategory": "string",
- "automatic_checkin": true,
- "translated_descriptions": [
- {
- "lang": "string",
- "translation": "string"
}
]
}
]
only_current | boolean Only include current jobs |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "job_id": 0,
- "status": "string",
- "progress": "string",
- "size": "string",
- "patron_id": "string",
- "type": "string",
- "queue": "string",
- "data": { },
- "context": { },
- "enqueued_date": "2019-08-24T14:15:22Z",
- "started_date": "2019-08-24T14:15:22Z",
- "ended_date": "2019-08-24T14:15:22Z"
}
]
job_id required | integer Job internal identifier |
{- "job_id": 0,
- "status": "string",
- "progress": "string",
- "size": "string",
- "patron_id": "string",
- "type": "string",
- "queue": "string",
- "data": { },
- "context": { },
- "enqueued_date": "2019-08-24T14:15:22Z",
- "started_date": "2019-08-24T14:15:22Z",
- "ended_date": "2019-08-24T14:15:22Z"
}
name | string Case insensitive 'starts-with' search on name |
address1 | string Case insensitive 'starts-with' search on address1 |
address2 | string Case insensitive 'starts-with' search on address2 |
address3 | string Case insensitive 'starts-with' search on address3 |
postal_code | string Case insensitive 'starts-with' search on postal code |
city | string Case insensitive 'starts-with' search on city |
state | string Case insensitive 'starts-with' search on state |
country | string Case insensitive 'starts_with' search on country |
phone | string Case insensitive 'starts_with' search on phone number |
fax | string Case insensitive 'starts_with' search on fax number |
string Case insensitive 'starts_with' search on email address | |
reply_to_email | string Case insensitive 'starts_with' search on Reply-To email address |
return_path_email | string Case insensitive 'starts_with' search on Return-Path email address |
url | string Case insensitive 'starts_with' search on website URL |
ip | string Case insensitive 'starts_with' search on IP address |
notes | string Case insensitive 'starts_with' search on notes |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "cash_registers" "desks" "smtp_server" "library_hours" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "library_id": "string",
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "postal_code": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "illemail": "string",
- "reply_to_email": "string",
- "return_path_email": "string",
- "url": "string",
- "ip": "string",
- "notes": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "pickup_items": [
- 0
], - "public": true,
- "smtp_server": { },
- "needs_override": true,
- "library_hours": [
- null
], - "cash_registers": [
- null
], - "desks": [
- null
]
}
]
A JSON object containing informations about the new library
library_id required | string [ 1 .. 10 ] characters internally assigned library identifier |
name required | string Printable name of library |
address1 | string or null the first address line of the library |
address2 | string or null the second address line of the library |
address3 | string or null the third address line of the library |
postal_code | string or null the postal code of the library |
city | string or null the city or province of the library |
state | string or null the reqional state of the library |
country | string or null the county of the library |
phone | string or null the primary phone of the library |
fax | string or null the fax number of the library |
string or null the primary email address of the library | |
illemail | string or null the ILL staff email address of the library |
reply_to_email | string or null the email to be used as a Reply-To |
return_path_email | string or null the email to be used as Return-Path |
url | string or null the URL for your library or branch's website |
ip | string or null the IP address for your library or branch |
notes | string or null notes related to your library or branch |
geolocation | string or null geolocation of your library |
marc_org_code | string or null MARC Organization Code, see http://www.loc.gov/marc/organizations/orgshome.html, when empty defaults to syspref MARCOrgCode |
pickup_location | boolean If the library can act as a pickup location |
pickup_items | Array of integers or null Array of items available for pickup at this library if the library is marked as a pickup location |
public | boolean If the library is visible to the public |
smtp_server | object or null The library effective SMTP server |
needs_override | boolean If the library needs an override to act as pickup location for a hold |
library_hours | Array of any or null The open and close times for a library on any given day |
cash_registers | Array of any or null The library's defined cash registers (x-koha-embed) |
desks | Array of any or null The library's defined desks (x-koha-embed) |
{- "library_id": "string",
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "postal_code": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "illemail": "string",
- "reply_to_email": "string",
- "return_path_email": "string",
- "url": "string",
- "ip": "string",
- "notes": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "pickup_items": [
- 0
], - "public": true,
- "smtp_server": { },
- "needs_override": true,
- "library_hours": [
- null
], - "cash_registers": [
- null
], - "desks": [
- null
]
}
{- "library_id": "string",
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "postal_code": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "illemail": "string",
- "reply_to_email": "string",
- "return_path_email": "string",
- "url": "string",
- "ip": "string",
- "notes": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "pickup_items": [
- 0
], - "public": true,
- "smtp_server": { },
- "needs_override": true,
- "library_hours": [
- null
], - "cash_registers": [
- null
], - "desks": [
- null
]
}
library_id required | string Internal library identifier |
x-koha-embed | Array of strings Items Enum: "cash_registers" "desks" "smtp_server" "library_hours" Embed list sent as a request header |
{- "library_id": "string",
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "postal_code": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "illemail": "string",
- "reply_to_email": "string",
- "return_path_email": "string",
- "url": "string",
- "ip": "string",
- "notes": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "pickup_items": [
- 0
], - "public": true,
- "smtp_server": { },
- "needs_override": true,
- "library_hours": [
- null
], - "cash_registers": [
- null
], - "desks": [
- null
]
}
library_id required | string Internal library identifier |
A JSON object containing information on the library
library_id required | string [ 1 .. 10 ] characters internally assigned library identifier |
name required | string Printable name of library |
address1 | string or null the first address line of the library |
address2 | string or null the second address line of the library |
address3 | string or null the third address line of the library |
postal_code | string or null the postal code of the library |
city | string or null the city or province of the library |
state | string or null the reqional state of the library |
country | string or null the county of the library |
phone | string or null the primary phone of the library |
fax | string or null the fax number of the library |
string or null the primary email address of the library | |
illemail | string or null the ILL staff email address of the library |
reply_to_email | string or null the email to be used as a Reply-To |
return_path_email | string or null the email to be used as Return-Path |
url | string or null the URL for your library or branch's website |
ip | string or null the IP address for your library or branch |
notes | string or null notes related to your library or branch |
geolocation | string or null geolocation of your library |
marc_org_code | string or null MARC Organization Code, see http://www.loc.gov/marc/organizations/orgshome.html, when empty defaults to syspref MARCOrgCode |
pickup_location | boolean If the library can act as a pickup location |
pickup_items | Array of integers or null Array of items available for pickup at this library if the library is marked as a pickup location |
public | boolean If the library is visible to the public |
smtp_server | object or null The library effective SMTP server |
needs_override | boolean If the library needs an override to act as pickup location for a hold |
library_hours | Array of any or null The open and close times for a library on any given day |
cash_registers | Array of any or null The library's defined cash registers (x-koha-embed) |
desks | Array of any or null The library's defined desks (x-koha-embed) |
{- "library_id": "string",
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "postal_code": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "illemail": "string",
- "reply_to_email": "string",
- "return_path_email": "string",
- "url": "string",
- "ip": "string",
- "notes": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "pickup_items": [
- 0
], - "public": true,
- "smtp_server": { },
- "needs_override": true,
- "library_hours": [
- null
], - "cash_registers": [
- null
], - "desks": [
- null
]
}
{- "library_id": "string",
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "postal_code": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "illemail": "string",
- "reply_to_email": "string",
- "return_path_email": "string",
- "url": "string",
- "ip": "string",
- "notes": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "pickup_items": [
- 0
], - "public": true,
- "smtp_server": { },
- "needs_override": true,
- "library_hours": [
- null
], - "cash_registers": [
- null
], - "desks": [
- null
]
}
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "library_id": "string",
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "postal_code": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "phone": "string",
- "fax": "string",
- "email": "string",
- "illemail": "string",
- "reply_to_email": "string",
- "return_path_email": "string",
- "url": "string",
- "ip": "string",
- "notes": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "pickup_items": [
- 0
], - "public": true,
- "smtp_server": { },
- "needs_override": true,
- "library_hours": [
- null
], - "cash_registers": [
- null
], - "desks": [
- null
]
}
]
name | string Case insensative search on macro name |
macro_text | string Case insensative search on macro text |
patron_id | string Search on internal patron_id |
shared | string Search on shared macros |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "macro_id": 0,
- "name": "string",
- "macro_text": "string",
- "patron_id": 0,
- "shared": true
}
]
A JSON object containing informations about the new macro
name required | string macro name |
macro_text required | string or null macro text |
patron_id required | integer or null borrower number |
shared required | boolean or null is macro shared |
{- "name": "string",
- "macro_text": "string",
- "patron_id": 0,
- "shared": true
}
{- "macro_id": 0,
- "name": "string",
- "macro_text": "string",
- "patron_id": 0,
- "shared": true
}
advancededitormacro_id required | integer Advanced editor macro internal identifier |
{- "macro_id": 0,
- "name": "string",
- "macro_text": "string",
- "patron_id": 0,
- "shared": true
}
advancededitormacro_id required | integer Advanced editor macro internal identifier |
An advanced editor macro object
name required | string macro name |
macro_text required | string or null macro text |
patron_id required | integer or null borrower number |
shared required | boolean or null is macro shared |
{- "name": "string",
- "macro_text": "string",
- "patron_id": 0,
- "shared": true
}
{- "macro_id": 0,
- "name": "string",
- "macro_text": "string",
- "patron_id": 0,
- "shared": true
}
biblio_id | integer Identifier for a linked bibliographic record |
basket_id | integer Identifier for a linked acquisition basket |
fund_id | integer Identifier for the fund the order goes against |
status | string Current status for the order. Can be 'new', 'ordered', 'partial', 'complete' or 'cancelled' |
only_active | boolean If only active orders should be listed |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "basket" "basket.basket_group" "basket.creator" "biblio" "biblio.uncancelled_orders+count" "biblio.holds+count" "biblio.items+count" "biblio.suggestions.suggester" "creator" "fund" "fund.budget" "current_item_level_holds+count" "invoice" "items" "items+strings" "subscription" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "order_id": 0,
- "biblio_id": 0,
- "deleted_biblio_id": 0,
- "created_by": 0,
- "entry_date": "2019-08-24",
- "quantity": 0,
- "currency": "string",
- "list_price": 0,
- "replacement_price": 0,
- "date_received": "2019-08-24",
- "invoice_id": 0,
- "shipping_cost": 0,
- "unit_price": 0,
- "unit_price_tax_excluded": 0,
- "unit_price_tax_included": 0,
- "quantity_received": 0,
- "cancellation_date": "2019-08-24",
- "cancellation_reason": "string",
- "internal_note": "string",
- "vendor_note": "string",
- "basket_id": 0,
- "timestamp": "2019-08-24T14:15:22Z",
- "rrp": 0,
- "rrp_tax_excluded": 0,
- "rrp_tax_included": 0,
- "ecost": 0,
- "ecost_tax_excluded": 0,
- "ecost_tax_included": 0,
- "tax_rate_on_ordering": 0,
- "tax_rate_on_receiving": 0,
- "tax_value_on_ordering": 0,
- "tax_value_on_receiving": 0,
- "discount_rate": 0,
- "fund_id": 0,
- "statistics_1": "string",
- "statistics_2": "string",
- "statistics_1_authcat": "string",
- "statistics_2_authcat": "string",
- "uncertain_price": true,
- "claims_count": 0,
- "last_claim_date": "2019-08-24",
- "subscription_id": 0,
- "parent_order_id": 0,
- "status": "new",
- "basket": { },
- "biblio": { },
- "current_item_level_holds_count": 0,
- "estimated_delivery_date": "2019-08-24",
- "invoice_unit_price": 0,
- "invoice_currency": "string",
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { },
- "creator": { }
}
]
A JSON object representing an order
order_id | integer Internally assigned order identifier |
biblio_id | integer or null Identifier for the linked bibliographic record |
deleted_biblio_id | integer or null Identifier for the linked deleted bibliographic record |
created_by | integer or null Interal patron identifier of the order line creator |
entry_date | string or null <date> Date the bib was added to the basket |
quantity | integer or null Ordered quantity |
currency | string or null Currency used for the purchase |
list_price | number or null Vendor price for the line item |
replacement_price | number or null Replacement cost for this item |
date_received | string or null <date> Date the order was received |
invoice_id | integer or null Id of the order invoice |
shipping_cost | number or null Shipping cost |
unit_price | number or null The actual cost entered when receiving this line item |
unit_price_tax_excluded | number or null Unit price excluding tax (on receiving) |
unit_price_tax_included | number or null Unit price including tax (on receiving) |
quantity_received | integer Quantity received so far |
cancellation_date | string or null <date> Date the line item was deleted |
cancellation_reason | string or null Reason of cancellation |
internal_note | string or null Notes related to this order line, made for staff |
vendor_note | string or null Notes related to this order line, made for vendor |
basket_id | integer or null Basket this order is linked to |
timestamp | string <date-time> Date and time this order line was last modified |
rrp | number or null Retail cost for this item |
rrp_tax_excluded | number or null Replacement cost for this item (tax excluded) |
rrp_tax_included | number or null Replacement cost for this item (tax included) |
ecost | number or null Effective cost |
ecost_tax_excluded | number or null Effective cost (tax excluded) |
ecost_tax_included | number or null Effective cost (tax included) |
tax_rate_on_ordering | number or null Tax rate on ordering (%) |
tax_rate_on_receiving | number or null Tax rate on receiving (%) |
tax_value_on_ordering | number or null Tax value on ordering |
tax_value_on_receiving | number or null Tax value on receiving |
discount_rate | number or null Discount rate |
fund_id | integer Internal identifier for the fund this order goes against |
statistics_1 | string or null Statistical field |
statistics_2 | string or null Statistical field (2) |
statistics_1_authcat | string or null Statistical category for this order |
statistics_2_authcat | string or null Statistical category for this order (2) |
uncertain_price | boolean If this price was uncertain |
claims_count | integer Generated claim letters count |
last_claim_date | string or null <date> Last date a claim letter was generated |
subscription_id | integer or null Subscription ID linking the order to a subscription |
parent_order_id | integer or null Order ID of parent order line if exists |
status | string Enum: "new" "ordered" "partial" "complete" "cancelled" The current order status |
basket | object or null |
biblio | object or null |
current_item_level_holds_count | integer Current holds count for associated items |
estimated_delivery_date | string or null <date> Estimated delivery date |
invoice_unit_price | number or null The actual cost in the foreign currency used in the invoice |
invoice_currency | string or null Currency of the actual cost used when receiving |
fund | object or null |
invoice | object or null |
items | Array of any |
subscription | object or null |
creator | object or null Patron that created the order |
{- "order_id": 0,
- "biblio_id": 0,
- "deleted_biblio_id": 0,
- "created_by": 0,
- "entry_date": "2019-08-24",
- "quantity": 0,
- "currency": "string",
- "list_price": 0,
- "replacement_price": 0,
- "date_received": "2019-08-24",
- "invoice_id": 0,
- "shipping_cost": 0,
- "unit_price": 0,
- "unit_price_tax_excluded": 0,
- "unit_price_tax_included": 0,
- "quantity_received": 0,
- "cancellation_date": "2019-08-24",
- "cancellation_reason": "string",
- "internal_note": "string",
- "vendor_note": "string",
- "basket_id": 0,
- "timestamp": "2019-08-24T14:15:22Z",
- "rrp": 0,
- "rrp_tax_excluded": 0,
- "rrp_tax_included": 0,
- "ecost": 0,
- "ecost_tax_excluded": 0,
- "ecost_tax_included": 0,
- "tax_rate_on_ordering": 0,
- "tax_rate_on_receiving": 0,
- "tax_value_on_ordering": 0,
- "tax_value_on_receiving": 0,
- "discount_rate": 0,
- "fund_id": 0,
- "statistics_1": "string",
- "statistics_2": "string",
- "statistics_1_authcat": "string",
- "statistics_2_authcat": "string",
- "uncertain_price": true,
- "claims_count": 0,
- "last_claim_date": "2019-08-24",
- "subscription_id": 0,
- "parent_order_id": 0,
- "status": "new",
- "basket": { },
- "biblio": { },
- "current_item_level_holds_count": 0,
- "estimated_delivery_date": "2019-08-24",
- "invoice_unit_price": 0,
- "invoice_currency": "string",
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { },
- "creator": { }
}
{- "order_id": 0,
- "biblio_id": 0,
- "deleted_biblio_id": 0,
- "created_by": 0,
- "entry_date": "2019-08-24",
- "quantity": 0,
- "currency": "string",
- "list_price": 0,
- "replacement_price": 0,
- "date_received": "2019-08-24",
- "invoice_id": 0,
- "shipping_cost": 0,
- "unit_price": 0,
- "unit_price_tax_excluded": 0,
- "unit_price_tax_included": 0,
- "quantity_received": 0,
- "cancellation_date": "2019-08-24",
- "cancellation_reason": "string",
- "internal_note": "string",
- "vendor_note": "string",
- "basket_id": 0,
- "timestamp": "2019-08-24T14:15:22Z",
- "rrp": 0,
- "rrp_tax_excluded": 0,
- "rrp_tax_included": 0,
- "ecost": 0,
- "ecost_tax_excluded": 0,
- "ecost_tax_included": 0,
- "tax_rate_on_ordering": 0,
- "tax_rate_on_receiving": 0,
- "tax_value_on_ordering": 0,
- "tax_value_on_receiving": 0,
- "discount_rate": 0,
- "fund_id": 0,
- "statistics_1": "string",
- "statistics_2": "string",
- "statistics_1_authcat": "string",
- "statistics_2_authcat": "string",
- "uncertain_price": true,
- "claims_count": 0,
- "last_claim_date": "2019-08-24",
- "subscription_id": 0,
- "parent_order_id": 0,
- "status": "new",
- "basket": { },
- "biblio": { },
- "current_item_level_holds_count": 0,
- "estimated_delivery_date": "2019-08-24",
- "invoice_unit_price": 0,
- "invoice_currency": "string",
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { },
- "creator": { }
}
order_id required | integer Internal order identifier |
x-koha-embed | Array of strings Items Enum: "basket" "basket.basket_group" "basket.creator" "biblio" "biblio.uncancelled_orders+count" "biblio.holds+count" "biblio.items+count" "biblio.suggestions.suggester" "fund" "current_item_level_holds+count" "invoice" "items" "subscription" Embed list sent as a request header |
{- "order_id": 0,
- "biblio_id": 0,
- "deleted_biblio_id": 0,
- "created_by": 0,
- "entry_date": "2019-08-24",
- "quantity": 0,
- "currency": "string",
- "list_price": 0,
- "replacement_price": 0,
- "date_received": "2019-08-24",
- "invoice_id": 0,
- "shipping_cost": 0,
- "unit_price": 0,
- "unit_price_tax_excluded": 0,
- "unit_price_tax_included": 0,
- "quantity_received": 0,
- "cancellation_date": "2019-08-24",
- "cancellation_reason": "string",
- "internal_note": "string",
- "vendor_note": "string",
- "basket_id": 0,
- "timestamp": "2019-08-24T14:15:22Z",
- "rrp": 0,
- "rrp_tax_excluded": 0,
- "rrp_tax_included": 0,
- "ecost": 0,
- "ecost_tax_excluded": 0,
- "ecost_tax_included": 0,
- "tax_rate_on_ordering": 0,
- "tax_rate_on_receiving": 0,
- "tax_value_on_ordering": 0,
- "tax_value_on_receiving": 0,
- "discount_rate": 0,
- "fund_id": 0,
- "statistics_1": "string",
- "statistics_2": "string",
- "statistics_1_authcat": "string",
- "statistics_2_authcat": "string",
- "uncertain_price": true,
- "claims_count": 0,
- "last_claim_date": "2019-08-24",
- "subscription_id": 0,
- "parent_order_id": 0,
- "status": "new",
- "basket": { },
- "biblio": { },
- "current_item_level_holds_count": 0,
- "estimated_delivery_date": "2019-08-24",
- "invoice_unit_price": 0,
- "invoice_currency": "string",
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { },
- "creator": { }
}
order_id required | integer Internal order identifier |
A JSON object representing an order
order_id | integer Internally assigned order identifier |
biblio_id | integer or null Identifier for the linked bibliographic record |
deleted_biblio_id | integer or null Identifier for the linked deleted bibliographic record |
created_by | integer or null Interal patron identifier of the order line creator |
entry_date | string or null <date> Date the bib was added to the basket |
quantity | integer or null Ordered quantity |
currency | string or null Currency used for the purchase |
list_price | number or null Vendor price for the line item |
replacement_price | number or null Replacement cost for this item |
date_received | string or null <date> Date the order was received |
invoice_id | integer or null Id of the order invoice |
shipping_cost | number or null Shipping cost |
unit_price | number or null The actual cost entered when receiving this line item |
unit_price_tax_excluded | number or null Unit price excluding tax (on receiving) |
unit_price_tax_included | number or null Unit price including tax (on receiving) |
quantity_received | integer Quantity received so far |
cancellation_date | string or null <date> Date the line item was deleted |
cancellation_reason | string or null Reason of cancellation |
internal_note | string or null Notes related to this order line, made for staff |
vendor_note | string or null Notes related to this order line, made for vendor |
basket_id | integer or null Basket this order is linked to |
timestamp | string <date-time> Date and time this order line was last modified |
rrp | number or null Retail cost for this item |
rrp_tax_excluded | number or null Replacement cost for this item (tax excluded) |
rrp_tax_included | number or null Replacement cost for this item (tax included) |
ecost | number or null Effective cost |
ecost_tax_excluded | number or null Effective cost (tax excluded) |
ecost_tax_included | number or null Effective cost (tax included) |
tax_rate_on_ordering | number or null Tax rate on ordering (%) |
tax_rate_on_receiving | number or null Tax rate on receiving (%) |
tax_value_on_ordering | number or null Tax value on ordering |
tax_value_on_receiving | number or null Tax value on receiving |
discount_rate | number or null Discount rate |
fund_id | integer Internal identifier for the fund this order goes against |
statistics_1 | string or null Statistical field |
statistics_2 | string or null Statistical field (2) |
statistics_1_authcat | string or null Statistical category for this order |
statistics_2_authcat | string or null Statistical category for this order (2) |
uncertain_price | boolean If this price was uncertain |
claims_count | integer Generated claim letters count |
last_claim_date | string or null <date> Last date a claim letter was generated |
subscription_id | integer or null Subscription ID linking the order to a subscription |
parent_order_id | integer or null Order ID of parent order line if exists |
status | string Enum: "new" "ordered" "partial" "complete" "cancelled" The current order status |
basket | object or null |
biblio | object or null |
current_item_level_holds_count | integer Current holds count for associated items |
estimated_delivery_date | string or null <date> Estimated delivery date |
invoice_unit_price | number or null The actual cost in the foreign currency used in the invoice |
invoice_currency | string or null Currency of the actual cost used when receiving |
fund | object or null |
invoice | object or null |
items | Array of any |
subscription | object or null |
creator | object or null Patron that created the order |
{- "order_id": 0,
- "biblio_id": 0,
- "deleted_biblio_id": 0,
- "created_by": 0,
- "entry_date": "2019-08-24",
- "quantity": 0,
- "currency": "string",
- "list_price": 0,
- "replacement_price": 0,
- "date_received": "2019-08-24",
- "invoice_id": 0,
- "shipping_cost": 0,
- "unit_price": 0,
- "unit_price_tax_excluded": 0,
- "unit_price_tax_included": 0,
- "quantity_received": 0,
- "cancellation_date": "2019-08-24",
- "cancellation_reason": "string",
- "internal_note": "string",
- "vendor_note": "string",
- "basket_id": 0,
- "timestamp": "2019-08-24T14:15:22Z",
- "rrp": 0,
- "rrp_tax_excluded": 0,
- "rrp_tax_included": 0,
- "ecost": 0,
- "ecost_tax_excluded": 0,
- "ecost_tax_included": 0,
- "tax_rate_on_ordering": 0,
- "tax_rate_on_receiving": 0,
- "tax_value_on_ordering": 0,
- "tax_value_on_receiving": 0,
- "discount_rate": 0,
- "fund_id": 0,
- "statistics_1": "string",
- "statistics_2": "string",
- "statistics_1_authcat": "string",
- "statistics_2_authcat": "string",
- "uncertain_price": true,
- "claims_count": 0,
- "last_claim_date": "2019-08-24",
- "subscription_id": 0,
- "parent_order_id": 0,
- "status": "new",
- "basket": { },
- "biblio": { },
- "current_item_level_holds_count": 0,
- "estimated_delivery_date": "2019-08-24",
- "invoice_unit_price": 0,
- "invoice_currency": "string",
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { },
- "creator": { }
}
{- "order_id": 0,
- "biblio_id": 0,
- "deleted_biblio_id": 0,
- "created_by": 0,
- "entry_date": "2019-08-24",
- "quantity": 0,
- "currency": "string",
- "list_price": 0,
- "replacement_price": 0,
- "date_received": "2019-08-24",
- "invoice_id": 0,
- "shipping_cost": 0,
- "unit_price": 0,
- "unit_price_tax_excluded": 0,
- "unit_price_tax_included": 0,
- "quantity_received": 0,
- "cancellation_date": "2019-08-24",
- "cancellation_reason": "string",
- "internal_note": "string",
- "vendor_note": "string",
- "basket_id": 0,
- "timestamp": "2019-08-24T14:15:22Z",
- "rrp": 0,
- "rrp_tax_excluded": 0,
- "rrp_tax_included": 0,
- "ecost": 0,
- "ecost_tax_excluded": 0,
- "ecost_tax_included": 0,
- "tax_rate_on_ordering": 0,
- "tax_rate_on_receiving": 0,
- "tax_value_on_ordering": 0,
- "tax_value_on_receiving": 0,
- "discount_rate": 0,
- "fund_id": 0,
- "statistics_1": "string",
- "statistics_2": "string",
- "statistics_1_authcat": "string",
- "statistics_2_authcat": "string",
- "uncertain_price": true,
- "claims_count": 0,
- "last_claim_date": "2019-08-24",
- "subscription_id": 0,
- "parent_order_id": 0,
- "status": "new",
- "basket": { },
- "biblio": { },
- "current_item_level_holds_count": 0,
- "estimated_delivery_date": "2019-08-24",
- "invoice_unit_price": 0,
- "invoice_currency": "string",
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { },
- "creator": { }
}
provider_code required | string Code for OAuth provider |
interface required | string Name of the interface this login is for |
code | string Code returned from OAuth server for Authorization Code grant |
state | string An opaque value used by the client to maintain state between the request and callback. This is the callback part. |
scope | string Scope returned by OAuth server |
prompt | string Prompt returned by OAuth server |
authuser | string Auth user returned by OAuth server |
error | string OAuth error code |
error_description | string OAuth error description |
error_uri | string Web page with user friendly description of the error |
session_state | string Session state returned by OAuth server |
"string"
grant_type required | string grant type (client_credentials) |
client_id | string client id |
client_secret | string client secret |
{- "access_token": "string",
- "token_type": "string",
- "expires_in": 0
}
provider_code required | string Code for OAuth provider |
interface required | string Name of the interface this login is for |
code | string Code returned from OAuth server for Authorization Code grant |
state | string An opaque value used by the client to maintain state between the request and callback. This is the callback part. |
scope | string Scope returned by OAuth server |
prompt | string Prompt returned by OAuth server |
authuser | string Auth user returned by OAuth server |
error | string OAuth error code |
error_description | string OAuth error description |
error_uri | string Web page with user friendly description of the error |
session_state | string Session state returned by OAuth server |
"string"
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "patron_category_id": "string",
- "name": "string",
- "enrolment_period": 0,
- "enrolment_period_date": "2019-08-24",
- "password_expiry_days": 0,
- "upper_age_limit": 0,
- "lower_age_limit": 0,
- "enrolment_fee": 0,
- "overdue_notice_required": true,
- "reserve_fee": 0,
- "hide_lost_items": true,
- "category_type": "string",
- "block_expired_patron_opac_actions": 0,
- "default_privacy": "default",
- "check_prev_checkout": "string",
- "can_place_ill_in_opac": true,
- "can_be_guarantee": true,
- "reset_password": true,
- "change_password": true,
- "min_password_length": 0,
- "require_strong_password": true,
- "exclude_from_local_holds_priority": true
}
]
A JSON object containing a patron identifier and password information.
The identifier will be used to match patrons on the database using the following order:
Optionally, you can specify the userid
attribute if you don't want it
to be checked against the patron cardnumbers.
identifier | string A patron identifier ( |
password required | string Password (plain text) |
userid | string A patron userid |
{- "identifier": "string",
- "password": "string",
- "userid": "string"
}
{- "cardnumber": "string",
- "patron_id": 0,
- "userid": "string"
}
confirmation | string A JWT confirmation token |
A JSON object containing information about the new checkout
checkout_id | integer internally assigned checkout identifier |
patron_id | integer Internal patron identifier |
item_id | integer or null internal identifier of checked out item |
due_date | string <date-time> Due date |
library_id | string or null code of the library the item was checked out |
issuer_id | integer or null internally assigned for the user that processed the checkout |
checkin_date | string or null <date-time> Date the item was returned |
last_renewed_date | string or null <date-time> Date the item was last renewed |
renewals_count | integer or null Number of renewals |
unseen_renewals | integer or null Number of consecutive unseen renewals |
auto_renew | boolean Auto renewal |
auto_renew_error | string or null Auto renewal error |
timestamp | string Last update time |
checkout_date | string <date-time> Date the item was issued |
onsite_checkout | boolean On site checkout |
note | string or null Issue note text |
note_date | string or null <date> Datetime of the issue note |
note_seen | boolean or null has the note been seen already |
issuer | object or null The object representing the checkout issuer |
item | object or null The object representing the checked out item |
library | object or null The object representing the checkout library |
patron | object or null The object representing the checkout patron |
{- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
{- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
patron_id | string Search on patron_id |
cardnumber | string Case insensitive search on cardnumber |
surname | string Case insensitive search on surname |
firstname | string Case insensitive search on firstname |
title | string Case insensitive search on title |
other_name | string Case insensitive search on othernames |
initials | string Case insensitive search on initials |
street_number | string Case insensitive search on streetnumber |
street_type | string Case insensitive search on streettype |
address | string Case insensitive search on address |
address2 | string Case insensitive search on address2 |
city | string Case insensitive search on city |
state | string Case insensitive search on state |
postal_code | string Case insensitive search on zipcode |
country | string Case insensitive search on country |
string Case insensitive search on email | |
phone | string Case insensitive search on phone |
mobile | string Case insensitive search on mobile |
fax | string Case insensitive search on fax |
secondary_email | string Case insensitive search on secondary_email |
secondary_phone | string Case insensitive search on secondary_phone |
altaddress_street_number | string Case insensitive search on altaddress_street_number |
altaddress_street_type | string Case insensitive search on altaddress_street_type |
altaddress_address | string Case insensitive search on altaddress_address |
altaddress_address2 | string Case insensitive search on altaddress_address2 |
altaddress_city | string Case insensitive search on altaddress_city |
altaddress_state | string Case insensitive search on altaddress_state |
altaddress_postal_code | string Case insensitive search on altaddress_postal_code |
altaddress_country | string Case insensitive search on altaddress_country |
altaddress_email | string Case insensitive search on altaddress_email |
altaddress_phone | string Case insensitive search on altaddress_phone |
date_of_birth | string Case insensitive search on date_of_birth |
library_id | string Case insensitive search on library_id |
category_id | string Case insensitive search on category_id |
date_enrolled | string Case insensitive search on date_enrolled |
expiry_date | string Case insensitive search on expiry_date |
incorrect_address | boolean Search on incorrect_address |
patron_card_lost | boolean Search on patron_card_lost |
restricted | boolean Filter search by restricted |
staff_notes | string Case insensitive search on staff_notes |
relationship_type | string Case insensitive search on relationship_type |
gender | string Case insensitive search on gender |
userid | string Case insensitive search on userid |
opac_notes | string Case insensitive search on opac_notes |
altaddress_notes | string Case insensitive search on altaddress_notes |
statistics_1 | string Case insensitive search on statistics_1 |
statistics_2 | string Case insensitive search on statistics_2 |
autorenew_checkouts | boolean Search on autorenew_checkouts |
altcontact_firstname | string Case insensitive search on altcontact_firstname |
altcontact_surname | string Case insensitive search on altcontact_surname |
altcontact_address | string Case insensitive search on altcontact_address |
altcontact_address2 | string Case insensitive search on altcontact_address2 |
altcontact_city | string Case insensitive search on altcontact_city |
altcontact_state | string Case insensitive search on altcontact_state |
altcontact_postal_code | string Case insensitive search on altcontact_postal_code |
altcontact_country | string Case insensitive search on altcontact_country |
altcontact_phone | string Case insensitive search on altcontact_phone |
sms_number | string Case insensitive search on sms_number |
sms_provider_id | string Case insensitive search on sms_provider_id |
privacy | string Search on privacy |
privacy_guarantor_checkouts | string Search on privacy_guarantor_checkouts |
check_previous_checkout | string Case insensitive search on check_previous_checkout |
updated_on | string Search on updated_on |
last_seen | string Case insensitive search on last_seen |
lang | string Case insensitive search on lang |
login_attempts | string Search on login_attempts |
protected | boolean Search on protected status |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "extended_attributes" "checkouts+count" "overdues+count" "account_balance" "library" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "patron_id": 0,
- "cardnumber": "string",
- "surname": "string",
- "firstname": "string",
- "middle_name": "string",
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "pronouns": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": "string",
- "phone": "string",
- "mobile": "string",
- "fax": "string",
- "secondary_email": "string",
- "secondary_phone": "string",
- "altaddress_street_number": "string",
- "altaddress_street_type": "string",
- "altaddress_address": "string",
- "altaddress_address2": "string",
- "altaddress_city": "string",
- "altaddress_state": "string",
- "altaddress_postal_code": "string",
- "altaddress_country": "string",
- "altaddress_email": "string",
- "altaddress_phone": "string",
- "date_of_birth": "2019-08-24",
- "library_id": "string",
- "category_id": "string",
- "date_enrolled": "2019-08-24",
- "expiry_date": "2019-08-24",
- "date_renewed": "2019-08-24",
- "incorrect_address": true,
- "patron_card_lost": true,
- "restricted": true,
- "staff_notes": "string",
- "relationship_type": "string",
- "gender": "string",
- "userid": "string",
- "opac_notes": "string",
- "altaddress_notes": "string",
- "statistics_1": "string",
- "statistics_2": "string",
- "autorenew_checkouts": true,
- "altcontact_firstname": "string",
- "altcontact_surname": "string",
- "altcontact_address": "string",
- "altcontact_address2": "string",
- "altcontact_city": "string",
- "altcontact_state": "string",
- "altcontact_postal_code": "string",
- "altcontact_country": "string",
- "altcontact_phone": "string",
- "sms_number": "string",
- "sms_provider_id": 0,
- "privacy": 0,
- "privacy_guarantor_checkouts": 0,
- "privacy_guarantor_fines": true,
- "check_previous_checkout": "string",
- "updated_on": "2019-08-24T14:15:22Z",
- "last_seen": "2019-08-24T14:15:22Z",
- "lang": "string",
- "login_attempts": 0,
- "overdrive_auth_token": "string",
- "anonymized": true,
- "extended_attributes": [
- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
], - "checkouts_count": 0,
- "overdues_count": 0,
- "account_balance": 0,
- "library": { },
- "protected": true,
- "_strings": { }
}
]
x-koha-override | Array of strings Items Enum: "welcome_yes" "welcome_no" Overrides list sent as a request header |
A JSON object containing information about the new patron
patron_id | integer Internal patron identifier | ||||||
cardnumber | string or null library assigned user identifier | ||||||
surname required | string or null patron's last name | ||||||
firstname | string or null patron's first name | ||||||
middle_name | string or null patron's middle name | ||||||
title | string or null patron's title | ||||||
other_name | string or null any other names associated with the patron | ||||||
initials | string or null initials of the patron | ||||||
pronouns | string or null pronouns of the patron | ||||||
street_number | string or null street number of patron's primary address | ||||||
street_type | string or null street type of patron's primary address | ||||||
address | string or null first address line of patron's primary address | ||||||
address2 | string or null second address line of patron's primary address | ||||||
city | string or null city or town of patron's primary address | ||||||
state | string or null state or province of patron's primary address | ||||||
postal_code | string or null zip or postal code of patron's primary address | ||||||
country | string or null country of patron's primary address | ||||||
string or null primary email address for patron's primary address | |||||||
phone | string or null primary phone number for patron's primary address | ||||||
mobile | string or null the other phone number for patron's primary address | ||||||
fax | string or null fax number for patron's primary address | ||||||
secondary_email | string or null secondary email address for patron's primary address | ||||||
secondary_phone | string or null secondary phone number for patron's primary address | ||||||
altaddress_street_number | string or null street number of patron's alternate address | ||||||
altaddress_street_type | string or null street type of patron's alternate address | ||||||
altaddress_address | string or null first address line of patron's alternate address | ||||||
altaddress_address2 | string or null second address line of patron's alternate address | ||||||
altaddress_city | string or null city or town of patron's alternate address | ||||||
altaddress_state | string or null state or province of patron's alternate address | ||||||
altaddress_postal_code | string or null zip or postal code of patron's alternate address | ||||||
altaddress_country | string or null country of patron's alternate address | ||||||
altaddress_email | string or null email address for patron's alternate address | ||||||
altaddress_phone | string or null phone number for patron's alternate address | ||||||
date_of_birth | string or null <date> patron's date of birth | ||||||
library_id required | string Internal identifier for the patron's home library | ||||||
category_id required | string Internal identifier for the patron's category | ||||||
date_enrolled | string or null <date> date the patron was added to Koha | ||||||
expiry_date | string or null <date> date the patron's card is set to expire | ||||||
date_renewed | string or null <date> date the patron's card was last renewed | ||||||
incorrect_address | boolean or null set to 1 if library marked this patron as having an unconfirmed address | ||||||
patron_card_lost | boolean or null set to 1 if library marked this patron as having lost his card | ||||||
staff_notes | string or null a note on the patron's account | ||||||
relationship_type | string or null used for children to include the relationship to their guarantor | ||||||
gender | string or null patron's gender | ||||||
userid | string or null patron's login | ||||||
opac_notes | string or null a note on the patron's account visible in OPAC and staff interface | ||||||
altaddress_notes | string or null a note related to patron's alternate address | ||||||
statistics_1 | string or null a field that can be used for any information unique to the library | ||||||
statistics_2 | string or null a field that can be used for any information unique to the library | ||||||
autorenew_checkouts | boolean indicate whether auto-renewal is allowed for patron | ||||||
altcontact_firstname | string or null first name of alternate contact for the patron | ||||||
altcontact_surname | string or null surname or last name of the alternate contact for the patron | ||||||
altcontact_address | string or null the first address line for the alternate contact for the patron | ||||||
altcontact_address2 | string or null the second address line for the alternate contact for the patron | ||||||
altcontact_city | string or null the city for the alternate contact for the patron | ||||||
altcontact_state | string or null the state for the alternate contact for the patron | ||||||
altcontact_postal_code | string or null the zipcode for the alternate contact for the patron | ||||||
altcontact_country | string or null the country for the alternate contact for the patron | ||||||
altcontact_phone | string or null the phone number for the alternate contact for the patron | ||||||
sms_number | string or null the mobile phone number where the patron would like to receive notices (if SMS turned on) | ||||||
sms_provider_id | integer or null the provider of the mobile phone number defined in smsalertnumber | ||||||
privacy | integer patron's privacy settings related to their checkout history | ||||||
privacy_guarantor_checkouts | integer controls if relatives can see this patron's checkouts | ||||||
privacy_guarantor_fines | boolean controls if relatives can see this patron's fines | ||||||
check_previous_checkout | string produce a warning for this patron if this item has previously been checked out to this patron if 'yes', not if 'no', defer to category setting if 'inherit' | ||||||
updated_on | string <date-time> time of last change could be useful for synchronization with external systems (among others) | ||||||
last_seen | string or null <date-time> last time a patron has been seen (connected at the OPAC or staff interface) | ||||||
lang | string lang to use to send notices to this patron | ||||||
login_attempts | integer or null number of failed login attemps | ||||||
overdrive_auth_token | string or null persist OverDrive auth token | ||||||
Array of objects (patron_extended_attribute) patron's extended attributes | |||||||
Array
| |||||||
checkouts_count | integer or null Number of checkouts | ||||||
overdues_count | integer or null Number of overdued checkouts | ||||||
account_balance | number or null Balance of the patron's account | ||||||
library | object or null Library of the patron | ||||||
protected | boolean Protected status of the patron | ||||||
_strings | object or null A list of stringified coded values |
{- "patron_id": 0,
- "cardnumber": "string",
- "surname": "string",
- "firstname": "string",
- "middle_name": "string",
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "pronouns": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": "string",
- "phone": "string",
- "mobile": "string",
- "fax": "string",
- "secondary_email": "string",
- "secondary_phone": "string",
- "altaddress_street_number": "string",
- "altaddress_street_type": "string",
- "altaddress_address": "string",
- "altaddress_address2": "string",
- "altaddress_city": "string",
- "altaddress_state": "string",
- "altaddress_postal_code": "string",
- "altaddress_country": "string",
- "altaddress_email": "string",
- "altaddress_phone": "string",
- "date_of_birth": "2019-08-24",
- "library_id": "string",
- "category_id": "string",
- "date_enrolled": "2019-08-24",
- "expiry_date": "2019-08-24",
- "date_renewed": "2019-08-24",
- "incorrect_address": true,
- "patron_card_lost": true,
- "staff_notes": "string",
- "relationship_type": "string",
- "gender": "string",
- "userid": "string",
- "opac_notes": "string",
- "altaddress_notes": "string",
- "statistics_1": "string",
- "statistics_2": "string",
- "autorenew_checkouts": true,
- "altcontact_firstname": "string",
- "altcontact_surname": "string",
- "altcontact_address": "string",
- "altcontact_address2": "string",
- "altcontact_city": "string",
- "altcontact_state": "string",
- "altcontact_postal_code": "string",
- "altcontact_country": "string",
- "altcontact_phone": "string",
- "sms_number": "string",
- "sms_provider_id": 0,
- "privacy": 0,
- "privacy_guarantor_checkouts": 0,
- "privacy_guarantor_fines": true,
- "check_previous_checkout": "string",
- "updated_on": "2019-08-24T14:15:22Z",
- "last_seen": "2019-08-24T14:15:22Z",
- "lang": "string",
- "login_attempts": 0,
- "overdrive_auth_token": "string",
- "extended_attributes": [
- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
], - "checkouts_count": 0,
- "overdues_count": 0,
- "account_balance": 0,
- "library": { },
- "protected": true,
- "_strings": { }
}
[- {
- "patron_id": 0,
- "cardnumber": "string",
- "surname": "string",
- "firstname": "string",
- "middle_name": "string",
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "pronouns": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": "string",
- "phone": "string",
- "mobile": "string",
- "fax": "string",
- "secondary_email": "string",
- "secondary_phone": "string",
- "altaddress_street_number": "string",
- "altaddress_street_type": "string",
- "altaddress_address": "string",
- "altaddress_address2": "string",
- "altaddress_city": "string",
- "altaddress_state": "string",
- "altaddress_postal_code": "string",
- "altaddress_country": "string",
- "altaddress_email": "string",
- "altaddress_phone": "string",
- "date_of_birth": "2019-08-24",
- "library_id": "string",
- "category_id": "string",
- "date_enrolled": "2019-08-24",
- "expiry_date": "2019-08-24",
- "date_renewed": "2019-08-24",
- "incorrect_address": true,
- "patron_card_lost": true,
- "restricted": true,
- "staff_notes": "string",
- "relationship_type": "string",
- "gender": "string",
- "userid": "string",
- "opac_notes": "string",
- "altaddress_notes": "string",
- "statistics_1": "string",
- "statistics_2": "string",
- "autorenew_checkouts": true,
- "altcontact_firstname": "string",
- "altcontact_surname": "string",
- "altcontact_address": "string",
- "altcontact_address2": "string",
- "altcontact_city": "string",
- "altcontact_state": "string",
- "altcontact_postal_code": "string",
- "altcontact_country": "string",
- "altcontact_phone": "string",
- "sms_number": "string",
- "sms_provider_id": 0,
- "privacy": 0,
- "privacy_guarantor_checkouts": 0,
- "privacy_guarantor_fines": true,
- "check_previous_checkout": "string",
- "updated_on": "2019-08-24T14:15:22Z",
- "last_seen": "2019-08-24T14:15:22Z",
- "lang": "string",
- "login_attempts": 0,
- "overdrive_auth_token": "string",
- "anonymized": true,
- "extended_attributes": [
- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
], - "checkouts_count": 0,
- "overdues_count": 0,
- "account_balance": 0,
- "library": { },
- "protected": true,
- "_strings": { }
}
]
patron_id required | integer Internal patron identifier |
x-koha-embed | Array of strings Items Enum: "+strings" "extended_attributes" Embed list sent as a request header |
{- "patron_id": 0,
- "cardnumber": "string",
- "surname": "string",
- "firstname": "string",
- "middle_name": "string",
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "pronouns": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": "string",
- "phone": "string",
- "mobile": "string",
- "fax": "string",
- "secondary_email": "string",
- "secondary_phone": "string",
- "altaddress_street_number": "string",
- "altaddress_street_type": "string",
- "altaddress_address": "string",
- "altaddress_address2": "string",
- "altaddress_city": "string",
- "altaddress_state": "string",
- "altaddress_postal_code": "string",
- "altaddress_country": "string",
- "altaddress_email": "string",
- "altaddress_phone": "string",
- "date_of_birth": "2019-08-24",
- "library_id": "string",
- "category_id": "string",
- "date_enrolled": "2019-08-24",
- "expiry_date": "2019-08-24",
- "date_renewed": "2019-08-24",
- "incorrect_address": true,
- "patron_card_lost": true,
- "restricted": true,
- "staff_notes": "string",
- "relationship_type": "string",
- "gender": "string",
- "userid": "string",
- "opac_notes": "string",
- "altaddress_notes": "string",
- "statistics_1": "string",
- "statistics_2": "string",
- "autorenew_checkouts": true,
- "altcontact_firstname": "string",
- "altcontact_surname": "string",
- "altcontact_address": "string",
- "altcontact_address2": "string",
- "altcontact_city": "string",
- "altcontact_state": "string",
- "altcontact_postal_code": "string",
- "altcontact_country": "string",
- "altcontact_phone": "string",
- "sms_number": "string",
- "sms_provider_id": 0,
- "privacy": 0,
- "privacy_guarantor_checkouts": 0,
- "privacy_guarantor_fines": true,
- "check_previous_checkout": "string",
- "updated_on": "2019-08-24T14:15:22Z",
- "last_seen": "2019-08-24T14:15:22Z",
- "lang": "string",
- "login_attempts": 0,
- "overdrive_auth_token": "string",
- "anonymized": true,
- "extended_attributes": [
- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
], - "checkouts_count": 0,
- "overdues_count": 0,
- "account_balance": 0,
- "library": { },
- "protected": true,
- "_strings": { }
}
patron_id required | integer Internal patron identifier |
x-koha-embed | Array of strings Items Value: "extended_attributes" Embed list sent as a request header |
A JSON object containing new information about existing patron
patron_id | integer Internal patron identifier | ||||||
cardnumber | string or null library assigned user identifier | ||||||
surname required | string or null patron's last name | ||||||
firstname | string or null patron's first name | ||||||
middle_name | string or null patron's middle name | ||||||
title | string or null patron's title | ||||||
other_name | string or null any other names associated with the patron | ||||||
initials | string or null initials of the patron | ||||||
pronouns | string or null pronouns of the patron | ||||||
street_number | string or null street number of patron's primary address | ||||||
street_type | string or null street type of patron's primary address | ||||||
address | string or null first address line of patron's primary address | ||||||
address2 | string or null second address line of patron's primary address | ||||||
city | string or null city or town of patron's primary address | ||||||
state | string or null state or province of patron's primary address | ||||||
postal_code | string or null zip or postal code of patron's primary address | ||||||
country | string or null country of patron's primary address | ||||||
string or null primary email address for patron's primary address | |||||||
phone | string or null primary phone number for patron's primary address | ||||||
mobile | string or null the other phone number for patron's primary address | ||||||
fax | string or null fax number for patron's primary address | ||||||
secondary_email | string or null secondary email address for patron's primary address | ||||||
secondary_phone | string or null secondary phone number for patron's primary address | ||||||
altaddress_street_number | string or null street number of patron's alternate address | ||||||
altaddress_street_type | string or null street type of patron's alternate address | ||||||
altaddress_address | string or null first address line of patron's alternate address | ||||||
altaddress_address2 | string or null second address line of patron's alternate address | ||||||
altaddress_city | string or null city or town of patron's alternate address | ||||||
altaddress_state | string or null state or province of patron's alternate address | ||||||
altaddress_postal_code | string or null zip or postal code of patron's alternate address | ||||||
altaddress_country | string or null country of patron's alternate address | ||||||
altaddress_email | string or null email address for patron's alternate address | ||||||
altaddress_phone | string or null phone number for patron's alternate address | ||||||
date_of_birth | string or null <date> patron's date of birth | ||||||
library_id required | string Internal identifier for the patron's home library | ||||||
category_id required | string Internal identifier for the patron's category | ||||||
date_enrolled | string or null <date> date the patron was added to Koha | ||||||
expiry_date | string or null <date> date the patron's card is set to expire | ||||||
date_renewed | string or null <date> date the patron's card was last renewed | ||||||
incorrect_address | boolean or null set to 1 if library marked this patron as having an unconfirmed address | ||||||
patron_card_lost | boolean or null set to 1 if library marked this patron as having lost his card | ||||||
staff_notes | string or null a note on the patron's account | ||||||
relationship_type | string or null used for children to include the relationship to their guarantor | ||||||
gender | string or null patron's gender | ||||||
userid | string or null patron's login | ||||||
opac_notes | string or null a note on the patron's account visible in OPAC and staff interface | ||||||
altaddress_notes | string or null a note related to patron's alternate address | ||||||
statistics_1 | string or null a field that can be used for any information unique to the library | ||||||
statistics_2 | string or null a field that can be used for any information unique to the library | ||||||
autorenew_checkouts | boolean indicate whether auto-renewal is allowed for patron | ||||||
altcontact_firstname | string or null first name of alternate contact for the patron | ||||||
altcontact_surname | string or null surname or last name of the alternate contact for the patron | ||||||
altcontact_address | string or null the first address line for the alternate contact for the patron | ||||||
altcontact_address2 | string or null the second address line for the alternate contact for the patron | ||||||
altcontact_city | string or null the city for the alternate contact for the patron | ||||||
altcontact_state | string or null the state for the alternate contact for the patron | ||||||
altcontact_postal_code | string or null the zipcode for the alternate contact for the patron | ||||||
altcontact_country | string or null the country for the alternate contact for the patron | ||||||
altcontact_phone | string or null the phone number for the alternate contact for the patron | ||||||
sms_number | string or null the mobile phone number where the patron would like to receive notices (if SMS turned on) | ||||||
sms_provider_id | integer or null the provider of the mobile phone number defined in smsalertnumber | ||||||
privacy | integer patron's privacy settings related to their checkout history | ||||||
privacy_guarantor_checkouts | integer controls if relatives can see this patron's checkouts | ||||||
privacy_guarantor_fines | boolean controls if relatives can see this patron's fines | ||||||
check_previous_checkout | string produce a warning for this patron if this item has previously been checked out to this patron if 'yes', not if 'no', defer to category setting if 'inherit' | ||||||
updated_on | string <date-time> time of last change could be useful for synchronization with external systems (among others) | ||||||
last_seen | string or null <date-time> last time a patron has been seen (connected at the OPAC or staff interface) | ||||||
lang | string lang to use to send notices to this patron | ||||||
login_attempts | integer or null number of failed login attemps | ||||||
overdrive_auth_token | string or null persist OverDrive auth token | ||||||
Array of objects (patron_extended_attribute) patron's extended attributes | |||||||
Array
| |||||||
checkouts_count | integer or null Number of checkouts | ||||||
overdues_count | integer or null Number of overdued checkouts | ||||||
account_balance | number or null Balance of the patron's account | ||||||
library | object or null Library of the patron | ||||||
protected | boolean Protected status of the patron | ||||||
_strings | object or null A list of stringified coded values |
{- "patron_id": 0,
- "cardnumber": "string",
- "surname": "string",
- "firstname": "string",
- "middle_name": "string",
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "pronouns": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": "string",
- "phone": "string",
- "mobile": "string",
- "fax": "string",
- "secondary_email": "string",
- "secondary_phone": "string",
- "altaddress_street_number": "string",
- "altaddress_street_type": "string",
- "altaddress_address": "string",
- "altaddress_address2": "string",
- "altaddress_city": "string",
- "altaddress_state": "string",
- "altaddress_postal_code": "string",
- "altaddress_country": "string",
- "altaddress_email": "string",
- "altaddress_phone": "string",
- "date_of_birth": "2019-08-24",
- "library_id": "string",
- "category_id": "string",
- "date_enrolled": "2019-08-24",
- "expiry_date": "2019-08-24",
- "date_renewed": "2019-08-24",
- "incorrect_address": true,
- "patron_card_lost": true,
- "staff_notes": "string",
- "relationship_type": "string",
- "gender": "string",
- "userid": "string",
- "opac_notes": "string",
- "altaddress_notes": "string",
- "statistics_1": "string",
- "statistics_2": "string",
- "autorenew_checkouts": true,
- "altcontact_firstname": "string",
- "altcontact_surname": "string",
- "altcontact_address": "string",
- "altcontact_address2": "string",
- "altcontact_city": "string",
- "altcontact_state": "string",
- "altcontact_postal_code": "string",
- "altcontact_country": "string",
- "altcontact_phone": "string",
- "sms_number": "string",
- "sms_provider_id": 0,
- "privacy": 0,
- "privacy_guarantor_checkouts": 0,
- "privacy_guarantor_fines": true,
- "check_previous_checkout": "string",
- "updated_on": "2019-08-24T14:15:22Z",
- "last_seen": "2019-08-24T14:15:22Z",
- "lang": "string",
- "login_attempts": 0,
- "overdrive_auth_token": "string",
- "extended_attributes": [
- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
], - "checkouts_count": 0,
- "overdues_count": 0,
- "account_balance": 0,
- "library": { },
- "protected": true,
- "_strings": { }
}
[- {
- "patron_id": 0,
- "cardnumber": "string",
- "surname": "string",
- "firstname": "string",
- "middle_name": "string",
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "pronouns": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": "string",
- "phone": "string",
- "mobile": "string",
- "fax": "string",
- "secondary_email": "string",
- "secondary_phone": "string",
- "altaddress_street_number": "string",
- "altaddress_street_type": "string",
- "altaddress_address": "string",
- "altaddress_address2": "string",
- "altaddress_city": "string",
- "altaddress_state": "string",
- "altaddress_postal_code": "string",
- "altaddress_country": "string",
- "altaddress_email": "string",
- "altaddress_phone": "string",
- "date_of_birth": "2019-08-24",
- "library_id": "string",
- "category_id": "string",
- "date_enrolled": "2019-08-24",
- "expiry_date": "2019-08-24",
- "date_renewed": "2019-08-24",
- "incorrect_address": true,
- "patron_card_lost": true,
- "restricted": true,
- "staff_notes": "string",
- "relationship_type": "string",
- "gender": "string",
- "userid": "string",
- "opac_notes": "string",
- "altaddress_notes": "string",
- "statistics_1": "string",
- "statistics_2": "string",
- "autorenew_checkouts": true,
- "altcontact_firstname": "string",
- "altcontact_surname": "string",
- "altcontact_address": "string",
- "altcontact_address2": "string",
- "altcontact_city": "string",
- "altcontact_state": "string",
- "altcontact_postal_code": "string",
- "altcontact_country": "string",
- "altcontact_phone": "string",
- "sms_number": "string",
- "sms_provider_id": 0,
- "privacy": 0,
- "privacy_guarantor_checkouts": 0,
- "privacy_guarantor_fines": true,
- "check_previous_checkout": "string",
- "updated_on": "2019-08-24T14:15:22Z",
- "last_seen": "2019-08-24T14:15:22Z",
- "lang": "string",
- "login_attempts": 0,
- "overdrive_auth_token": "string",
- "anonymized": true,
- "extended_attributes": [
- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
], - "checkouts_count": 0,
- "overdues_count": 0,
- "account_balance": 0,
- "library": { },
- "protected": true,
- "_strings": { }
}
]
patron_id required | integer Internal patron identifier |
{- "balance": 0,
- "outstanding_credits": {
- "total": 0,
- "lines": [
- {
- "account_line_id": 0,
- "amount": 0,
- "amount_outstanding": 0,
- "cash_register_id": 0,
- "checkout_id": 0,
- "credit_number": "string",
- "credit_type": "string",
- "date": "2019-08-24T14:15:22Z",
- "debit_type": "string",
- "description": "string",
- "interface": "string",
- "internal_note": "string",
- "item_id": 0,
- "library_id": "string",
- "patron_id": 0,
- "payment_type": "string",
- "payout_type": "string",
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "user_id": 0
}
]
}, - "outstanding_debits": {
- "total": 0,
- "lines": [
- {
- "account_line_id": 0,
- "amount": 0,
- "amount_outstanding": 0,
- "cash_register_id": 0,
- "checkout_id": 0,
- "credit_number": "string",
- "credit_type": "string",
- "date": "2019-08-24T14:15:22Z",
- "debit_type": "string",
- "description": "string",
- "interface": "string",
- "internal_note": "string",
- "item_id": 0,
- "library_id": "string",
- "patron_id": 0,
- "payment_type": "string",
- "payout_type": "string",
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "user_id": 0
}
]
}
}
patron_id required | integer Internal patron identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
Query filter sent through request"s body
{ }
[- {
- "account_line_id": 0,
- "amount": 0,
- "amount_outstanding": 0,
- "cash_register_id": 0,
- "credit_number": "string",
- "date": "2019-08-24T14:15:22Z",
- "description": "string",
- "interface": "string",
- "internal_note": "string",
- "library_id": "string",
- "patron_id": 0,
- "payment_type": "string",
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "type": "string",
- "user_id": 0
}
]
patron_id required | integer Internal patron identifier |
A JSON object containing credit information
credit_type | string Type of credit ('CREDIT', 'FORGIVEN', 'LOST_FOUND', 'PAYMENT', 'WRITEOFF', 'PROCESSING_FOUND' ) |
amount required | number >= 0 Credit amount |
library_id | string or null Internal identifier for the library in which the transaction took place |
account_lines_ids | Array of integers List of account line ids the credit goes against (optional) |
payment_type | string Payment type (only applies when credit_type=payment) |
date | string <date> Date the credit was recorded (optional) |
description | string Description |
note | string Internal note |
{- "credit_type": "string",
- "amount": 0,
- "library_id": "string",
- "account_lines_ids": [
- 0
], - "payment_type": "string",
- "date": "2019-08-24",
- "description": "string",
- "note": "string"
}
{- "account_line_id": 0,
- "amount": 0,
- "amount_outstanding": 0,
- "cash_register_id": 0,
- "checkout_id": 0,
- "credit_number": "string",
- "credit_type": "string",
- "date": "2019-08-24T14:15:22Z",
- "debit_type": "string",
- "description": "string",
- "interface": "string",
- "internal_note": "string",
- "item_id": 0,
- "library_id": "string",
- "patron_id": 0,
- "payment_type": "string",
- "payout_type": "string",
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "user_id": 0
}
patron_id required | integer Internal patron identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
Query filter sent through request"s body
{ }
[- {
- "account_line_id": 0,
- "amount": 0,
- "amount_outstanding": 0,
- "cash_register_id": 0,
- "checkout_id": 0,
- "date": "2019-08-24T14:15:22Z",
- "description": "string",
- "interface": "string",
- "internal_note": "string",
- "item_id": 0,
- "library_id": "string",
- "patron_id": 0,
- "payout_type": "string",
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "type": "string",
- "user_id": 0
}
]
patron_id required | integer Internal patron identifier |
A JSON object containing debit information
amount required | number >= 0 Debit amount |
amount_outstanding | number Outstanding amount |
cash_register_id | integer or null Internal identifier for the cash register used for the payout (if any) |
checkout_id | integer or null Internal identifier for the checkout the account line is related to |
date | string <date-time> Date the account line was created |
description | string or null Account line description |
interface | string or null Interface in which the account line was generated (values can be: api, cron, commandline, intranet, opac and sip) |
internal_note | string or null Internal note |
item_id | integer or null Internal identifier for the item the account line is related to |
library_id | string or null Internal identifier for the library in which the transaction took place |
patron_id | integer Internal identifier for the patron the account line belongs to |
payout_type | string or null Payout type |
status | string or null The debit status |
timestamp | string <date-time> Timestamp for the latest line update |
type | string or null Account debit type |
user_id | integer or null Internal patron identifier for the staff member that introduced the account line |
{- "amount": 0,
- "amount_outstanding": 0,
- "cash_register_id": 0,
- "checkout_id": 0,
- "date": "2019-08-24T14:15:22Z",
- "description": "string",
- "interface": "string",
- "internal_note": "string",
- "item_id": 0,
- "library_id": "string",
- "patron_id": 0,
- "payout_type": "string",
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "type": "string",
- "user_id": 0
}
{- "account_line_id": 0,
- "amount": 0,
- "amount_outstanding": 0,
- "cash_register_id": 0,
- "checkout_id": 0,
- "date": "2019-08-24T14:15:22Z",
- "description": "string",
- "interface": "string",
- "internal_note": "string",
- "item_id": 0,
- "library_id": "string",
- "patron_id": 0,
- "payout_type": "string",
- "status": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "type": "string",
- "user_id": 0
}
patron_id required | integer Internal patron identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
]
patron_id required | integer Internal patron identifier |
A JSON representation of the patron extended attribute
extended_attribute_id | integer Internal ID for the extended attribute |
type required | string Extended attribute type |
value required | string or null Extended attribute value |
{- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
{- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
patron_id required | integer Internal patron identifier |
A JSON representation of the patron extended attribute
extended_attribute_id | integer Internal ID for the extended attribute |
type required | string Extended attribute type |
value required | string or null Extended attribute value |
[- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
]
[- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
]
patron_id required | integer Internal patron identifier |
extended_attribute_id required | integer Internal patron extended attribute identifier |
An object containing the updated values for the patron extended attribute
value | string Extended attribute value |
{- "value": "string"
}
{- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
patron_id required | integer Internal patron identifier |
extended_attribute_id required | integer Internal patron extended attribute identifier |
{- "error": "string",
- "error_code": "string"
}
patron_id required | integer Internal patron identifier |
A JSON object containing password information
password required | string New password (plain text) |
password_2 required | string Repeated new password (plain text) |
{- "password": "string",
- "password_2": "string"
}
{- "error": "string",
- "error_code": "string"
}
patron_id required | integer Internal patron identifier |
A JSON object containing password expiration date
expiration_date required | string <date> Date to expire password |
{- "expiration_date": "2019-08-24"
}
{- "error": "string",
- "error_code": "string"
}
patron_id required | integer Internal patron identifier |
confirmation | string A JWT confirmation token |
A JSON object containing information about the new checkout
checkout_id | integer internally assigned checkout identifier |
patron_id | integer Internal patron identifier |
item_id | integer or null internal identifier of checked out item |
due_date | string <date-time> Due date |
library_id | string or null code of the library the item was checked out |
issuer_id | integer or null internally assigned for the user that processed the checkout |
checkin_date | string or null <date-time> Date the item was returned |
last_renewed_date | string or null <date-time> Date the item was last renewed |
renewals_count | integer or null Number of renewals |
unseen_renewals | integer or null Number of consecutive unseen renewals |
auto_renew | boolean Auto renewal |
auto_renew_error | string or null Auto renewal error |
timestamp | string Last update time |
checkout_date | string <date-time> Date the item was issued |
onsite_checkout | boolean On site checkout |
note | string or null Issue note text |
note_date | string or null <date> Datetime of the issue note |
note_seen | boolean or null has the note been seen already |
issuer | object or null The object representing the checkout issuer |
item | object or null The object representing the checked out item |
library | object or null The object representing the checkout library |
patron | object or null The object representing the checkout patron |
{- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
{- "checkout_id": 0,
- "patron_id": 0,
- "item_id": 0,
- "due_date": "2019-08-24T14:15:22Z",
- "library_id": "string",
- "issuer_id": 0,
- "checkin_date": "2019-08-24T14:15:22Z",
- "last_renewed_date": "2019-08-24T14:15:22Z",
- "renewals_count": 0,
- "unseen_renewals": 0,
- "auto_renew": true,
- "auto_renew_error": "string",
- "timestamp": "string",
- "checkout_date": "2019-08-24T14:15:22Z",
- "onsite_checkout": true,
- "note": "string",
- "note_date": "2019-08-24",
- "note_seen": true,
- "issuer": { },
- "item": { },
- "library": { },
- "patron": { }
}
patron_id required | integer Internal patron identifier |
A boolean representing if guarantors should be able to see the patron's charges
allowed | boolean |
{- "allowed": true
}
{- "error": "string",
- "error_code": "string"
}
patron_id required | integer Internal patron identifier |
A boolean representing if guarantors should be able to see the patron's checkouts
allowed | boolean |
{- "allowed": true
}
{- "error": "string",
- "error_code": "string"
}
patron_id required | integer Internal patron identifier |
hold_id required | integer Internal hold identifier |
{- "error": "string",
- "error_code": "string"
}
patron_id required | integer Internal patron identifier |
A JSON object containing password information
password required | string New password (plain text) |
password_repeated required | string Repeated new password (plain text) |
old_password required | string Patron's original password |
{- "password": "string",
- "password_repeated": "string",
- "old_password": "string"
}
{- "error": "string",
- "error_code": "string"
}
This resource returns a list of options needed for the Preservation Vue app. EXPERIMENTAL - DO NOT RELY on this, it is subject to change!
{- "settings": { },
- "permissions": { }
}
train_id | integer Case insensitive search on train id |
name | string Case insensitive search on train name |
description | string Case insensitive search on train description |
not_for_loan | string Case insensitive search on not for loan value |
created_on | string Case insensitive search on train creation date |
closed_on | string Case insensitive search on train closing date |
sent_on | string Case insensitive search on train sent date |
received_on | string Case insensitive search on train receiving date |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
Query filter sent through request"s body
{ }
[- {
- "train_id": 0,
- "name": "string",
- "description": "string",
- "default_processing_id": 0,
- "not_for_loan": "string",
- "created_on": "string",
- "closed_on": "string",
- "sent_on": "string",
- "received_on": "string",
- "default_processing": { }
}
]
A JSON object containing information about the new train
name required | string name of the train |
description | string or null description of the train |
default_processing_id | integer or null foreign key to preservation_processings |
not_for_loan | string or null NOT_LOAN authorised value to apply to item added to this train |
created_on | string or null creation date |
closed_on | string or null closing date |
sent_on | string or null sending date |
received_on | string or null receiving date |
default_processing | object or null the default processing |
{- "name": "string",
- "description": "string",
- "default_processing_id": 0,
- "not_for_loan": "string",
- "created_on": "string",
- "closed_on": "string",
- "sent_on": "string",
- "received_on": "string",
- "default_processing": { }
}
[- {
- "train_id": 0,
- "name": "string",
- "description": "string",
- "default_processing_id": 0,
- "not_for_loan": "string",
- "created_on": "string",
- "closed_on": "string",
- "sent_on": "string",
- "received_on": "string",
- "default_processing": { }
}
]
train_id required | integer train internal identifier |
x-koha-embed | Array of strings Items Enum: "items" "items.attributes" "items.attributes+strings" "items.attributes.processing_attribute" "items.processing" "default_processing" "default_processing.attributes" Embed list sent as a request header |
[- {
- "train_id": 0,
- "name": "string",
- "description": "string",
- "default_processing_id": 0,
- "not_for_loan": "string",
- "created_on": "string",
- "closed_on": "string",
- "sent_on": "string",
- "received_on": "string",
- "default_processing": { }
}
]
train_id required | integer train internal identifier |
A JSON object containing new information about existing train
name required | string name of the train |
description | string or null description of the train |
default_processing_id | integer or null foreign key to preservation_processings |
not_for_loan | string or null NOT_LOAN authorised value to apply to item added to this train |
created_on | string or null creation date |
closed_on | string or null closing date |
sent_on | string or null sending date |
received_on | string or null receiving date |
default_processing | object or null the default processing |
{- "name": "string",
- "description": "string",
- "default_processing_id": 0,
- "not_for_loan": "string",
- "created_on": "string",
- "closed_on": "string",
- "sent_on": "string",
- "received_on": "string",
- "default_processing": { }
}
[- {
- "train_id": 0,
- "name": "string",
- "description": "string",
- "default_processing_id": 0,
- "not_for_loan": "string",
- "created_on": "string",
- "closed_on": "string",
- "sent_on": "string",
- "received_on": "string",
- "default_processing": { }
}
]
train_id required | integer train internal identifier |
An item
train_id | integer internally train identifier |
item_id | integer internally item identifier |
user_train_item_id | integer internally user train item identifier |
processing_id | integer internally processing identifier |
added_on | string or null add date |
attributes | Array of any or null attribute list |
catalogue_item | object or null catalogue item |
{- "train_id": 0,
- "item_id": 0,
- "user_train_item_id": 0,
- "processing_id": 0,
- "added_on": "string",
- "attributes": [
- null
], - "catalogue_item": { }
}
{- "train_item_id": 0,
- "train_id": 0,
- "item_id": 0,
- "user_train_item_id": 0,
- "processing_id": 0,
- "added_on": "string",
- "attributes": [
- null
], - "catalogue_item": { }
}
train_id required | integer train internal identifier |
A list of items
[- { }
]
[- { }
]
train_id required | integer train internal identifier |
train_item_id required | integer train item internal identifier |
x-koha-embed | Array of strings Items Value: "attributes" Embed list sent as a request header |
An item
train_id | integer internally train identifier |
item_id | integer internally item identifier |
user_train_item_id | integer internally user train item identifier |
processing_id | integer internally processing identifier |
added_on | string or null add date |
attributes | Array of any or null attribute list |
catalogue_item | object or null catalogue item |
{- "train_id": 0,
- "item_id": 0,
- "user_train_item_id": 0,
- "processing_id": 0,
- "added_on": "string",
- "attributes": [
- null
], - "catalogue_item": { }
}
{- "train_item_id": 0,
- "train_id": 0,
- "item_id": 0,
- "user_train_item_id": 0,
- "processing_id": 0,
- "added_on": "string",
- "attributes": [
- null
], - "catalogue_item": { }
}
train_id required | integer train internal identifier |
train_item_id required | integer train item internal identifier |
{- "error": "string",
- "error_code": "string"
}
train_id required | integer train internal identifier |
train_item_id required | integer train item internal identifier |
x-koha-embed | Array of strings Items Enum: "attributes" "catalogue_item" "catalogue_item.biblio" Embed list sent as a request header |
{- "train_item_id": 0,
- "train_id": 0,
- "item_id": 0,
- "user_train_item_id": 0,
- "processing_id": 0,
- "added_on": "string",
- "attributes": [
- null
], - "catalogue_item": { }
}
train_id required | integer train internal identifier |
train_item_id required | integer train item internal identifier |
The train_id of the new train
train_id | integer Train id |
{- "train_id": 0
}
{- "train_item_id": 0,
- "train_id": 0,
- "item_id": 0,
- "user_train_item_id": 0,
- "processing_id": 0,
- "added_on": "string",
- "attributes": [
- null
], - "catalogue_item": { }
}
processing_id | integer Case insensitive search on processing id |
name | string Case insensitive search on processing name |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
Query filter sent through request"s body
{ }
[- {
- "processing_id": 0,
- "name": "string",
- "letter_code": "string",
- "attributes": [
- {
- "processing_attribute_id": 0,
- "processing_id": 0,
- "name": "string",
- "type": "string",
- "option_source": "string"
}
]
}
]
A JSON object containing information about the new processing
name required | string name of the processing | ||||||||||
letter_code | string or null Letter code of the letter to use for printing slips | ||||||||||
Array of objects (preservation_processing_attribute) attributes of the processing | |||||||||||
Array
|
{- "name": "string",
- "letter_code": "string",
- "attributes": [
- {
- "processing_attribute_id": 0,
- "processing_id": 0,
- "name": "string",
- "type": "string",
- "option_source": "string"
}
]
}
[- {
- "processing_id": 0,
- "name": "string",
- "letter_code": "string",
- "attributes": [
- {
- "processing_attribute_id": 0,
- "processing_id": 0,
- "name": "string",
- "type": "string",
- "option_source": "string"
}
]
}
]
processing_id required | integer processing internal identifier |
x-koha-embed | Array of strings Items Value: "attributes" Embed list sent as a request header |
[- {
- "processing_id": 0,
- "name": "string",
- "letter_code": "string",
- "attributes": [
- {
- "processing_attribute_id": 0,
- "processing_id": 0,
- "name": "string",
- "type": "string",
- "option_source": "string"
}
]
}
]
processing_id required | integer processing internal identifier |
A JSON object containing new information about existing processing
name required | string name of the processing | ||||||||||
letter_code | string or null Letter code of the letter to use for printing slips | ||||||||||
Array of objects (preservation_processing_attribute) attributes of the processing | |||||||||||
Array
|
{- "name": "string",
- "letter_code": "string",
- "attributes": [
- {
- "processing_attribute_id": 0,
- "processing_id": 0,
- "name": "string",
- "type": "string",
- "option_source": "string"
}
]
}
[- {
- "processing_id": 0,
- "name": "string",
- "letter_code": "string",
- "attributes": [
- {
- "processing_attribute_id": 0,
- "processing_id": 0,
- "name": "string",
- "type": "string",
- "option_source": "string"
}
]
}
]
external_id | string Search on the item's barcode |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "biblio" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "bookable": true,
- "home_library_id": "string",
- "purchase_price": 0,
- "replacement_price": 0,
- "replacement_price_date": "2019-08-24",
- "last_checkout_date": "2019-08-24",
- "last_seen_date": "2019-08-24T14:15:22Z",
- "not_for_loan_status": 0,
- "effective_not_for_loan_status": 0,
- "damaged_status": 0,
- "damaged_date": "string",
- "lost_status": 0,
- "lost_date": "2019-08-24T14:15:22Z",
- "withdrawn": 0,
- "withdrawn_date": "2019-08-24T14:15:22Z",
- "callnumber": "string",
- "coded_location_qualifier": "string",
- "checkouts_count": 0,
- "renewals_count": 0,
- "localuse": 0,
- "holds_count": 0,
- "restricted_status": 0,
- "public_notes": "string",
- "internal_notes": "string",
- "holding_library_id": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "permanent_location": "string",
- "checked_out_date": "2019-08-24",
- "call_number_source": "string",
- "call_number_sort": "string",
- "collection_code": "string",
- "materials_notes": "string",
- "uri": "string",
- "item_type_id": "string",
- "effective_item_type_id": "string",
- "extended_subfields": "string",
- "serial_issue_number": "string",
- "copy_number": "string",
- "inventory_number": "string",
- "new_status": "string",
- "exclude_from_local_holds_priority": true,
- "return_claims": [
- null
], - "return_claim": { },
- "home_library": { },
- "holding_library": { },
- "cover_image_ids": [
- null
], - "item_group_item": { },
- "serial_item": { },
- "biblio": { },
- "checkout": { },
- "transfer": { },
- "first_hold": { },
- "recall": { },
- "item_type": { },
- "in_bundle": true,
- "bundle_host": { },
- "bundle_items_lost_count": 0,
- "bundle_items_not_lost_count": 0,
- "course_item": { },
- "analytics_count": 0,
- "_strings": { }
}
]
A list of itemnumbers or barcodes
[- { }
]
[- { }
]
This resource returns a list of purchase suggestions
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "suggestion_id": 0,
- "suggested_by": 0,
- "suggestion_date": "2019-08-24",
- "managed_by": 0,
- "managed_date": "2019-08-24",
- "accepted_by": 0,
- "accepted_date": "2019-08-24",
- "rejected_by": 0,
- "rejected_date": "2019-08-24",
- "last_status_change_by": 0,
- "last_status_change_date": "2019-08-24",
- "status": "string",
- "note": "string",
- "staff_note": "string",
- "author": "string",
- "title": "string",
- "copyright_date": 0,
- "publisher_code": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "volume_desc": "string",
- "publication_year": "string",
- "publication_place": "string",
- "isbn": "string",
- "biblio_id": 0,
- "reason": "string",
- "patron_reason": "string",
- "budget_id": 0,
- "library_id": "string",
- "collection_title": "string",
- "item_type": "string",
- "quantity": "string",
- "currency": "string",
- "item_price": 0,
- "total_price": "string",
- "archived": true
}
]
This resource accepts a new purchase suggestion and creates it
x-koha-override | Array of strings Items Enum: "any" "max_total" "max_pending" Overrides list sent as a request header |
A JSON object containing informations about the new suggestion
suggested_by | integer or null patron_id for the person making the suggestion, foreign key linking to the borrowers table |
suggestion_date | string <date> the suggestion was submitted |
managed_by | integer or null patron_id for the librarian managing the suggestion, foreign key linking to the borrowers table |
managed_date | string or null <date> date the suggestion was updated |
accepted_by | integer or null patron_id for the librarian who accepted the suggestion, foreign key linking to the borrowers table |
accepted_date | string or null <date> date the suggestion was marked as accepted |
rejected_by | integer or null patron_id for the librarian who rejected the suggestion, foreign key linking to the borrowers table |
rejected_date | string or null <date> date the suggestion was marked as rejected |
last_status_change_by | integer or null patron the suggestion was last modified by |
last_status_change_date | string or null <date> date the suggestion was last modified |
status | string Suggestion status. Possible values are:
|
note | string or null note entered on the suggestion |
staff_note | string or null non-public note entered on the suggestion |
author | string or null author of the suggested item |
title | string or null title of the suggested item |
copyright_date | integer or null copyright date of the suggested item |
publisher_code | string or null publisher of the suggested item |
timestamp | string or null <date-time> timestamp of date created |
volume_desc | string or null volume description |
publication_year | string or null year of publication |
publication_place | string or null publication place of the suggested item |
isbn | string or null isbn of the suggested item |
biblio_id | integer or null foreign key linking the suggestion to the biblio table after the suggestion has been ordered |
reason | string or null reason for accepting or rejecting the suggestion |
patron_reason | string or null reason for making the suggestion |
budget_id | integer or null foreign key linking the suggested budget to the aqbudgets table |
library_id | string or null foreign key linking the suggested branch to the branches table |
collection_title | string or null collection name for the suggested item |
item_type | string or null suggested item type |
quantity | string or null suggested quantity to be purchased |
currency | string or null suggested currency for the suggested price |
item_price | number or null suggested price |
total_price | string or null suggested total cost (price*quantity updated for currency) |
archived | boolean or null archived (processed) suggestion |
{- "suggested_by": 0,
- "suggestion_date": "2019-08-24",
- "managed_by": 0,
- "managed_date": "2019-08-24",
- "accepted_by": 0,
- "accepted_date": "2019-08-24",
- "rejected_by": 0,
- "rejected_date": "2019-08-24",
- "last_status_change_by": 0,
- "last_status_change_date": "2019-08-24",
- "status": "string",
- "note": "string",
- "staff_note": "string",
- "author": "string",
- "title": "string",
- "copyright_date": 0,
- "publisher_code": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "volume_desc": "string",
- "publication_year": "string",
- "publication_place": "string",
- "isbn": "string",
- "biblio_id": 0,
- "reason": "string",
- "patron_reason": "string",
- "budget_id": 0,
- "library_id": "string",
- "collection_title": "string",
- "item_type": "string",
- "quantity": "string",
- "currency": "string",
- "item_price": 0,
- "total_price": "string",
- "archived": true
}
{- "suggestion_id": 0,
- "suggested_by": 0,
- "suggestion_date": "2019-08-24",
- "managed_by": 0,
- "managed_date": "2019-08-24",
- "accepted_by": 0,
- "accepted_date": "2019-08-24",
- "rejected_by": 0,
- "rejected_date": "2019-08-24",
- "last_status_change_by": 0,
- "last_status_change_date": "2019-08-24",
- "status": "string",
- "note": "string",
- "staff_note": "string",
- "author": "string",
- "title": "string",
- "copyright_date": 0,
- "publisher_code": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "volume_desc": "string",
- "publication_year": "string",
- "publication_place": "string",
- "isbn": "string",
- "biblio_id": 0,
- "reason": "string",
- "patron_reason": "string",
- "budget_id": 0,
- "library_id": "string",
- "collection_title": "string",
- "item_type": "string",
- "quantity": "string",
- "currency": "string",
- "item_price": 0,
- "total_price": "string",
- "archived": true
}
This resource gives access to a specific purchase suggestion
suggestion_id required | integer Internal suggestion identifier |
{- "suggestion_id": 0,
- "suggested_by": 0,
- "suggestion_date": "2019-08-24",
- "managed_by": 0,
- "managed_date": "2019-08-24",
- "accepted_by": 0,
- "accepted_date": "2019-08-24",
- "rejected_by": 0,
- "rejected_date": "2019-08-24",
- "last_status_change_by": 0,
- "last_status_change_date": "2019-08-24",
- "status": "string",
- "note": "string",
- "staff_note": "string",
- "author": "string",
- "title": "string",
- "copyright_date": 0,
- "publisher_code": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "volume_desc": "string",
- "publication_year": "string",
- "publication_place": "string",
- "isbn": "string",
- "biblio_id": 0,
- "reason": "string",
- "patron_reason": "string",
- "budget_id": 0,
- "library_id": "string",
- "collection_title": "string",
- "item_type": "string",
- "quantity": "string",
- "currency": "string",
- "item_price": 0,
- "total_price": "string",
- "archived": true
}
This resource allows updating an existing purchase suggestion
suggestion_id required | integer Internal suggestion identifier |
A JSON object containing informations about the new hold
suggested_by | integer or null patron_id for the person making the suggestion, foreign key linking to the borrowers table |
suggestion_date | string <date> the suggestion was submitted |
managed_by | integer or null patron_id for the librarian managing the suggestion, foreign key linking to the borrowers table |
managed_date | string or null <date> date the suggestion was updated |
accepted_by | integer or null patron_id for the librarian who accepted the suggestion, foreign key linking to the borrowers table |
accepted_date | string or null <date> date the suggestion was marked as accepted |
rejected_by | integer or null patron_id for the librarian who rejected the suggestion, foreign key linking to the borrowers table |
rejected_date | string or null <date> date the suggestion was marked as rejected |
last_status_change_by | integer or null patron the suggestion was last modified by |
last_status_change_date | string or null <date> date the suggestion was last modified |
status | string Suggestion status. Possible values are:
|
note | string or null note entered on the suggestion |
staff_note | string or null non-public note entered on the suggestion |
author | string or null author of the suggested item |
title | string or null title of the suggested item |
copyright_date | integer or null copyright date of the suggested item |
publisher_code | string or null publisher of the suggested item |
timestamp | string or null <date-time> timestamp of date created |
volume_desc | string or null volume description |
publication_year | string or null year of publication |
publication_place | string or null publication place of the suggested item |
isbn | string or null isbn of the suggested item |
biblio_id | integer or null foreign key linking the suggestion to the biblio table after the suggestion has been ordered |
reason | string or null reason for accepting or rejecting the suggestion |
patron_reason | string or null reason for making the suggestion |
budget_id | integer or null foreign key linking the suggested budget to the aqbudgets table |
library_id | string or null foreign key linking the suggested branch to the branches table |
collection_title | string or null collection name for the suggested item |
item_type | string or null suggested item type |
quantity | string or null suggested quantity to be purchased |
currency | string or null suggested currency for the suggested price |
item_price | number or null suggested price |
total_price | string or null suggested total cost (price*quantity updated for currency) |
archived | boolean or null archived (processed) suggestion |
{- "suggested_by": 0,
- "suggestion_date": "2019-08-24",
- "managed_by": 0,
- "managed_date": "2019-08-24",
- "accepted_by": 0,
- "accepted_date": "2019-08-24",
- "rejected_by": 0,
- "rejected_date": "2019-08-24",
- "last_status_change_by": 0,
- "last_status_change_date": "2019-08-24",
- "status": "string",
- "note": "string",
- "staff_note": "string",
- "author": "string",
- "title": "string",
- "copyright_date": 0,
- "publisher_code": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "volume_desc": "string",
- "publication_year": "string",
- "publication_place": "string",
- "isbn": "string",
- "biblio_id": 0,
- "reason": "string",
- "patron_reason": "string",
- "budget_id": 0,
- "library_id": "string",
- "collection_title": "string",
- "item_type": "string",
- "quantity": "string",
- "currency": "string",
- "item_price": 0,
- "total_price": "string",
- "archived": true
}
{- "suggestion_id": 0,
- "suggested_by": 0,
- "suggestion_date": "2019-08-24",
- "managed_by": 0,
- "managed_date": "2019-08-24",
- "accepted_by": 0,
- "accepted_date": "2019-08-24",
- "rejected_by": 0,
- "rejected_date": "2019-08-24",
- "last_status_change_by": 0,
- "last_status_change_date": "2019-08-24",
- "status": "string",
- "note": "string",
- "staff_note": "string",
- "author": "string",
- "title": "string",
- "copyright_date": 0,
- "publisher_code": "string",
- "timestamp": "2019-08-24T14:15:22Z",
- "volume_desc": "string",
- "publication_year": "string",
- "publication_place": "string",
- "isbn": "string",
- "biblio_id": 0,
- "reason": "string",
- "patron_reason": "string",
- "budget_id": 0,
- "library_id": "string",
- "collection_title": "string",
- "item_type": "string",
- "quantity": "string",
- "currency": "string",
- "item_price": 0,
- "total_price": "string",
- "archived": true
}
This resource deletes an existing purchase suggestion
suggestion_id required | integer Internal suggestion identifier |
"string"
This resource returns a list of patron allowed to be a manager for suggestions
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "extended_attributes" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "patron_id": 0,
- "cardnumber": "string",
- "surname": "string",
- "firstname": "string",
- "middle_name": "string",
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "pronouns": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": "string",
- "phone": "string",
- "mobile": "string",
- "fax": "string",
- "secondary_email": "string",
- "secondary_phone": "string",
- "altaddress_street_number": "string",
- "altaddress_street_type": "string",
- "altaddress_address": "string",
- "altaddress_address2": "string",
- "altaddress_city": "string",
- "altaddress_state": "string",
- "altaddress_postal_code": "string",
- "altaddress_country": "string",
- "altaddress_email": "string",
- "altaddress_phone": "string",
- "date_of_birth": "2019-08-24",
- "library_id": "string",
- "category_id": "string",
- "date_enrolled": "2019-08-24",
- "expiry_date": "2019-08-24",
- "date_renewed": "2019-08-24",
- "incorrect_address": true,
- "patron_card_lost": true,
- "restricted": true,
- "staff_notes": "string",
- "relationship_type": "string",
- "gender": "string",
- "userid": "string",
- "opac_notes": "string",
- "altaddress_notes": "string",
- "statistics_1": "string",
- "statistics_2": "string",
- "autorenew_checkouts": true,
- "altcontact_firstname": "string",
- "altcontact_surname": "string",
- "altcontact_address": "string",
- "altcontact_address2": "string",
- "altcontact_city": "string",
- "altcontact_state": "string",
- "altcontact_postal_code": "string",
- "altcontact_country": "string",
- "altcontact_phone": "string",
- "sms_number": "string",
- "sms_provider_id": 0,
- "privacy": 0,
- "privacy_guarantor_checkouts": 0,
- "privacy_guarantor_fines": true,
- "check_previous_checkout": "string",
- "updated_on": "2019-08-24T14:15:22Z",
- "last_seen": "2019-08-24T14:15:22Z",
- "lang": "string",
- "login_attempts": 0,
- "overdrive_auth_token": "string",
- "anonymized": true,
- "extended_attributes": [
- {
- "extended_attribute_id": 0,
- "type": "string",
- "value": "string"
}
], - "checkouts_count": 0,
- "overdues_count": 0,
- "account_balance": 0,
- "library": { },
- "protected": true,
- "_strings": { }
}
]
quote_id | string Case insensitive search on quote id |
source | string Case insensitive search on source |
text | string Case insensitive search on text |
displayed_on | string Case Insensative search on last displayed date |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "quote_id": 0,
- "source": "string",
- "text": "string",
- "displayed_on": "string"
}
]
A JSON object containing informations about the new quote
quote_id | integer internally assigned quote identifier |
source required | string source of the quote |
text required | string or null text |
displayed_on | string or null Last display date |
{- "quote_id": 0,
- "source": "string",
- "text": "string",
- "displayed_on": "string"
}
{- "quote_id": 0,
- "source": "string",
- "text": "string",
- "displayed_on": "string"
}
quote_id required | integer Quote internal identifier |
a quote object
quote_id | integer internally assigned quote identifier |
source required | string source of the quote |
text required | string or null text |
displayed_on | string or null Last display date |
{- "quote_id": 0,
- "source": "string",
- "text": "string",
- "displayed_on": "string"
}
{- "quote_id": 0,
- "source": "string",
- "text": "string",
- "displayed_on": "string"
}
patron_id required | integer Internal patron identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "recall_id": 0,
- "patron_id": 0,
- "created_date": "2019-08-24T14:15:22Z",
- "biblio_id": 0,
- "pickup_library_id": "string",
- "completed_date": "2019-08-24T14:15:22Z",
- "notes": "string",
- "priority": 0,
- "status": "requested",
- "timestamp": "2019-08-24T14:15:22Z",
- "item_id": 0,
- "waiting_date": "2019-08-24T14:15:22Z",
- "expiration_date": "2019-08-24T14:15:22Z",
- "completed": true,
- "item_level": true
}
]
A JSON object containing fields to modify
item_id | integer Internal item id to claim as returned |
notes | string Notes about this return claim |
created_by | string User id for the librarian submitting this claim |
charge_lost_fee | boolean Charge a lost fee if true and Koha is set to allow a choice. Ignored otherwise. |
{- "item_id": 0,
- "notes": "string",
- "created_by": "string",
- "charge_lost_fee": true
}
{- "claim_id": 0,
- "item_id": 0,
- "issue_id": 0,
- "old_issue_id": 0,
- "patron_id": 0,
- "notes": "string",
- "created_on": "2019-08-24T14:15:22Z",
- "created_by": 0,
- "updated_on": "2019-08-24T14:15:22Z",
- "updated_by": 0,
- "resolution": "string",
- "resolved_on": "2019-08-24T14:15:22Z",
- "resolved_by": 0
}
claim_id required | integer Unique identifier for the claim to be deleted |
{- "claim_id": 0,
- "item_id": 0,
- "issue_id": 0,
- "old_issue_id": 0,
- "patron_id": 0,
- "notes": "string",
- "created_on": "2019-08-24T14:15:22Z",
- "created_by": 0,
- "updated_on": "2019-08-24T14:15:22Z",
- "updated_by": 0,
- "resolution": "string",
- "resolved_on": "2019-08-24T14:15:22Z",
- "resolved_by": 0
}
claim_id required | integer Unique identifier for the claim whose notes are to be updated |
A JSON object containing fields to modify
notes | string Notes about this return claim |
updated_by | string Interal identifier for the librarian updating the claim notes |
{- "notes": "string",
- "updated_by": "string"
}
{- "claim_id": 0,
- "item_id": 0,
- "issue_id": 0,
- "old_issue_id": 0,
- "patron_id": 0,
- "notes": "string",
- "created_on": "2019-08-24T14:15:22Z",
- "created_by": 0,
- "updated_on": "2019-08-24T14:15:22Z",
- "updated_by": 0,
- "resolution": "string",
- "resolved_on": "2019-08-24T14:15:22Z",
- "resolved_by": 0
}
claim_id required | integer Unique identifier for the claim to be resolved |
A JSON object containing fields to modify
resolution | string The RETURN_CLAIM_RESOLUTION code to be used to resolve the calim |
resolved_by | string User id for the librarian resolving the claim |
new_lost_status | string New lost status to set to the item |
{- "resolution": "string",
- "resolved_by": "string",
- "new_lost_status": "string"
}
{- "claim_id": 0,
- "item_id": 0,
- "issue_id": 0,
- "old_issue_id": 0,
- "patron_id": 0,
- "notes": "string",
- "created_on": "2019-08-24T14:15:22Z",
- "created_by": 0,
- "updated_on": "2019-08-24T14:15:22Z",
- "updated_by": 0,
- "resolution": "string",
- "resolved_on": "2019-08-24T14:15:22Z",
- "resolved_by": 0
}
rota_id required | integer A rotas ID |
stage_id required | integer A stages ID |
A stages position in the rota
0
{- "error": "string",
- "error_code": "string"
}
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "search_filter_id": 0,
- "name": "string",
- "query": "string",
- "limits": "string",
- "opac": true,
- "staff_client": true
}
]
A JSON object containing informations about the new search filter
name required | string filter name |
query | string or null filter query part |
limits | string or null filter limits part |
opac | boolean or null visible on opac |
staff_client | boolean or null visible in staff client |
{- "name": "string",
- "query": "string",
- "limits": "string",
- "opac": true,
- "staff_client": true
}
{- "search_filter_id": 0,
- "name": "string",
- "query": "string",
- "limits": "string",
- "opac": true,
- "staff_client": true
}
search_filter_id required | integer Search filter internal identifier |
{- "search_filter_id": 0,
- "name": "string",
- "query": "string",
- "limits": "string",
- "opac": true,
- "staff_client": true
}
search_filter_id required | integer Search filter internal identifier |
A search filter object
name required | string filter name |
query | string or null filter query part |
limits | string or null filter limits part |
opac | boolean or null visible on opac |
staff_client | boolean or null visible in staff client |
{- "name": "string",
- "query": "string",
- "limits": "string",
- "opac": true,
- "staff_client": true
}
{- "search_filter_id": 0,
- "name": "string",
- "query": "string",
- "limits": "string",
- "opac": true,
- "staff_client": true
}
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "smtp_server_id": 0,
- "name": "string",
- "host": "string",
- "port": 0,
- "timeout": 0,
- "ssl_mode": "disabled",
- "user_name": "string",
- "password": "string",
- "debug": true,
- "is_default": true
}
]
A JSON object representing a new SMTP server configuration
name required | string Name of the SMTP server |
host | string SMTP host name |
port | integer TCP port number |
timeout | integer Maximum time in seconds to wait for server |
ssl_mode | string Enum: "disabled" "ssl" "starttls" If SSL/TLS will be used |
user_name | string or null The user name to use for authentication (optional) |
password | string or null The password to use for authentication (optional) |
debug | boolean If the SMTP connection is set to debug mode |
is_default | boolean Is this the default SMTP server |
{- "name": "string",
- "host": "string",
- "port": 0,
- "timeout": 0,
- "ssl_mode": "disabled",
- "user_name": "string",
- "password": "string",
- "debug": true,
- "is_default": true
}
{- "smtp_server_id": 0,
- "name": "string",
- "host": "string",
- "port": 0,
- "timeout": 0,
- "ssl_mode": "disabled",
- "user_name": "string",
- "password": "string",
- "debug": true,
- "is_default": true
}
smtp_server_id required | integer SMTP server internal identifier |
{- "smtp_server_id": 0,
- "name": "string",
- "host": "string",
- "port": 0,
- "timeout": 0,
- "ssl_mode": "disabled",
- "user_name": "string",
- "password": "string",
- "debug": true,
- "is_default": true
}
smtp_server_id required | integer SMTP server internal identifier |
An SMTP server object
name required | string Name of the SMTP server |
host | string SMTP host name |
port | integer TCP port number |
timeout | integer Maximum time in seconds to wait for server |
ssl_mode | string Enum: "disabled" "ssl" "starttls" If SSL/TLS will be used |
user_name | string or null The user name to use for authentication (optional) |
password | string or null The password to use for authentication (optional) |
debug | boolean If the SMTP connection is set to debug mode |
is_default | boolean Is this the default SMTP server |
{- "name": "string",
- "host": "string",
- "port": 0,
- "timeout": 0,
- "ssl_mode": "disabled",
- "user_name": "string",
- "password": "string",
- "debug": true,
- "is_default": true
}
{- "smtp_server_id": 0,
- "name": "string",
- "host": "string",
- "port": 0,
- "timeout": 0,
- "ssl_mode": "disabled",
- "user_name": "string",
- "password": "string",
- "debug": true,
- "is_default": true
}
A JSON object containing informations about the new ticket
source required | string Value: "catalog" |
biblio_id | integer Internal identifier for the biblio the ticket is related to |
title required | string Ticket title |
body required | string Ticket details |
reporter_id | integer Internal identifier for the patron who reported the ticket |
assignee | object or null |
assignee_id | integer or null |
resolver_id | integer or null Internal identifier for the user who resolved the ticket |
resolved_date | string or null <date-time> Date the ticket was resolved_date |
updates_count | integer or null Number of updates |
_strings | object or null A list of stringified coded values |
{- "source": "catalog",
- "biblio_id": 0,
- "title": "string",
- "body": "string",
- "reporter_id": 0,
- "assignee": { },
- "assignee_id": 0,
- "resolver_id": 0,
- "resolved_date": "2019-08-24T14:15:22Z",
- "updates_count": 0,
- "_strings": { }
}
{- "ticket_id": 0,
- "source": "catalog",
- "reported_date": "2019-08-24T14:15:22Z",
- "biblio": { },
- "biblio_id": 0,
- "title": "string",
- "body": "string",
- "status": "string",
- "reporter": { },
- "reporter_id": 0,
- "assignee": { },
- "assignee_id": 0,
- "resolver": { },
- "resolver_id": 0,
- "resolved_date": "2019-08-24T14:15:22Z",
- "updates_count": 0,
- "_strings": { }
}
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "assignee" "reporter" "resolver" "biblio" "updates+count" "+strings" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "ticket_id": 0,
- "source": "catalog",
- "reported_date": "2019-08-24T14:15:22Z",
- "biblio": { },
- "biblio_id": 0,
- "title": "string",
- "body": "string",
- "status": "string",
- "reporter": { },
- "reporter_id": 0,
- "assignee": { },
- "assignee_id": 0,
- "resolver": { },
- "resolver_id": 0,
- "resolved_date": "2019-08-24T14:15:22Z",
- "updates_count": 0,
- "_strings": { }
}
]
A JSON object containing informations about the new ticket
source required | string Value: "catalog" |
biblio_id | integer Internal identifier for the biblio the ticket is related to |
title required | string Ticket title |
body required | string Ticket details |
reporter_id | integer Internal identifier for the patron who reported the ticket |
assignee | object or null |
assignee_id | integer or null |
resolver_id | integer or null Internal identifier for the user who resolved the ticket |
resolved_date | string or null <date-time> Date the ticket was resolved_date |
updates_count | integer or null Number of updates |
_strings | object or null A list of stringified coded values |
{- "source": "catalog",
- "biblio_id": 0,
- "title": "string",
- "body": "string",
- "reporter_id": 0,
- "assignee": { },
- "assignee_id": 0,
- "resolver_id": 0,
- "resolved_date": "2019-08-24T14:15:22Z",
- "updates_count": 0,
- "_strings": { }
}
{- "ticket_id": 0,
- "source": "catalog",
- "reported_date": "2019-08-24T14:15:22Z",
- "biblio": { },
- "biblio_id": 0,
- "title": "string",
- "body": "string",
- "status": "string",
- "reporter": { },
- "reporter_id": 0,
- "assignee": { },
- "assignee_id": 0,
- "resolver": { },
- "resolver_id": 0,
- "resolved_date": "2019-08-24T14:15:22Z",
- "updates_count": 0,
- "_strings": { }
}
ticket_id required | integer Internal ticket identifier |
{- "ticket_id": 0,
- "source": "catalog",
- "reported_date": "2019-08-24T14:15:22Z",
- "biblio": { },
- "biblio_id": 0,
- "title": "string",
- "body": "string",
- "status": "string",
- "reporter": { },
- "reporter_id": 0,
- "assignee": { },
- "assignee_id": 0,
- "resolver": { },
- "resolver_id": 0,
- "resolved_date": "2019-08-24T14:15:22Z",
- "updates_count": 0,
- "_strings": { }
}
ticket_id required | integer Internal ticket identifier |
A ticket object
source required | string Value: "catalog" |
biblio_id | integer Internal identifier for the biblio the ticket is related to |
title required | string Ticket title |
body required | string Ticket details |
reporter_id | integer Internal identifier for the patron who reported the ticket |
assignee | object or null |
assignee_id | integer or null |
resolver_id | integer or null Internal identifier for the user who resolved the ticket |
resolved_date | string or null <date-time> Date the ticket was resolved_date |
updates_count | integer or null Number of updates |
_strings | object or null A list of stringified coded values |
{- "source": "catalog",
- "biblio_id": 0,
- "title": "string",
- "body": "string",
- "reporter_id": 0,
- "assignee": { },
- "assignee_id": 0,
- "resolver_id": 0,
- "resolved_date": "2019-08-24T14:15:22Z",
- "updates_count": 0,
- "_strings": { }
}
{- "ticket_id": 0,
- "source": "catalog",
- "reported_date": "2019-08-24T14:15:22Z",
- "biblio": { },
- "biblio_id": 0,
- "title": "string",
- "body": "string",
- "status": "string",
- "reporter": { },
- "reporter_id": 0,
- "assignee": { },
- "assignee_id": 0,
- "resolver": { },
- "resolver_id": 0,
- "resolved_date": "2019-08-24T14:15:22Z",
- "updates_count": 0,
- "_strings": { }
}
ticket_id required | integer Internal ticket identifier |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Enum: "assignee" "user" "+strings" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "update_id": 0,
- "ticket_id": 0,
- "user": { },
- "user_id": 0,
- "assignee": { },
- "assignee_id": 0,
- "date": "2019-08-24T14:15:22Z",
- "message": "string",
- "public": true,
- "status": "string"
}
]
ticket_id required | integer Internal ticket identifier |
A ticket update object
user_id | integer Internal identifier for the patron who added the update |
assignee | object or null |
assignee_id | integer or null |
message required | string Ticket update details |
public required | boolean Is this update intended to be sent to the patron |
status | string or null Status of the ticket after this update |
property name* additional property | any |
{- "user_id": 0,
- "assignee": { },
- "assignee_id": 0,
- "message": "string",
- "public": true,
- "status": "string"
}
{- "update_id": 0,
- "ticket_id": 0,
- "user": { },
- "user_id": 0,
- "assignee": { },
- "assignee_id": 0,
- "date": "2019-08-24T14:15:22Z",
- "message": "string",
- "public": true,
- "status": "string"
}
This resource returns a list of existing transfer limits.
to_library_id | string Search on to_library_id |
from_library_id | string Search on from_library_id |
item_type | string Search on item_type |
collection_code | string Search on collection_code |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "limit_id": 0,
- "to_library_id": "string",
- "from_library_id": "string",
- "item_type": "string",
- "collection_code": "string"
}
]
This resource accepts a new transfer limit and creates it if it does not already exist.
A JSON object containing information about a new transfer limit
limit_id | integer Internal transfer limit identifier |
to_library_id required | string Internal library id for which library the item is going to |
from_library_id required | string Internal library id for which library the item is coming from |
item_type | string or null Itemtype defining the type for this limi |
collection_code | string or null Authorized value for the collection code associated with this limit |
{- "limit_id": 0,
- "to_library_id": "string",
- "from_library_id": "string",
- "item_type": "string",
- "collection_code": "string"
}
{- "limit_id": 0,
- "to_library_id": "string",
- "from_library_id": "string",
- "item_type": "string",
- "collection_code": "string"
}
This resource batch creates new transfer limits based on the given data.
Transfer limits can be defined based on collection_code
or item_type
. The endpoint only accepts one at a time, and which one is used will depend on the value of the BranchTransferLimitsType
system preference.
For example, if the paramters to_library_id: 'BranchA'
and item_type: 'BOOK'
are passed in new transfer limits for BOOK
s will be created, with one transfer limit each for all the branches defined in Koha. Given 4 branches, 3 limits would be created:
The body of the query would look like
'to_library_id': 'BranchA',
'item_type': 'BOOK'
} ```
As another example, imagine we have an itemtype that is never supposed to be transferred to another library. If we call that itemtype `LOCAL_ONLY` we would need to just pass `item_type: 'LOCAL_ONLY'`, which would create transfer limits for all libraries, meaning those items would never be allowed to transfer to another library. The body of the query would look like
``` {
'item_type': 'LOCAL_ONLY'
} ```
A JSON object containing information about new transfer limits.
to_library_id | string Internal library id for which library the item is going to |
from_library_id | string Internal library id for which library the item is coming from |
item_type | string or null Itemtype defining the type for this limi |
collection_code | string or null Authorized value for the collection code associated with this limit |
{- "to_library_id": "string",
- "from_library_id": "string",
- "item_type": "string",
- "collection_code": "string"
}
[- {
- "limit_id": 0,
- "to_library_id": "string",
- "from_library_id": "string",
- "item_type": "string",
- "collection_code": "string"
}
]
This endpoint works just like the POST version, except it deletes transfer in batch rather than creating them.
A JSON object containing information about new transfer limits.
to_library_id | string Internal library id for which library the item is going to |
from_library_id | string Internal library id for which library the item is coming from |
item_type | string or null Itemtype defining the type for this limi |
collection_code | string or null Authorized value for the collection code associated with this limit |
{- "to_library_id": "string",
- "from_library_id": "string",
- "item_type": "string",
- "collection_code": "string"
}
{- "error": "string",
- "error_code": "string"
}
This resource deletes a transfer limit for the given limit id
limit_id required | string Internal transfer limit identifier |
"string"
secret32 required | string the secret |
pin_code required | string the pin code |
{- "error": "string",
- "error_code": "string"
}
name | string Case insensitive search on vendor name |
accountnumber | string Case insensitive search on vendor's account number |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-request-id | integer Request id header |
x-koha-embed | Array of strings Items Value: "aliases" Embed list sent as a request header |
Query filter sent through request"s body
{ }
[- {
- "id": 0,
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "address4": "string",
- "phone": "string",
- "fax": "string",
- "accountnumber": "string",
- "type": "string",
- "notes": "string",
- "postal": "string",
- "url": "string",
- "active": true,
- "list_currency": "string",
- "invoice_currency": "string",
- "gst": true,
- "list_includes_gst": true,
- "invoice_includes_gst": true,
- "tax_rate": 0,
- "discount": 0,
- "deliverytime": 0,
- "external_id": "string",
- "aliases": [
- {
- "alias_id": 0,
- "vendor_id": 0,
- "alias": "string"
}
]
}
]
A JSON object representing a vendor
name required | string Vendor name | ||||||
address1 | string or null Vendor physical address (line 1) | ||||||
address2 | string or null Vendor physical address (line 2) | ||||||
address3 | string or null Vendor physical address (line 3) | ||||||
address4 | string or null Vendor physical address (line 4) | ||||||
phone | string or null Vendor phone number | ||||||
fax | string or null Vendor fax number | ||||||
accountnumber | string or null Vendor account number | ||||||
type | string or null Type of vendor | ||||||
notes | string or null Vendor notes | ||||||
postal | string or null Vendor postal address | ||||||
url | string or null Vendor web address | ||||||
active | boolean or null Is this vendor active | ||||||
list_currency | string or null List prices currency | ||||||
invoice_currency | string or null Invoice prices currency | ||||||
gst | boolean or null Is the library taxed when buying from this vendor | ||||||
list_includes_gst | boolean or null List prices include taxes | ||||||
invoice_includes_gst | boolean or null Invoice prices include taxes | ||||||
tax_rate | number or null Default tax rate for items ordered from this vendor | ||||||
discount | number or null Default discount rate for items ordered from this vendor | ||||||
deliverytime | integer or null Expected delivery time (in days) | ||||||
external_id | string or null External id | ||||||
Array of objects (vendor_alias) List of aliases | |||||||
Array
|
{- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "address4": "string",
- "phone": "string",
- "fax": "string",
- "accountnumber": "string",
- "type": "string",
- "notes": "string",
- "postal": "string",
- "url": "string",
- "active": true,
- "list_currency": "string",
- "invoice_currency": "string",
- "gst": true,
- "list_includes_gst": true,
- "invoice_includes_gst": true,
- "tax_rate": 0,
- "discount": 0,
- "deliverytime": 0,
- "external_id": "string",
- "aliases": [
- {
- "alias_id": 0,
- "vendor_id": 0,
- "alias": "string"
}
]
}
{- "id": 0,
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "address4": "string",
- "phone": "string",
- "fax": "string",
- "accountnumber": "string",
- "type": "string",
- "notes": "string",
- "postal": "string",
- "url": "string",
- "active": true,
- "list_currency": "string",
- "invoice_currency": "string",
- "gst": true,
- "list_includes_gst": true,
- "invoice_includes_gst": true,
- "tax_rate": 0,
- "discount": 0,
- "deliverytime": 0,
- "external_id": "string",
- "aliases": [
- {
- "alias_id": 0,
- "vendor_id": 0,
- "alias": "string"
}
]
}
vendor_id required | integer Vendor id |
{- "id": 0,
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "address4": "string",
- "phone": "string",
- "fax": "string",
- "accountnumber": "string",
- "type": "string",
- "notes": "string",
- "postal": "string",
- "url": "string",
- "active": true,
- "list_currency": "string",
- "invoice_currency": "string",
- "gst": true,
- "list_includes_gst": true,
- "invoice_includes_gst": true,
- "tax_rate": 0,
- "discount": 0,
- "deliverytime": 0,
- "external_id": "string",
- "aliases": [
- {
- "alias_id": 0,
- "vendor_id": 0,
- "alias": "string"
}
]
}
vendor_id required | integer Vendor id |
A JSON object representing a vendor
name required | string Vendor name | ||||||
address1 | string or null Vendor physical address (line 1) | ||||||
address2 | string or null Vendor physical address (line 2) | ||||||
address3 | string or null Vendor physical address (line 3) | ||||||
address4 | string or null Vendor physical address (line 4) | ||||||
phone | string or null Vendor phone number | ||||||
fax | string or null Vendor fax number | ||||||
accountnumber | string or null Vendor account number | ||||||
type | string or null Type of vendor | ||||||
notes | string or null Vendor notes | ||||||
postal | string or null Vendor postal address | ||||||
url | string or null Vendor web address | ||||||
active | boolean or null Is this vendor active | ||||||
list_currency | string or null List prices currency | ||||||
invoice_currency | string or null Invoice prices currency | ||||||
gst | boolean or null Is the library taxed when buying from this vendor | ||||||
list_includes_gst | boolean or null List prices include taxes | ||||||
invoice_includes_gst | boolean or null Invoice prices include taxes | ||||||
tax_rate | number or null Default tax rate for items ordered from this vendor | ||||||
discount | number or null Default discount rate for items ordered from this vendor | ||||||
deliverytime | integer or null Expected delivery time (in days) | ||||||
external_id | string or null External id | ||||||
Array of objects (vendor_alias) List of aliases | |||||||
Array
|
{- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "address4": "string",
- "phone": "string",
- "fax": "string",
- "accountnumber": "string",
- "type": "string",
- "notes": "string",
- "postal": "string",
- "url": "string",
- "active": true,
- "list_currency": "string",
- "invoice_currency": "string",
- "gst": true,
- "list_includes_gst": true,
- "invoice_includes_gst": true,
- "tax_rate": 0,
- "discount": 0,
- "deliverytime": 0,
- "external_id": "string",
- "aliases": [
- {
- "alias_id": 0,
- "vendor_id": 0,
- "alias": "string"
}
]
}
{- "id": 0,
- "name": "string",
- "address1": "string",
- "address2": "string",
- "address3": "string",
- "address4": "string",
- "phone": "string",
- "fax": "string",
- "accountnumber": "string",
- "type": "string",
- "notes": "string",
- "postal": "string",
- "url": "string",
- "active": true,
- "list_currency": "string",
- "invoice_currency": "string",
- "gst": true,
- "list_includes_gst": true,
- "invoice_includes_gst": true,
- "tax_rate": 0,
- "discount": 0,
- "deliverytime": 0,
- "external_id": "string",
- "aliases": [
- {
- "alias_id": 0,
- "vendor_id": 0,
- "alias": "string"
}
]
}
vendor_id required | integer Vendor id |
issue_id | integer Case insensitive search on issue's id |
vendor_id | integer Case insensitive search on vendor's id |
type | string Case insensitive search on issue type |
started_on | string Case insensitive search on issue start date |
ended_on | string Case insensitive search on issue end date |
notes | string Case insensitive search on issue's notes |
_match | string Enum: "contains" "exact" "starts_with" "ends_with" Matching criteria |
_order_by | Array of strings Sorting criteria |
_page | integer Page number, for paginated object listing |
_per_page | integer Page size, for paginated object listing |
q | Array of strings Query filter sent as a request parameter |
x-koha-embed | Array of strings Items Value: "+strings" Embed list sent as a request header |
x-koha-request-id | integer Request id header |
Query filter sent through request"s body
{ }
[- {
- "issue_id": 0,
- "vendor_id": 0,
- "type": "string",
- "started_on": "2019-08-24",
- "ended_on": "2019-08-24",
- "notes": "string",
- "_strings": { }
}
]