From 0bcff6bca016b61b6cc1fd397f9022d57c751a7a Mon Sep 17 00:00:00 2001 From: Kyle M Hall Date: Sat, 1 Oct 2016 18:10:06 +0000 Subject: [PATCH] Bug 17390 - Update swagger.min.json --- api/v1/swagger/swagger.min.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/v1/swagger/swagger.min.json b/api/v1/swagger/swagger.min.json index 26760a6..8485e7c 100644 --- a/api/v1/swagger/swagger.min.json +++ b/api/v1/swagger/swagger.min.json @@ -1 +1 @@ -{"swagger":"2.0","paths":{"\/patrons":{"get":{"x-koha-authorization":{"permissions":{"borrowers":"1"}},"produces":["application\/json"],"tags":["patrons"],"responses":{"403":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Access forbidden"},"200":{"description":"A list of patrons","schema":{"type":"array","items":{"type":"object","properties":{"debarredcomment":{"type":["string","null"],"description":"comment on the stop of the patron"},"altcontactphone":{"type":["string","null"],"description":"the phone number for the alternate contact for the patron"},"contacttitle":{"type":["string","null"],"description":"used for children to include title of guarantor"},"updated_on":{"type":"string","description":"time of last change could be useful for synchronization with external systems (among others)"},"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"categorycode":{"description":"code of patron's category","type":"string"},"altcontactsurname":{"description":"surname or last name of the alternate contact for the patron","type":["string","null"]},"debarred":{"description":"until this date the patron can only check-in","type":["string","null"]},"smsalertnumber":{"type":["string","null"],"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)"},"guarantorid":{"description":"borrowernumber used for children or professionals to link them to guarantor or organizations","type":["string","null"]},"altcontactfirstname":{"type":["string","null"],"description":"first name of alternate contact for the patron"},"B_address":{"type":["string","null"],"description":"first address line of patron's alternate address"},"city":{"description":"city or town of patron's primary address","type":"string"},"flags":{"description":"a number associated with the patron's permissions","type":["string","null"]},"userid":{"type":["string","null"],"description":"patron's login"},"opacnote":{"type":["string","null"],"description":"a note on the patron's account visible in OPAC and staff client"},"altcontactcountry":{"description":"the country for the alternate contact for the patron","type":["string","null"]},"dateofbirth":{"description":"patron's date of birth","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"borrowernotes":{"description":"a note on the patron's account","type":["string","null"]},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"sort1":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"sms_provider_id":{"type":["string","null"],"description":"the provider of the mobile phone number defined in smsalertnumber"},"address2":{"description":"second address line of patron's primary address","type":["string","null"]},"B_phone":{"description":"phone number for patron's alternate address","type":["string","null"]},"address":{"type":"string","description":"first address line of patron's primary address"},"mobile":{"description":"the other phone number for patron's primary address","type":["string","null"]},"gonenoaddress":{"description":"set to 1 if library marked this patron as having an unconfirmed address","type":["string","null"]},"cardnumber":{"type":["string","null"],"description":"library assigned user identifier"},"contactname":{"description":"used for children and professionals to include surname or last name of guarantor or organization name","type":["string","null"]},"altcontactaddress1":{"type":["string","null"],"description":"the first address line for the alternate contact for the patron"},"lost":{"type":["string","null"],"description":"set to 1 if library marked this patron as having lost his card"},"fax":{"description":"fax number for patron's primary address","type":["string","null"]},"sex":{"description":"patron's gender","type":["string","null"]},"othernames":{"description":"any other names associated with the patron","type":["string","null"]},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"dateexpiry":{"type":["string","null"],"description":"date the patron's card is set to expire"},"checkprevcheckout":{"type":"string","description":"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'"},"altcontactaddress3":{"type":["string","null"],"description":"the city for the alternate contact for the patron"},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"contactfirstname":{"description":"used for children to include first name of guarantor","type":["string","null"]},"firstname":{"description":"patron's first name","type":["string","null"]},"dateenrolled":{"description":"date the patron was added to Koha","type":["string","null"]},"B_streettype":{"type":["string","null"],"description":"street type of patron's alternate address"},"contactnote":{"type":["string","null"],"description":"a note related to patron's alternate address"},"altcontactstate":{"type":["string","null"],"description":"the state for the alternate contact for the patron"},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"relationship":{"description":"used for children to include the relationship to their guarantor","type":["string","null"]},"B_state":{"description":"state or province of patron's alternate address","type":["string","null"]},"sort2":{"type":["string","null"],"description":"a field that can be used for any information unique to the library"},"B_streetnumber":{"type":["string","null"],"description":"street number of patron's alternate address"},"country":{"type":["string","null"],"description":"country of patron's primary address"},"zipcode":{"type":["string","null"],"description":"zip or postal code of patron's primary address"},"surname":{"type":"string","description":"patron's last name"},"state":{"type":["string","null"],"description":"state or province of patron's primary address"},"B_email":{"description":"email address for patron's alternate address","type":["string","null"]},"title":{"type":["string","null"],"description":"patron's title"},"phonepro":{"description":"secondary phone number for patron's primary address","type":["string","null"]},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"B_zipcode":{"description":"zip or postal code of patron's alternate address","type":["string","null"]},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"initials":{"type":["string","null"],"description":"initials of the patron"},"password":{"description":"patron's encrypted password","type":["string","null"]},"B_city":{"type":["string","null"],"description":"city or town of patron's alternate address"},"B_country":{"description":"country of patron's alternate address","type":["string","null"]},"streettype":{"type":["string","null"],"description":"street type of patron's primary address"},"email":{"description":"primary email address for patron's primary address","type":["string","null"]},"privacy":{"type":"string","description":"patron's privacy settings related to their reading history"}}}}}},"operationId":"listPatrons"}},"\/holds\/{reserve_id}":{"put":{"x-koha-authorization":{"allow-guarantor":true,"allow-owner":true,"permissions":{"reserveforothers":"1"}},"produces":["application\/json"],"responses":{"400":{"description":"Missing or wrong parameters","schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}}},"200":{"description":"Updated hold","schema":{"type":"object","properties":{"expirationdate":{"description":"the date the hold expires"},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"reservedate":{"description":"the date the hold was placed"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"suspend":{"description":""},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"notificationdate":{"description":"currently unused"},"reserve_id":{"description":"Internal hold identifier"},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"suspend_until":{"description":""},"reminderdate":{"description":"currently unused"},"priority":{"description":"where in the queue the patron sits"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"cancellationdate":{"description":"the date the hold was cancelled"},"timestamp":{"description":"date and time the hold was last updated"},"lowestPriority":{"description":""},"reservenotes":{"description":"notes related to this hold"}}}},"404":{"schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"description":"Hold not found"}},"tags":["holds"],"parameters":[{"required":true,"type":"integer","description":"Internal hold identifier","name":"reserve_id","in":"path"},{"schema":{"properties":{"suspend_until":{"type":"string","description":"Suspend until","format":"date"},"priority":{"minimum":1,"type":"integer","description":"Position in waiting queue"},"branchcode":{"description":"Pickup location","type":"string"}},"type":"object"},"required":true,"description":"A JSON object containing fields to modify","name":"body","in":"body"}],"operationId":"editHold","consumes":["application\/json"]},"delete":{"produces":["application\/json"],"x-koha-authorization":{"permissions":{"reserveforothers":"1"}},"responses":{"200":{"description":"Successful deletion","schema":{"type":"object"}},"404":{"schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"description":"Hold not found"}},"tags":["holds"],"operationId":"deleteHold","parameters":[{"in":"path","name":"reserve_id","description":"Internal hold identifier","type":"integer","required":true}]}},"\/patrons\/{borrowernumber}":{"get":{"parameters":[{"in":"path","name":"borrowernumber","required":true,"type":"integer","description":"Internal patron identifier"}],"operationId":"getPatron","responses":{"404":{"description":"Patron not found","schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"}},"403":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Access forbidden"},"200":{"description":"A patron","schema":{"properties":{"debarredcomment":{"type":["string","null"],"description":"comment on the stop of the patron"},"altcontactphone":{"type":["string","null"],"description":"the phone number for the alternate contact for the patron"},"contacttitle":{"type":["string","null"],"description":"used for children to include title of guarantor"},"updated_on":{"type":"string","description":"time of last change could be useful for synchronization with external systems (among others)"},"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"categorycode":{"description":"code of patron's category","type":"string"},"altcontactsurname":{"description":"surname or last name of the alternate contact for the patron","type":["string","null"]},"debarred":{"description":"until this date the patron can only check-in","type":["string","null"]},"smsalertnumber":{"type":["string","null"],"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)"},"guarantorid":{"description":"borrowernumber used for children or professionals to link them to guarantor or organizations","type":["string","null"]},"altcontactfirstname":{"type":["string","null"],"description":"first name of alternate contact for the patron"},"B_address":{"type":["string","null"],"description":"first address line of patron's alternate address"},"city":{"description":"city or town of patron's primary address","type":"string"},"flags":{"description":"a number associated with the patron's permissions","type":["string","null"]},"userid":{"type":["string","null"],"description":"patron's login"},"opacnote":{"type":["string","null"],"description":"a note on the patron's account visible in OPAC and staff client"},"altcontactcountry":{"description":"the country for the alternate contact for the patron","type":["string","null"]},"dateofbirth":{"description":"patron's date of birth","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"borrowernotes":{"description":"a note on the patron's account","type":["string","null"]},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"sort1":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"sms_provider_id":{"type":["string","null"],"description":"the provider of the mobile phone number defined in smsalertnumber"},"address2":{"description":"second address line of patron's primary address","type":["string","null"]},"B_phone":{"description":"phone number for patron's alternate address","type":["string","null"]},"address":{"type":"string","description":"first address line of patron's primary address"},"mobile":{"description":"the other phone number for patron's primary address","type":["string","null"]},"gonenoaddress":{"description":"set to 1 if library marked this patron as having an unconfirmed address","type":["string","null"]},"cardnumber":{"type":["string","null"],"description":"library assigned user identifier"},"contactname":{"description":"used for children and professionals to include surname or last name of guarantor or organization name","type":["string","null"]},"altcontactaddress1":{"type":["string","null"],"description":"the first address line for the alternate contact for the patron"},"lost":{"type":["string","null"],"description":"set to 1 if library marked this patron as having lost his card"},"fax":{"description":"fax number for patron's primary address","type":["string","null"]},"sex":{"description":"patron's gender","type":["string","null"]},"othernames":{"description":"any other names associated with the patron","type":["string","null"]},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"dateexpiry":{"type":["string","null"],"description":"date the patron's card is set to expire"},"checkprevcheckout":{"type":"string","description":"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'"},"altcontactaddress3":{"type":["string","null"],"description":"the city for the alternate contact for the patron"},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"contactfirstname":{"description":"used for children to include first name of guarantor","type":["string","null"]},"firstname":{"description":"patron's first name","type":["string","null"]},"dateenrolled":{"description":"date the patron was added to Koha","type":["string","null"]},"B_streettype":{"type":["string","null"],"description":"street type of patron's alternate address"},"contactnote":{"type":["string","null"],"description":"a note related to patron's alternate address"},"altcontactstate":{"type":["string","null"],"description":"the state for the alternate contact for the patron"},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"relationship":{"description":"used for children to include the relationship to their guarantor","type":["string","null"]},"B_state":{"description":"state or province of patron's alternate address","type":["string","null"]},"sort2":{"type":["string","null"],"description":"a field that can be used for any information unique to the library"},"B_streetnumber":{"type":["string","null"],"description":"street number of patron's alternate address"},"country":{"type":["string","null"],"description":"country of patron's primary address"},"zipcode":{"type":["string","null"],"description":"zip or postal code of patron's primary address"},"surname":{"type":"string","description":"patron's last name"},"state":{"type":["string","null"],"description":"state or province of patron's primary address"},"B_email":{"description":"email address for patron's alternate address","type":["string","null"]},"title":{"type":["string","null"],"description":"patron's title"},"phonepro":{"description":"secondary phone number for patron's primary address","type":["string","null"]},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"B_zipcode":{"description":"zip or postal code of patron's alternate address","type":["string","null"]},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"initials":{"type":["string","null"],"description":"initials of the patron"},"password":{"description":"patron's encrypted password","type":["string","null"]},"B_city":{"type":["string","null"],"description":"city or town of patron's alternate address"},"B_country":{"description":"country of patron's alternate address","type":["string","null"]},"streettype":{"type":["string","null"],"description":"street type of patron's primary address"},"email":{"description":"primary email address for patron's primary address","type":["string","null"]},"privacy":{"type":"string","description":"patron's privacy settings related to their reading history"}},"type":"object"}}},"tags":["patrons"],"produces":["application\/json"],"x-koha-authorization":{"allow-guarantor":true,"permissions":{"borrowers":"1"},"allow-owner":true}}},"\/holds":{"get":{"responses":{"200":{"description":"A list of holds","schema":{"items":{"type":"object","properties":{"expirationdate":{"description":"the date the hold expires"},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"reservedate":{"description":"the date the hold was placed"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"suspend":{"description":""},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"notificationdate":{"description":"currently unused"},"reserve_id":{"description":"Internal hold identifier"},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"suspend_until":{"description":""},"reminderdate":{"description":"currently unused"},"priority":{"description":"where in the queue the patron sits"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"cancellationdate":{"description":"the date the hold was cancelled"},"timestamp":{"description":"date and time the hold was last updated"},"lowestPriority":{"description":""},"reservenotes":{"description":"notes related to this hold"}}},"type":"array"}},"404":{"description":"Borrower not found","schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"}}},"tags":["borrowers","holds"],"produces":["application\/json"],"x-koha-authorization":{"allow-owner":true,"permissions":{"borrowers":"1"},"allow-guarantor":true},"operationId":"listHolds","parameters":[{"in":"query","name":"reserve_id","type":"integer","description":"Internal reserve identifier"},{"name":"borrowernumber","in":"query","description":"Internal borrower identifier","type":"integer"},{"name":"reservedate","in":"query","description":"Reserve date","type":"string"},{"description":"Internal biblio identifier","type":"integer","in":"query","name":"biblionumber"},{"in":"query","name":"branchcode","description":"Branch code","type":"string"},{"name":"notificationdate","in":"query","type":"string","description":"Notification date"},{"description":"Reminder date","type":"string","name":"reminderdate","in":"query"},{"name":"cancellationdate","in":"query","type":"string","description":"Cancellation date"},{"name":"reservenotes","in":"query","description":"Reserve notes","type":"string"},{"type":"integer","description":"Priority","in":"query","name":"priority"},{"description":"Found status","type":"string","in":"query","name":"found"},{"name":"timestamp","in":"query","description":"Time of latest update","type":"string"},{"type":"integer","description":"Internal item identifier","in":"query","name":"itemnumber"},{"type":"string","description":"Date the item was marked as waiting for the patron","name":"waitingdate","in":"query"},{"in":"query","name":"expirationdate","description":"Date the hold expires","type":"string"},{"in":"query","name":"lowestPriority","description":"Lowest priority","type":"integer"},{"type":"integer","description":"Suspended","name":"suspend","in":"query"},{"description":"Suspended until","type":"string","in":"query","name":"suspend_until"}]},"post":{"consumes":["application\/json"],"operationId":"addHold","parameters":[{"description":"A JSON object containing informations about the new hold","required":true,"schema":{"type":"object","properties":{"itemnumber":{"type":"integer","description":"Item internal identifier"},"biblionumber":{"type":"integer","description":"Biblio internal identifier"},"branchcode":{"type":"string","description":"Pickup location"},"expirationdate":{"format":"date","description":"Hold end date","type":"string"},"borrowernumber":{"type":"integer","description":"Borrower internal identifier"}}},"name":"body","in":"body"}],"responses":{"500":{"schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"description":"Internal error"},"400":{"description":"Missing or wrong parameters","schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}}},"201":{"description":"Created hold","schema":{"properties":{"expirationdate":{"description":"the date the hold expires"},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"reservedate":{"description":"the date the hold was placed"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"suspend":{"description":""},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"notificationdate":{"description":"currently unused"},"reserve_id":{"description":"Internal hold identifier"},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"suspend_until":{"description":""},"reminderdate":{"description":"currently unused"},"priority":{"description":"where in the queue the patron sits"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"cancellationdate":{"description":"the date the hold was cancelled"},"timestamp":{"description":"date and time the hold was last updated"},"lowestPriority":{"description":""},"reservenotes":{"description":"notes related to this hold"}},"type":"object"}},"404":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Borrower not found"},"403":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Hold not allowed"}},"tags":["borrowers","holds"],"produces":["application\/json"],"x-koha-authorization":{"permissions":{"reserveforothers":"1"},"allow-owner":true}}}},"parameters":{"borrowernumberPathParam":{"required":true,"type":"integer","description":"Internal patron identifier","name":"borrowernumber","in":"path"},"holdIdPathParam":{"description":"Internal hold identifier","required":true,"type":"integer","name":"reserve_id","in":"path"},"borrowernumberQueryParam":{"type":"integer","description":"Internal borrower identifier","name":"borrowernumber","in":"query"}},"x-mojo-around-action":"Koha::REST::V1::authenticate_api_request","definitions":{"hold":{"type":"object","properties":{"expirationdate":{"description":"the date the hold expires"},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"reservedate":{"description":"the date the hold was placed"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"suspend":{"description":""},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"notificationdate":{"description":"currently unused"},"reserve_id":{"description":"Internal hold identifier"},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"suspend_until":{"description":""},"reminderdate":{"description":"currently unused"},"priority":{"description":"where in the queue the patron sits"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"cancellationdate":{"description":"the date the hold was cancelled"},"timestamp":{"description":"date and time the hold was last updated"},"lowestPriority":{"description":""},"reservenotes":{"description":"notes related to this hold"}}},"holds":{"type":"array","items":{"type":"object","properties":{"expirationdate":{"description":"the date the hold expires"},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"reservedate":{"description":"the date the hold was placed"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"suspend":{"description":""},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"notificationdate":{"description":"currently unused"},"reserve_id":{"description":"Internal hold identifier"},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"suspend_until":{"description":""},"reminderdate":{"description":"currently unused"},"priority":{"description":"where in the queue the patron sits"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"cancellationdate":{"description":"the date the hold was cancelled"},"timestamp":{"description":"date and time the hold was last updated"},"lowestPriority":{"description":""},"reservenotes":{"description":"notes related to this hold"}}}},"patron":{"properties":{"debarredcomment":{"type":["string","null"],"description":"comment on the stop of the patron"},"altcontactphone":{"type":["string","null"],"description":"the phone number for the alternate contact for the patron"},"contacttitle":{"type":["string","null"],"description":"used for children to include title of guarantor"},"updated_on":{"type":"string","description":"time of last change could be useful for synchronization with external systems (among others)"},"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"categorycode":{"description":"code of patron's category","type":"string"},"altcontactsurname":{"description":"surname or last name of the alternate contact for the patron","type":["string","null"]},"debarred":{"description":"until this date the patron can only check-in","type":["string","null"]},"smsalertnumber":{"type":["string","null"],"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)"},"guarantorid":{"description":"borrowernumber used for children or professionals to link them to guarantor or organizations","type":["string","null"]},"altcontactfirstname":{"type":["string","null"],"description":"first name of alternate contact for the patron"},"B_address":{"type":["string","null"],"description":"first address line of patron's alternate address"},"city":{"description":"city or town of patron's primary address","type":"string"},"flags":{"description":"a number associated with the patron's permissions","type":["string","null"]},"userid":{"type":["string","null"],"description":"patron's login"},"opacnote":{"type":["string","null"],"description":"a note on the patron's account visible in OPAC and staff client"},"altcontactcountry":{"description":"the country for the alternate contact for the patron","type":["string","null"]},"dateofbirth":{"description":"patron's date of birth","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"borrowernotes":{"description":"a note on the patron's account","type":["string","null"]},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"sort1":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"sms_provider_id":{"type":["string","null"],"description":"the provider of the mobile phone number defined in smsalertnumber"},"address2":{"description":"second address line of patron's primary address","type":["string","null"]},"B_phone":{"description":"phone number for patron's alternate address","type":["string","null"]},"address":{"type":"string","description":"first address line of patron's primary address"},"mobile":{"description":"the other phone number for patron's primary address","type":["string","null"]},"gonenoaddress":{"description":"set to 1 if library marked this patron as having an unconfirmed address","type":["string","null"]},"cardnumber":{"type":["string","null"],"description":"library assigned user identifier"},"contactname":{"description":"used for children and professionals to include surname or last name of guarantor or organization name","type":["string","null"]},"altcontactaddress1":{"type":["string","null"],"description":"the first address line for the alternate contact for the patron"},"lost":{"type":["string","null"],"description":"set to 1 if library marked this patron as having lost his card"},"fax":{"description":"fax number for patron's primary address","type":["string","null"]},"sex":{"description":"patron's gender","type":["string","null"]},"othernames":{"description":"any other names associated with the patron","type":["string","null"]},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"dateexpiry":{"type":["string","null"],"description":"date the patron's card is set to expire"},"checkprevcheckout":{"type":"string","description":"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'"},"altcontactaddress3":{"type":["string","null"],"description":"the city for the alternate contact for the patron"},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"contactfirstname":{"description":"used for children to include first name of guarantor","type":["string","null"]},"firstname":{"description":"patron's first name","type":["string","null"]},"dateenrolled":{"description":"date the patron was added to Koha","type":["string","null"]},"B_streettype":{"type":["string","null"],"description":"street type of patron's alternate address"},"contactnote":{"type":["string","null"],"description":"a note related to patron's alternate address"},"altcontactstate":{"type":["string","null"],"description":"the state for the alternate contact for the patron"},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"relationship":{"description":"used for children to include the relationship to their guarantor","type":["string","null"]},"B_state":{"description":"state or province of patron's alternate address","type":["string","null"]},"sort2":{"type":["string","null"],"description":"a field that can be used for any information unique to the library"},"B_streetnumber":{"type":["string","null"],"description":"street number of patron's alternate address"},"country":{"type":["string","null"],"description":"country of patron's primary address"},"zipcode":{"type":["string","null"],"description":"zip or postal code of patron's primary address"},"surname":{"type":"string","description":"patron's last name"},"state":{"type":["string","null"],"description":"state or province of patron's primary address"},"B_email":{"description":"email address for patron's alternate address","type":["string","null"]},"title":{"type":["string","null"],"description":"patron's title"},"phonepro":{"description":"secondary phone number for patron's primary address","type":["string","null"]},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"B_zipcode":{"description":"zip or postal code of patron's alternate address","type":["string","null"]},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"initials":{"type":["string","null"],"description":"initials of the patron"},"password":{"description":"patron's encrypted password","type":["string","null"]},"B_city":{"type":["string","null"],"description":"city or town of patron's alternate address"},"B_country":{"description":"country of patron's alternate address","type":["string","null"]},"streettype":{"type":["string","null"],"description":"street type of patron's primary address"},"email":{"description":"primary email address for patron's primary address","type":["string","null"]},"privacy":{"type":"string","description":"patron's privacy settings related to their reading history"}},"type":"object"},"error":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}}},"basePath":"\/api\/v1","info":{"version":"1","title":"Koha REST API","license":{"name":"GPL v3","url":"http:\/\/www.gnu.org\/licenses\/gpl.txt"},"contact":{"url":"http:\/\/koha-community.org\/","name":"Koha Team"}},"x-primitives":{"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"reserve_id":{"description":"Internal hold identifier"},"phone":{"type":["string","null"],"description":"primary phone number for patron's primary address"},"firstname":{"description":"patron's first name","type":["string","null"]},"itemnumber":{"description":"internally assigned item identifier","type":["string","null"]},"email":{"type":["string","null"],"description":"primary email address for patron's primary address"},"cardnumber":{"type":["string","null"],"description":"library assigned user identifier"},"surname":{"type":"string","description":"patron's last name"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"biblionumber":{"type":"string","description":"internally assigned biblio identifier"}}} \ No newline at end of file +{"info":{"contact":{"url":"http:\/\/koha-community.org\/","name":"Koha Team"},"version":"1","license":{"name":"GPL v3","url":"http:\/\/www.gnu.org\/licenses\/gpl.txt"},"title":"Koha REST API"},"paths":{"\/authorised_values":{"get":{"operationId":"listAuthorisedValues","responses":{"200":{"schema":{"items":{"type":"object","properties":{"lib_opac":{"type":["string","null"],"description":"The public interface description of this authorised value, if set"},"category":{"description":"The category of this authorised value"},"id":{"description":"The internal id for this authorised value"},"lib":{"description":"The staff interface description for this authorised value"},"imageurl":{"type":["string","null"],"description":"The url of the image associated with this authorised value, if any"},"authorised_value":{"description":"The code for this authorised value"}}},"type":"array"},"description":"A list of authorised values"},"403":{"description":"Access forbidden","schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"}}},"tags":["authorised","values"],"produces":["application\/json"]}},"\/patrons":{"get":{"produces":["application\/json"],"responses":{"200":{"description":"A list of patrons","schema":{"type":"array","items":{"properties":{"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"contactnote":{"description":"a note related to patron's alternate address","type":["string","null"]},"debarredcomment":{"description":"comment on the stop of the patron","type":["string","null"]},"userid":{"description":"patron's login","type":["string","null"]},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"initials":{"type":["string","null"],"description":"initials of the patron"},"gonenoaddress":{"description":"set to 1 if library marked this patron as having an unconfirmed address","type":["string","null"]},"categorycode":{"type":"string","description":"code of patron's category"},"title":{"description":"patron's title","type":["string","null"]},"mobile":{"description":"the other phone number for patron's primary address","type":["string","null"]},"guarantorid":{"type":["string","null"],"description":"borrowernumber used for children or professionals to link them to guarantor or organizations"},"surname":{"description":"patron's last name","type":"string"},"zipcode":{"description":"zip or postal code of patron's primary address","type":["string","null"]},"password":{"type":["string","null"],"description":"patron's encrypted password"},"sms_provider_id":{"description":"the provider of the mobile phone number defined in smsalertnumber","type":["string","null"]},"altcontactsurname":{"description":"surname or last name of the alternate contact for the patron","type":["string","null"]},"B_email":{"type":["string","null"],"description":"email address for patron's alternate address"},"B_address":{"description":"first address line of patron's alternate address","type":["string","null"]},"borrowernotes":{"type":["string","null"],"description":"a note on the patron's account"},"contacttitle":{"type":["string","null"],"description":"used for children to include title of guarantor"},"fax":{"type":["string","null"],"description":"fax number for patron's primary address"},"smsalertnumber":{"type":["string","null"],"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)"},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"address":{"description":"first address line of patron's primary address","type":"string"},"email":{"type":["string","null"],"description":"primary email address for patron's primary address"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"firstname":{"description":"patron's first name","type":["string","null"]},"dateofbirth":{"description":"patron's date of birth","type":["string","null"]},"B_zipcode":{"type":["string","null"],"description":"zip or postal code of patron's alternate address"},"B_streettype":{"description":"street type of patron's alternate address","type":["string","null"]},"address2":{"type":["string","null"],"description":"second address line of patron's primary address"},"privacy":{"description":"patron's privacy settings related to their reading history","type":"string"},"city":{"description":"city or town of patron's primary address","type":"string"},"altcontactaddress1":{"type":["string","null"],"description":"the first address line for the alternate contact for the patron"},"lost":{"type":["string","null"],"description":"set to 1 if library marked this patron as having lost his card"},"sex":{"description":"patron's gender","type":["string","null"]},"phonepro":{"description":"secondary phone number for patron's primary address","type":["string","null"]},"B_state":{"type":["string","null"],"description":"state or province of patron's alternate address"},"altcontactfirstname":{"description":"first name of alternate contact for the patron","type":["string","null"]},"checkprevcheckout":{"type":"string","description":"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'"},"B_streetnumber":{"description":"street number of patron's alternate address","type":["string","null"]},"sort1":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"opacnote":{"type":["string","null"],"description":"a note on the patron's account visible in OPAC and staff client"},"streettype":{"description":"street type of patron's primary address","type":["string","null"]},"cardnumber":{"description":"library assigned user identifier","type":["string","null"]},"altcontactcountry":{"type":["string","null"],"description":"the country for the alternate contact for the patron"},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"othernames":{"description":"any other names associated with the patron","type":["string","null"]},"contactname":{"description":"used for children and professionals to include surname or last name of guarantor or organization name","type":["string","null"]},"B_phone":{"description":"phone number for patron's alternate address","type":["string","null"]},"B_city":{"type":["string","null"],"description":"city or town of patron's alternate address"},"debarred":{"type":["string","null"],"description":"until this date the patron can only check-in"},"updated_on":{"type":"string","description":"time of last change could be useful for synchronization with external systems (among others)"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"country":{"description":"country of patron's primary address","type":["string","null"]},"B_country":{"description":"country of patron's alternate address","type":["string","null"]},"dateexpiry":{"description":"date the patron's card is set to expire","type":["string","null"]},"flags":{"description":"a number associated with the patron's permissions","type":["string","null"]},"dateenrolled":{"type":["string","null"],"description":"date the patron was added to Koha"},"altcontactstate":{"description":"the state for the alternate contact for the patron","type":["string","null"]},"sort2":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"relationship":{"type":["string","null"],"description":"used for children to include the relationship to their guarantor"},"altcontactaddress3":{"description":"the city for the alternate contact for the patron","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"contactfirstname":{"description":"used for children to include first name of guarantor","type":["string","null"]},"state":{"description":"state or province of patron's primary address","type":["string","null"]},"altcontactphone":{"description":"the phone number for the alternate contact for the patron","type":["string","null"]}},"type":"object"}}},"403":{"description":"Access forbidden","schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"}}},"tags":["patrons"],"x-koha-authorization":{"permissions":{"borrowers":"1"}},"operationId":"listPatrons"}},"\/holds\/{reserve_id}":{"put":{"tags":["holds"],"parameters":[{"description":"Internal hold identifier","required":true,"name":"reserve_id","type":"integer","in":"path"},{"in":"body","description":"A JSON object containing fields to modify","required":true,"schema":{"type":"object","properties":{"priority":{"description":"Position in waiting queue","minimum":1,"type":"integer"},"suspend_until":{"type":"string","format":"date","description":"Suspend until"},"branchcode":{"description":"Pickup location","type":"string"}}},"name":"body"}],"responses":{"404":{"description":"Hold not found","schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}}},"400":{"schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"description":"Missing or wrong parameters"},"200":{"description":"Updated hold","schema":{"properties":{"timestamp":{"description":"date and time the hold was last updated"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"priority":{"description":"where in the queue the patron sits"},"notificationdate":{"description":"currently unused"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"suspend":{"description":""},"expirationdate":{"description":"the date the hold expires"},"suspend_until":{"description":""},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"cancellationdate":{"description":"the date the hold was cancelled"},"lowestPriority":{"description":""},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"reservedate":{"description":"the date the hold was placed"},"biblionumber":{"type":"string","description":"internally assigned biblio identifier"},"reminderdate":{"description":"currently unused"},"reserve_id":{"description":"Internal hold identifier"},"reservenotes":{"description":"notes related to this hold"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"}},"type":"object"}}},"operationId":"editHold","x-koha-authorization":{"permissions":{"reserveforothers":"1"},"allow-guarantor":true,"allow-owner":true},"consumes":["application\/json"],"produces":["application\/json"]},"delete":{"tags":["holds"],"parameters":[{"type":"integer","in":"path","description":"Internal hold identifier","name":"reserve_id","required":true}],"responses":{"404":{"description":"Hold not found","schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}}},"200":{"description":"Successful deletion","schema":{"type":"object"}}},"x-koha-authorization":{"permissions":{"reserveforothers":"1"}},"operationId":"deleteHold","produces":["application\/json"]}},"\/holds":{"get":{"parameters":[{"in":"query","type":"integer","name":"reserve_id","description":"Internal reserve identifier"},{"name":"borrowernumber","description":"Internal borrower identifier","in":"query","type":"integer"},{"type":"string","in":"query","description":"Reserve date","name":"reservedate"},{"description":"Internal biblio identifier","name":"biblionumber","type":"integer","in":"query"},{"type":"string","in":"query","description":"Branch code","name":"branchcode"},{"in":"query","type":"string","name":"notificationdate","description":"Notification date"},{"description":"Reminder date","name":"reminderdate","type":"string","in":"query"},{"in":"query","type":"string","name":"cancellationdate","description":"Cancellation date"},{"name":"reservenotes","description":"Reserve notes","in":"query","type":"string"},{"description":"Priority","name":"priority","type":"integer","in":"query"},{"description":"Found status","name":"found","type":"string","in":"query"},{"type":"string","in":"query","description":"Time of latest update","name":"timestamp"},{"name":"itemnumber","description":"Internal item identifier","in":"query","type":"integer"},{"type":"string","in":"query","description":"Date the item was marked as waiting for the patron","name":"waitingdate"},{"description":"Date the hold expires","name":"expirationdate","type":"string","in":"query"},{"name":"lowestPriority","description":"Lowest priority","in":"query","type":"integer"},{"name":"suspend","description":"Suspended","in":"query","type":"integer"},{"name":"suspend_until","description":"Suspended until","in":"query","type":"string"}],"tags":["borrowers","holds"],"responses":{"200":{"schema":{"type":"array","items":{"type":"object","properties":{"timestamp":{"description":"date and time the hold was last updated"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"priority":{"description":"where in the queue the patron sits"},"notificationdate":{"description":"currently unused"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"suspend":{"description":""},"expirationdate":{"description":"the date the hold expires"},"suspend_until":{"description":""},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"cancellationdate":{"description":"the date the hold was cancelled"},"lowestPriority":{"description":""},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"reservedate":{"description":"the date the hold was placed"},"biblionumber":{"type":"string","description":"internally assigned biblio identifier"},"reminderdate":{"description":"currently unused"},"reserve_id":{"description":"Internal hold identifier"},"reservenotes":{"description":"notes related to this hold"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"}}}},"description":"A list of holds"},"404":{"schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"description":"Borrower not found"}},"operationId":"listHolds","x-koha-authorization":{"allow-owner":true,"allow-guarantor":true,"permissions":{"borrowers":"1"}},"produces":["application\/json"]},"post":{"responses":{"500":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Internal error"},"400":{"description":"Missing or wrong parameters","schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}}},"403":{"description":"Hold not allowed","schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"}},"201":{"description":"Created hold","schema":{"type":"object","properties":{"timestamp":{"description":"date and time the hold was last updated"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"priority":{"description":"where in the queue the patron sits"},"notificationdate":{"description":"currently unused"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"suspend":{"description":""},"expirationdate":{"description":"the date the hold expires"},"suspend_until":{"description":""},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"cancellationdate":{"description":"the date the hold was cancelled"},"lowestPriority":{"description":""},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"reservedate":{"description":"the date the hold was placed"},"biblionumber":{"type":"string","description":"internally assigned biblio identifier"},"reminderdate":{"description":"currently unused"},"reserve_id":{"description":"Internal hold identifier"},"reservenotes":{"description":"notes related to this hold"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"}}}},"404":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Borrower not found"}},"parameters":[{"in":"body","description":"A JSON object containing informations about the new hold","required":true,"schema":{"type":"object","properties":{"branchcode":{"description":"Pickup location","type":"string"},"itemnumber":{"description":"Item internal identifier","type":"integer"},"biblionumber":{"description":"Biblio internal identifier","type":"integer"},"expirationdate":{"type":"string","description":"Hold end date","format":"date"},"borrowernumber":{"description":"Borrower internal identifier","type":"integer"}}},"name":"body"}],"tags":["borrowers","holds"],"operationId":"addHold","x-koha-authorization":{"allow-owner":true,"permissions":{"reserveforothers":"1"}},"produces":["application\/json"],"consumes":["application\/json"]}},"\/patrons\/{borrowernumber}":{"get":{"x-koha-authorization":{"permissions":{"borrowers":"1"},"allow-guarantor":true,"allow-owner":true},"operationId":"getPatron","responses":{"403":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Access forbidden"},"200":{"description":"A patron","schema":{"properties":{"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"contactnote":{"description":"a note related to patron's alternate address","type":["string","null"]},"debarredcomment":{"description":"comment on the stop of the patron","type":["string","null"]},"userid":{"description":"patron's login","type":["string","null"]},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"initials":{"type":["string","null"],"description":"initials of the patron"},"gonenoaddress":{"description":"set to 1 if library marked this patron as having an unconfirmed address","type":["string","null"]},"categorycode":{"type":"string","description":"code of patron's category"},"title":{"description":"patron's title","type":["string","null"]},"mobile":{"description":"the other phone number for patron's primary address","type":["string","null"]},"guarantorid":{"type":["string","null"],"description":"borrowernumber used for children or professionals to link them to guarantor or organizations"},"surname":{"description":"patron's last name","type":"string"},"zipcode":{"description":"zip or postal code of patron's primary address","type":["string","null"]},"password":{"type":["string","null"],"description":"patron's encrypted password"},"sms_provider_id":{"description":"the provider of the mobile phone number defined in smsalertnumber","type":["string","null"]},"altcontactsurname":{"description":"surname or last name of the alternate contact for the patron","type":["string","null"]},"B_email":{"type":["string","null"],"description":"email address for patron's alternate address"},"B_address":{"description":"first address line of patron's alternate address","type":["string","null"]},"borrowernotes":{"type":["string","null"],"description":"a note on the patron's account"},"contacttitle":{"type":["string","null"],"description":"used for children to include title of guarantor"},"fax":{"type":["string","null"],"description":"fax number for patron's primary address"},"smsalertnumber":{"type":["string","null"],"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)"},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"address":{"description":"first address line of patron's primary address","type":"string"},"email":{"type":["string","null"],"description":"primary email address for patron's primary address"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"firstname":{"description":"patron's first name","type":["string","null"]},"dateofbirth":{"description":"patron's date of birth","type":["string","null"]},"B_zipcode":{"type":["string","null"],"description":"zip or postal code of patron's alternate address"},"B_streettype":{"description":"street type of patron's alternate address","type":["string","null"]},"address2":{"type":["string","null"],"description":"second address line of patron's primary address"},"privacy":{"description":"patron's privacy settings related to their reading history","type":"string"},"city":{"description":"city or town of patron's primary address","type":"string"},"altcontactaddress1":{"type":["string","null"],"description":"the first address line for the alternate contact for the patron"},"lost":{"type":["string","null"],"description":"set to 1 if library marked this patron as having lost his card"},"sex":{"description":"patron's gender","type":["string","null"]},"phonepro":{"description":"secondary phone number for patron's primary address","type":["string","null"]},"B_state":{"type":["string","null"],"description":"state or province of patron's alternate address"},"altcontactfirstname":{"description":"first name of alternate contact for the patron","type":["string","null"]},"checkprevcheckout":{"type":"string","description":"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'"},"B_streetnumber":{"description":"street number of patron's alternate address","type":["string","null"]},"sort1":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"opacnote":{"type":["string","null"],"description":"a note on the patron's account visible in OPAC and staff client"},"streettype":{"description":"street type of patron's primary address","type":["string","null"]},"cardnumber":{"description":"library assigned user identifier","type":["string","null"]},"altcontactcountry":{"type":["string","null"],"description":"the country for the alternate contact for the patron"},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"othernames":{"description":"any other names associated with the patron","type":["string","null"]},"contactname":{"description":"used for children and professionals to include surname or last name of guarantor or organization name","type":["string","null"]},"B_phone":{"description":"phone number for patron's alternate address","type":["string","null"]},"B_city":{"type":["string","null"],"description":"city or town of patron's alternate address"},"debarred":{"type":["string","null"],"description":"until this date the patron can only check-in"},"updated_on":{"type":"string","description":"time of last change could be useful for synchronization with external systems (among others)"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"country":{"description":"country of patron's primary address","type":["string","null"]},"B_country":{"description":"country of patron's alternate address","type":["string","null"]},"dateexpiry":{"description":"date the patron's card is set to expire","type":["string","null"]},"flags":{"description":"a number associated with the patron's permissions","type":["string","null"]},"dateenrolled":{"type":["string","null"],"description":"date the patron was added to Koha"},"altcontactstate":{"description":"the state for the alternate contact for the patron","type":["string","null"]},"sort2":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"relationship":{"type":["string","null"],"description":"used for children to include the relationship to their guarantor"},"altcontactaddress3":{"description":"the city for the alternate contact for the patron","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"contactfirstname":{"description":"used for children to include first name of guarantor","type":["string","null"]},"state":{"description":"state or province of patron's primary address","type":["string","null"]},"altcontactphone":{"description":"the phone number for the alternate contact for the patron","type":["string","null"]}},"type":"object"}},"404":{"schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"description":"Patron not found"}},"parameters":[{"in":"path","type":"integer","name":"borrowernumber","required":true,"description":"Internal patron identifier"}],"tags":["patrons"],"produces":["application\/json"]}}},"definitions":{"holds":{"type":"array","items":{"type":"object","properties":{"timestamp":{"description":"date and time the hold was last updated"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"priority":{"description":"where in the queue the patron sits"},"notificationdate":{"description":"currently unused"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"suspend":{"description":""},"expirationdate":{"description":"the date the hold expires"},"suspend_until":{"description":""},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"cancellationdate":{"description":"the date the hold was cancelled"},"lowestPriority":{"description":""},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"reservedate":{"description":"the date the hold was placed"},"biblionumber":{"type":"string","description":"internally assigned biblio identifier"},"reminderdate":{"description":"currently unused"},"reserve_id":{"description":"Internal hold identifier"},"reservenotes":{"description":"notes related to this hold"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"}}}},"error":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"authorised_value":{"properties":{"lib_opac":{"type":["string","null"],"description":"The public interface description of this authorised value, if set"},"category":{"description":"The category of this authorised value"},"id":{"description":"The internal id for this authorised value"},"lib":{"description":"The staff interface description for this authorised value"},"imageurl":{"type":["string","null"],"description":"The url of the image associated with this authorised value, if any"},"authorised_value":{"description":"The code for this authorised value"}},"type":"object"},"patron":{"type":"object","properties":{"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"contactnote":{"description":"a note related to patron's alternate address","type":["string","null"]},"debarredcomment":{"description":"comment on the stop of the patron","type":["string","null"]},"userid":{"description":"patron's login","type":["string","null"]},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"initials":{"type":["string","null"],"description":"initials of the patron"},"gonenoaddress":{"description":"set to 1 if library marked this patron as having an unconfirmed address","type":["string","null"]},"categorycode":{"type":"string","description":"code of patron's category"},"title":{"description":"patron's title","type":["string","null"]},"mobile":{"description":"the other phone number for patron's primary address","type":["string","null"]},"guarantorid":{"type":["string","null"],"description":"borrowernumber used for children or professionals to link them to guarantor or organizations"},"surname":{"description":"patron's last name","type":"string"},"zipcode":{"description":"zip or postal code of patron's primary address","type":["string","null"]},"password":{"type":["string","null"],"description":"patron's encrypted password"},"sms_provider_id":{"description":"the provider of the mobile phone number defined in smsalertnumber","type":["string","null"]},"altcontactsurname":{"description":"surname or last name of the alternate contact for the patron","type":["string","null"]},"B_email":{"type":["string","null"],"description":"email address for patron's alternate address"},"B_address":{"description":"first address line of patron's alternate address","type":["string","null"]},"borrowernotes":{"type":["string","null"],"description":"a note on the patron's account"},"contacttitle":{"type":["string","null"],"description":"used for children to include title of guarantor"},"fax":{"type":["string","null"],"description":"fax number for patron's primary address"},"smsalertnumber":{"type":["string","null"],"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)"},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"address":{"description":"first address line of patron's primary address","type":"string"},"email":{"type":["string","null"],"description":"primary email address for patron's primary address"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"firstname":{"description":"patron's first name","type":["string","null"]},"dateofbirth":{"description":"patron's date of birth","type":["string","null"]},"B_zipcode":{"type":["string","null"],"description":"zip or postal code of patron's alternate address"},"B_streettype":{"description":"street type of patron's alternate address","type":["string","null"]},"address2":{"type":["string","null"],"description":"second address line of patron's primary address"},"privacy":{"description":"patron's privacy settings related to their reading history","type":"string"},"city":{"description":"city or town of patron's primary address","type":"string"},"altcontactaddress1":{"type":["string","null"],"description":"the first address line for the alternate contact for the patron"},"lost":{"type":["string","null"],"description":"set to 1 if library marked this patron as having lost his card"},"sex":{"description":"patron's gender","type":["string","null"]},"phonepro":{"description":"secondary phone number for patron's primary address","type":["string","null"]},"B_state":{"type":["string","null"],"description":"state or province of patron's alternate address"},"altcontactfirstname":{"description":"first name of alternate contact for the patron","type":["string","null"]},"checkprevcheckout":{"type":"string","description":"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'"},"B_streetnumber":{"description":"street number of patron's alternate address","type":["string","null"]},"sort1":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"opacnote":{"type":["string","null"],"description":"a note on the patron's account visible in OPAC and staff client"},"streettype":{"description":"street type of patron's primary address","type":["string","null"]},"cardnumber":{"description":"library assigned user identifier","type":["string","null"]},"altcontactcountry":{"type":["string","null"],"description":"the country for the alternate contact for the patron"},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"othernames":{"description":"any other names associated with the patron","type":["string","null"]},"contactname":{"description":"used for children and professionals to include surname or last name of guarantor or organization name","type":["string","null"]},"B_phone":{"description":"phone number for patron's alternate address","type":["string","null"]},"B_city":{"type":["string","null"],"description":"city or town of patron's alternate address"},"debarred":{"type":["string","null"],"description":"until this date the patron can only check-in"},"updated_on":{"type":"string","description":"time of last change could be useful for synchronization with external systems (among others)"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"country":{"description":"country of patron's primary address","type":["string","null"]},"B_country":{"description":"country of patron's alternate address","type":["string","null"]},"dateexpiry":{"description":"date the patron's card is set to expire","type":["string","null"]},"flags":{"description":"a number associated with the patron's permissions","type":["string","null"]},"dateenrolled":{"type":["string","null"],"description":"date the patron was added to Koha"},"altcontactstate":{"description":"the state for the alternate contact for the patron","type":["string","null"]},"sort2":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"relationship":{"type":["string","null"],"description":"used for children to include the relationship to their guarantor"},"altcontactaddress3":{"description":"the city for the alternate contact for the patron","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"contactfirstname":{"description":"used for children to include first name of guarantor","type":["string","null"]},"state":{"description":"state or province of patron's primary address","type":["string","null"]},"altcontactphone":{"description":"the phone number for the alternate contact for the patron","type":["string","null"]}}},"hold":{"type":"object","properties":{"timestamp":{"description":"date and time the hold was last updated"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"priority":{"description":"where in the queue the patron sits"},"notificationdate":{"description":"currently unused"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"suspend":{"description":""},"expirationdate":{"description":"the date the hold expires"},"suspend_until":{"description":""},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"cancellationdate":{"description":"the date the hold was cancelled"},"lowestPriority":{"description":""},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"reservedate":{"description":"the date the hold was placed"},"biblionumber":{"type":"string","description":"internally assigned biblio identifier"},"reminderdate":{"description":"currently unused"},"reserve_id":{"description":"Internal hold identifier"},"reservenotes":{"description":"notes related to this hold"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"}}}},"parameters":{"borrowernumberPathParam":{"required":true,"name":"borrowernumber","description":"Internal patron identifier","in":"path","type":"integer"},"borrowernumberQueryParam":{"name":"borrowernumber","description":"Internal borrower identifier","in":"query","type":"integer"},"holdIdPathParam":{"in":"path","type":"integer","name":"reserve_id","required":true,"description":"Internal hold identifier"}},"x-primitives":{"cardnumber":{"description":"library assigned user identifier","type":["string","null"]},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"reserve_id":{"description":"Internal hold identifier"},"firstname":{"description":"patron's first name","type":["string","null"]},"email":{"type":["string","null"],"description":"primary email address for patron's primary address"},"biblionumber":{"type":"string","description":"internally assigned biblio identifier"},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"surname":{"type":"string","description":"patron's last name"},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"}},"x-mojo-around-action":"Koha::REST::V1::authenticate_api_request","basePath":"\/api\/v1","swagger":"2.0"} \ No newline at end of file -- 2.1.4