Download OpenAPI specification:Download
The API supports the following authentication mechanisms
Both Basic authentication and the OAuth2 flow, need to be enabled by system preferences.
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": "patron not found"
}
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=
x-koha-query
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 ">", "<", ">=", "<=", "-like", and "-not_like".
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
wilth 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.
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 whilse 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" ] }'
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"
}
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"
}
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-query | string Query filter 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",
- "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-24",
- "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,
- "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
}
]
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 |
x-koha-query | string Query filter 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",
- "opac_info": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "public": true,
- "smtp_server": { },
- "needs_override": true
}
]
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-query | string Query filter 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",
- "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-24",
- "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,
- "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
}
]
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-query | string Query filter 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": { }
}
]
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-query | string Query filter 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": 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-query | string Query filter 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": 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": 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 |
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": 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": { }
}
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-query | string Query filter sent as a request 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 Nullable city state |
postal_code required | string Nullable city postal code |
country required | string Nullable 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 Nullable city state |
postal_code required | string Nullable city postal code |
country required | string Nullable 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 Nullable Internal biblio identifier |
item_id | integer Nullable Internal item identifier |
pickup_library_id required | string Internal library identifier for the pickup library |
expiration_date | string <date> Nullable Hold end date |
notes | string Nullable Notes related to this hold |
item_type | string Nullable 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"
}
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-query | string Query filter sent as a request 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"
}
]
hold_id | integer Internal hold identifier |
patron_id | integer Internal patron identifier |
hold_date | string <date> Hold |
biblio_id | integer Internal biblio 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 |
x-koha-query | string Query filter 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,
- "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": "string",
- "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
}
]
x-koha-override | string Comma-separated list of overrides (valid values: any) |
A JSON object containing informations about the new hold
patron_id required | integer Internal patron identifier |
biblio_id | integer Nullable Internal biblio identifier |
hold_date | string <date> Nullable The date the hold was placed |
item_id | integer Nullable Internal item identifier |
pickup_library_id required | string Internal library identifier for the pickup library |
expiration_date | string <date> Nullable Hold end date |
notes | string Nullable Notes related to this hold |
item_type | string Nullable Limit hold on one itemtype (ignored for item-level holds) |
non_priority | boolean Nullable Set this hold as non priority |
{- "patron_id": 0,
- "biblio_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,
- "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": "string",
- "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
}
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,
- "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": "string",
- "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
}
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,
- "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": "string",
- "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
}
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"
}
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 | string Comma-separated list of overrides (valid values: any) |
x-koha-query | string Query filter 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",
- "opac_info": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "public": true,
- "smtp_server": { },
- "needs_override": true
}
]
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"
}
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-query | string Query filter 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,
- "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": "string",
- "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
}
]
embed | Array of strings Items Enum: "patron" "library" "capabilities" "metadata" "requested_partners" "comments" "status_alias" Additional objects that should be embedded in the response |
backend | string The name of a ILL backend |
orderid | string The order ID of a request |
biblionumber | integer Internal biblio identifier |
borrowernumber | integer Internal patron identifier |
completed | string The date the request was considered completed |
completed_formatted | string The date the request was considered complete formatted |
status | string A full status string e.g. REQREV |
cost | number The quoted cost of the request |
price_paid | number The final cost of the request |
medium | string The medium of the requested item |
updated | string The last updated date of the request |
updated_formatted | string The last updated date of the request formatted |
placed | string The date the request was placed |
placed_formatted | string The date the request was placed formatted |
branchcode | string Library ID |
{- "error": "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-query | string Query filter 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",
- "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-24",
- "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,
- "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
}
]
{- "item_id": 0,
- "biblio_id": 0,
- "external_id": "string",
- "acquisition_date": "2019-08-24",
- "acquisition_source": "string",
- "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-24",
- "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,
- "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
}
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-query | string Query filter 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",
- "opac_info": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "public": true,
- "smtp_server": { },
- "needs_override": true
}
]
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-query | string Query filter 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",
- "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-24",
- "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,
- "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
}
]
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 |
opac_info | string Case insensitive 'starts-with' search on OPAC info |
_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-query | string Query filter 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",
- "opac_info": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "public": true,
- "smtp_server": { },
- "needs_override": true
}
]
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 Nullable the first address line of the library |
address2 | string Nullable the second address line of the library |
address3 | string Nullable the third address line of the library |
postal_code | string Nullable the postal code of the library |
city | string Nullable the city or province of the library |
state | string Nullable the reqional state of the library |
country | string Nullable the county of the library |
phone | string Nullable the primary phone of the library |
fax | string Nullable the fax number of the library |
string Nullable the primary email address of the library | |
illemail | string Nullable the ILL staff email address of the library |
reply_to_email | string Nullable the email to be used as a Reply-To |
return_path_email | string Nullable the email to be used as Return-Path |
url | string Nullable the URL for your library or branch's website |
ip | string Nullable the IP address for your library or branch |
notes | string Nullable notes related to your library or branch |
opac_info | string Nullable HTML that displays in OPAC |
geolocation | string Nullable geolocation of your library |
marc_org_code | string Nullable 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 |
public | boolean If the library is visible to the public |
smtp_server | object Nullable The library effective SMTP server |
needs_override | boolean If the library needs an override to act as pickup location for a hold |
{- "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",
- "opac_info": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "public": true,
- "smtp_server": { },
- "needs_override": true
}
{- "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",
- "opac_info": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "public": true,
- "smtp_server": { },
- "needs_override": true
}
{- "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",
- "opac_info": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "public": true,
- "smtp_server": { },
- "needs_override": true
}
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 Nullable the first address line of the library |
address2 | string Nullable the second address line of the library |
address3 | string Nullable the third address line of the library |
postal_code | string Nullable the postal code of the library |
city | string Nullable the city or province of the library |
state | string Nullable the reqional state of the library |
country | string Nullable the county of the library |
phone | string Nullable the primary phone of the library |
fax | string Nullable the fax number of the library |
string Nullable the primary email address of the library | |
illemail | string Nullable the ILL staff email address of the library |
reply_to_email | string Nullable the email to be used as a Reply-To |
return_path_email | string Nullable the email to be used as Return-Path |
url | string Nullable the URL for your library or branch's website |
ip | string Nullable the IP address for your library or branch |
notes | string Nullable notes related to your library or branch |
opac_info | string Nullable HTML that displays in OPAC |
geolocation | string Nullable geolocation of your library |
marc_org_code | string Nullable 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 |
public | boolean If the library is visible to the public |
smtp_server | object Nullable The library effective SMTP server |
needs_override | boolean If the library needs an override to act as pickup location for a hold |
{- "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",
- "opac_info": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "public": true,
- "smtp_server": { },
- "needs_override": true
}
{- "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",
- "opac_info": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "public": true,
- "smtp_server": { },
- "needs_override": 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-query | string Query filter 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",
- "opac_info": "string",
- "geolocation": "string",
- "marc_org_code": "string",
- "pickup_location": true,
- "public": true,
- "smtp_server": { },
- "needs_override": true
}
]
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-query | string Query filter sent as a request 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 Nullable macro text |
patron_id required | integer Nullable borrower number |
shared required | boolean Nullable 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 |
An advanced editor macro object
name required | string macro name |
macro_text required | string Nullable macro text |
patron_id required | integer Nullable borrower number |
shared required | boolean Nullable 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-query | string Query filter sent as a request header |
Query filter sent through request's body
[ ]
[- {
- "order_id": 0,
- "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,
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { }
}
]
A JSON object representing an order
order_id | integer Internally assigned order identifier |
biblio_id | integer Nullable Identifier for the linked bibliographic record |
created_by | integer Nullable Interal patron identifier of the order line creator |
entry_date | string <date> Nullable Date the bib was added to the basket |
quantity | integer Nullable Ordered quantity |
currency | string Nullable Currency used for the purchase |
list_price | number Nullable Vendor price for the line item |
replacement_price | number Nullable Replacement cost for this item |
date_received | string <date> Nullable Date the order was received |
invoice_id | integer Nullable Id of the order invoice |
shipping_cost | number Nullable Shipping cost |
unit_price | number Nullable The actual cost entered when receiving this line item |
unit_price_tax_excluded | number Nullable Unit price excluding tax (on receiving) |
unit_price_tax_included | number Nullable Unit price including tax (on receiving) |
quantity_received | integer Quantity received so far |
cancellation_date | string <date> Nullable Date the line item was deleted |
cancellation_reason | string Nullable Reason of cancellation |
internal_note | string Nullable Notes related to this order line, made for staff |
vendor_note | string Nullable Notes related to this order line, made for vendor |
basket_id | integer Nullable Basket this order is linked to |
timestamp | string <date-time> Date and time this order line was last modified |
rrp | number Nullable Retail cost for this item |
rrp_tax_excluded | number Nullable Replacement cost for this item (tax excluded) |
rrp_tax_included | number Nullable Replacement cost for this item (tax included) |
ecost | number Nullable Effective cost |
ecost_tax_excluded | number Nullable Effective cost (tax excluded) |
ecost_tax_included | number Nullable Effective cost (tax included) |
tax_rate_on_ordering | number Nullable Tax rate on ordering (%) |
tax_rate_on_receiving | number Nullable Tax rate on receiving (%) |
tax_value_on_ordering | number Nullable Tax value on ordering |
tax_value_on_receiving | number Nullable Tax value on receiving |
discount_rate | number Nullable Discount rate |
fund_id | integer Internal identifier for the fund this order goes against |
statistics_1 | string Nullable Statistical field |
statistics_2 | string Nullable Statistical field (2) |
statistics_1_authcat | string Nullable Statistical category for this order |
statistics_2_authcat | string Nullable 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 <date> Nullable Last date a claim letter was generated |
subscription_id | integer Nullable Subscription ID linking the order to a subscription |
parent_order_id | integer Nullable Order ID of parent order line if exists |
status | string Enum: "new" "ordered" "partial" "complete" "cancelled" The current order status |
basket | object Nullable |
biblio | object Nullable |
current_item_level_holds_count | integer Current holds count for associated items |
fund | object Nullable |
invoice | object Nullable |
items | Array of any |
subscription | object Nullable |
{- "order_id": 0,
- "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,
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { }
}
{- "order_id": 0,
- "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,
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { }
}
{- "order_id": 0,
- "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,
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { }
}
order_id required | integer Internal order identifier |
A JSON object representing an order
order_id | integer Internally assigned order identifier |
biblio_id | integer Nullable Identifier for the linked bibliographic record |
created_by | integer Nullable Interal patron identifier of the order line creator |
entry_date | string <date> Nullable Date the bib was added to the basket |
quantity | integer Nullable Ordered quantity |
currency | string Nullable Currency used for the purchase |
list_price | number Nullable Vendor price for the line item |
replacement_price | number Nullable Replacement cost for this item |
date_received | string <date> Nullable Date the order was received |
invoice_id | integer Nullable Id of the order invoice |
shipping_cost | number Nullable Shipping cost |
unit_price | number Nullable The actual cost entered when receiving this line item |
unit_price_tax_excluded | number Nullable Unit price excluding tax (on receiving) |
unit_price_tax_included | number Nullable Unit price including tax (on receiving) |
quantity_received | integer Quantity received so far |
cancellation_date | string <date> Nullable Date the line item was deleted |
cancellation_reason | string Nullable Reason of cancellation |
internal_note | string Nullable Notes related to this order line, made for staff |
vendor_note | string Nullable Notes related to this order line, made for vendor |
basket_id | integer Nullable Basket this order is linked to |
timestamp | string <date-time> Date and time this order line was last modified |
rrp | number Nullable Retail cost for this item |
rrp_tax_excluded | number Nullable Replacement cost for this item (tax excluded) |
rrp_tax_included | number Nullable Replacement cost for this item (tax included) |
ecost | number Nullable Effective cost |
ecost_tax_excluded | number Nullable Effective cost (tax excluded) |
ecost_tax_included | number Nullable Effective cost (tax included) |
tax_rate_on_ordering | number Nullable Tax rate on ordering (%) |
tax_rate_on_receiving | number Nullable Tax rate on receiving (%) |
tax_value_on_ordering | number Nullable Tax value on ordering |
tax_value_on_receiving | number Nullable Tax value on receiving |
discount_rate | number Nullable Discount rate |
fund_id | integer Internal identifier for the fund this order goes against |
statistics_1 | string Nullable Statistical field |
statistics_2 | string Nullable Statistical field (2) |
statistics_1_authcat | string Nullable Statistical category for this order |
statistics_2_authcat | string Nullable 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 <date> Nullable Last date a claim letter was generated |
subscription_id | integer Nullable Subscription ID linking the order to a subscription |
parent_order_id | integer Nullable Order ID of parent order line if exists |
status | string Enum: "new" "ordered" "partial" "complete" "cancelled" The current order status |
basket | object Nullable |
biblio | object Nullable |
current_item_level_holds_count | integer Current holds count for associated items |
fund | object Nullable |
invoice | object Nullable |
items | Array of any |
subscription | object Nullable |
{- "order_id": 0,
- "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,
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { }
}
{- "order_id": 0,
- "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,
- "fund": { },
- "invoice": { },
- "items": [
- null
], - "subscription": { }
}
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
}
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 |
_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-query | string Query filter sent as a request header |
Query filter sent through request's body
[ ]
[- {
- "patron_id": 0,
- "cardnumber": null,
- "surname": null,
- "firstname": null,
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": null,
- "phone": null,
- "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"
}
]
}
]
A JSON object containing information about the new patron
patron_id | integer Internal patron identifier |
cardnumber | stringnull library assigned user identifier |
surname required | stringnull patron's last name |
firstname | stringnull patron's first name |
title | string Nullable patron's title |
other_name | string Nullable any other names associated with the patron |
initials | string Nullable initials of the patron |
street_number | string Nullable street number of patron's primary address |
street_type | string Nullable street type of patron's primary address |
address required | string Nullable first address line of patron's primary address |
address2 | string Nullable second address line of patron's primary address |
city required | string Nullable city or town of patron's primary address |
state | string Nullable state or province of patron's primary address |
postal_code | string Nullable zip or postal code of patron's primary address |
country | string Nullable country of patron's primary address |
stringnull primary email address for patron's primary address | |
phone | stringnull primary phone number for patron's primary address |
mobile | string Nullable the other phone number for patron's primary address |
fax | string Nullable fax number for patron's primary address |
secondary_email | string Nullable secondary email address for patron's primary address |
secondary_phone | string Nullable secondary phone number for patron's primary address |
altaddress_street_number | string Nullable street number of patron's alternate address |
altaddress_street_type | string Nullable street type of patron's alternate address |
altaddress_address | string Nullable first address line of patron's alternate address |
altaddress_address2 | string Nullable second address line of patron's alternate address |
altaddress_city | string Nullable city or town of patron's alternate address |
altaddress_state | string Nullable state or province of patron's alternate address |
altaddress_postal_code | string Nullable zip or postal code of patron's alternate address |
altaddress_country | string Nullable country of patron's alternate address |
altaddress_email | string Nullable email address for patron's alternate address |
altaddress_phone | string Nullable phone number for patron's alternate address |
date_of_birth | string <date> Nullable 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 <date> Nullable date the patron was added to Koha |
expiry_date | string <date> Nullable date the patron's card is set to expire |
date_renewed | string <date> Nullable date the patron's card was last renewed |
incorrect_address | boolean Nullable set to 1 if library marked this patron as having an unconfirmed address |
patron_card_lost | boolean Nullable set to 1 if library marked this patron as having lost his card |
staff_notes | string Nullable a note on the patron's account |
relationship_type | string Nullable used for children to include the relationship to their guarantor |
gender | string Nullable patron's gender |
userid | string Nullable patron's login |
opac_notes | string Nullable a note on the patron's account visible in OPAC and staff interface |
altaddress_notes | string Nullable a note related to patron's alternate address |
statistics_1 | string Nullable a field that can be used for any information unique to the library |
statistics_2 | string Nullable 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 Nullable first name of alternate contact for the patron |
altcontact_surname | string Nullable surname or last name of the alternate contact for the patron |
altcontact_address | string Nullable the first address line for the alternate contact for the patron |
altcontact_address2 | string Nullable the second address line for the alternate contact for the patron |
altcontact_city | string Nullable the city for the alternate contact for the patron |
altcontact_state | string Nullable the state for the alternate contact for the patron |
altcontact_postal_code | string Nullable the zipcode for the alternate contact for the patron |
altcontact_country | string Nullable the country for the alternate contact for the patron |
altcontact_phone | string Nullable the phone number for the alternate contact for the patron |
sms_number | string Nullable the mobile phone number where the patron would like to receive notices (if SMS turned on) |
sms_provider_id | integer Nullable 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 <date-time> Nullable 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 Nullable number of failed login attemps |
overdrive_auth_token | string Nullable persist OverDrive auth token |
Array of objects (patron_extended_attribute) patron's extended attributes |
{- "patron_id": 0,
- "cardnumber": null,
- "surname": null,
- "firstname": null,
- "title": "string",
- "other_name": "string",
- "initials": "string",
- "street_number": "string",
- "street_type": "string",
- "address": "string",
- "address2": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "country": "string",
- "email": null,
- "phone": null,
- "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",