1 |
{"swagger":"2.0","x-primitives":{"phone":{"type":["string","null"],"description":"primary phone number for patron's primary address"},"reserve_id":{"description":"Internal hold identifier"},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"email":{"description":"primary email address for patron's primary address","type":["string","null"]},"firstname":{"description":"patron's first name","type":["string","null"]},"cardnumber":{"description":"library assigned user identifier","type":["string","null"]},"surname":{"type":"string","description":"patron's last name"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"itemnumber":{"description":"internally assigned item identifier","type":["string","null"]}},"info":{"title":"Koha REST API","license":{"url":"http:\/\/www.gnu.org\/licenses\/gpl.txt","name":"GPL v3"},"contact":{"url":"http:\/\/koha-community.org\/","name":"Koha Team"},"version":"1"},"paths":{"\/patrons\/{borrowernumber}":{"get":{"responses":{"403":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}},"description":"Access forbidden"},"200":{"schema":{"type":"object","properties":{"B_phone":{"type":["string","null"],"description":"phone number for patron's alternate address"},"dateexpiry":{"type":["string","null"],"description":"date the patron's card is set to expire"},"categorycode":{"type":"string","description":"code of patron's category"},"B_city":{"description":"city or town of patron's alternate address","type":["string","null"]},"initials":{"type":["string","null"],"description":"initials of the patron"},"address2":{"type":["string","null"],"description":"second address line of patron's primary address"},"guarantorid":{"description":"borrowernumber used for children or professionals to link them to guarantor or organizations","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'"},"altcontactstate":{"type":["string","null"],"description":"the state for the alternate contact for the patron"},"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"contactname":{"type":["string","null"],"description":"used for children and professionals to include surname or last name of guarantor or organization name"},"sort1":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"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"},"altcontactphone":{"description":"the phone number for the alternate contact for the patron","type":["string","null"]},"altcontactaddress3":{"type":["string","null"],"description":"the city for the alternate contact for the patron"},"B_email":{"description":"email address for patron's alternate address","type":["string","null"]},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"zipcode":{"type":["string","null"],"description":"zip or postal code of patron's primary address"},"dateofbirth":{"description":"patron's date of birth","type":["string","null"]},"state":{"description":"state or province of patron's primary address","type":["string","null"]},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"fax":{"description":"fax number for patron's primary address","type":["string","null"]},"updated_on":{"description":"time of last change could be useful for synchronization with external systems (among others)","type":"string"},"contactfirstname":{"type":["string","null"],"description":"used for children to include first name of guarantor"},"contacttitle":{"description":"used for children to include title of guarantor","type":["string","null"]},"sex":{"type":["string","null"],"description":"patron's gender"},"B_streetnumber":{"description":"street number of patron's alternate address","type":["string","null"]},"contactnote":{"description":"a note related to patron's alternate address","type":["string","null"]},"mobile":{"description":"the other phone number for patron's primary address","type":["string","null"]},"othernames":{"type":["string","null"],"description":"any other names associated with the patron"},"lost":{"type":["string","null"],"description":"set to 1 if library marked this patron as having lost his card"},"B_state":{"description":"state or province of patron's alternate address","type":["string","null"]},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"borrowernotes":{"type":["string","null"],"description":"a note on the patron's account"},"phonepro":{"type":["string","null"],"description":"secondary phone number for patron's primary address"},"country":{"description":"country of patron's primary address","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"streettype":{"type":["string","null"],"description":"street type of patron's primary address"},"title":{"type":["string","null"],"description":"patron's title"},"password":{"type":["string","null"],"description":"patron's encrypted password"},"city":{"description":"city or town of patron's primary address","type":"string"},"relationship":{"type":["string","null"],"description":"used for children to include the relationship to their guarantor"},"firstname":{"description":"patron's first name","type":["string","null"]},"altcontactcountry":{"description":"the country for the alternate contact for the patron","type":["string","null"]},"email":{"description":"primary email address for patron's primary address","type":["string","null"]},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"debarred":{"description":"until this date the patron can only check-in","type":["string","null"]},"privacy":{"type":"string","description":"patron's privacy settings related to their reading history"},"altcontactsurname":{"type":["string","null"],"description":"surname or last name of the alternate contact for the patron"},"sort2":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"userid":{"type":["string","null"],"description":"patron's login"},"surname":{"type":"string","description":"patron's last name"},"B_zipcode":{"description":"zip or postal code of patron's alternate address","type":["string","null"]},"altcontactaddress1":{"description":"the first address line for the alternate contact for the patron","type":["string","null"]},"sms_provider_id":{"description":"the provider of the mobile phone number defined in smsalertnumber","type":["string","null"]},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"address":{"description":"first address line of patron's primary address","type":"string"},"altcontactfirstname":{"type":["string","null"],"description":"first name of alternate contact for the patron"},"opacnote":{"description":"a note on the patron's account visible in OPAC and staff client","type":["string","null"]},"flags":{"type":["string","null"],"description":"a number associated with the patron's permissions"},"dateenrolled":{"type":["string","null"],"description":"date the patron was added to Koha"},"B_country":{"description":"country of patron's alternate address","type":["string","null"]},"B_streettype":{"description":"street type of patron's alternate address","type":["string","null"]},"debarredcomment":{"type":["string","null"],"description":"comment on the stop of the patron"},"B_address":{"description":"first address line of patron's alternate address","type":["string","null"]},"smsalertnumber":{"type":["string","null"],"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)"}}},"description":"A patron"},"404":{"description":"Patron not found","schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"operationId":"getPatron","parameters":[{"name":"borrowernumber","in":"path","required":true,"description":"Internal patron identifier","type":"integer"}],"produces":["application\/json"],"tags":["patrons"]}},"\/holds":{"post":{"produces":["application\/json"],"consumes":["application\/json"],"operationId":"addHold","parameters":[{"name":"body","schema":{"type":"object","properties":{"expirationdate":{"format":"date","description":"Hold end date","type":"string"},"branchcode":{"type":"string","description":"Pickup location"},"biblionumber":{"description":"Biblio internal identifier","type":"integer"},"borrowernumber":{"type":"integer","description":"Borrower internal identifier"},"itemnumber":{"description":"Item internal identifier","type":"integer"}}},"required":true,"in":"body","description":"A JSON object containing informations about the new hold"}],"responses":{"403":{"schema":{"properties":{"error":{"type":"string","description":"Error message"}},"type":"object"},"description":"Hold not allowed"},"400":{"description":"Missing or wrong parameters","schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}},"500":{"description":"Internal error","schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}},"404":{"schema":{"properties":{"error":{"type":"string","description":"Error message"}},"type":"object"},"description":"Borrower not found"},"201":{"description":"Created hold","schema":{"properties":{"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"reserve_id":{"description":"Internal hold identifier"},"reservedate":{"description":"the date the hold was placed"},"suspend_until":{"description":""},"notificationdate":{"description":"currently unused"},"cancellationdate":{"description":"the date the hold was cancelled"},"itemnumber":{"description":"internally assigned item identifier","type":["string","null"]},"suspend":{"description":""},"reservenotes":{"description":"notes related to this hold"},"itemtype":{"type":["string","null"],"description":"If record level hold, the optional itemtype of the item the patron is requesting"},"timestamp":{"description":"date and time the hold was last updated"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"expirationdate":{"description":"the date the hold expires"},"priority":{"description":"where in the queue the patron sits"},"reminderdate":{"description":"currently unused"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"lowestPriority":{"description":""}},"type":"object"}}},"tags":["borrowers","holds"]},"get":{"responses":{"404":{"schema":{"properties":{"error":{"type":"string","description":"Error message"}},"type":"object"},"description":"Borrower not found"},"200":{"description":"A list of holds","schema":{"type":"array","items":{"properties":{"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"reserve_id":{"description":"Internal hold identifier"},"reservedate":{"description":"the date the hold was placed"},"suspend_until":{"description":""},"notificationdate":{"description":"currently unused"},"cancellationdate":{"description":"the date the hold was cancelled"},"itemnumber":{"description":"internally assigned item identifier","type":["string","null"]},"suspend":{"description":""},"reservenotes":{"description":"notes related to this hold"},"itemtype":{"type":["string","null"],"description":"If record level hold, the optional itemtype of the item the patron is requesting"},"timestamp":{"description":"date and time the hold was last updated"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"expirationdate":{"description":"the date the hold expires"},"priority":{"description":"where in the queue the patron sits"},"reminderdate":{"description":"currently unused"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"lowestPriority":{"description":""}},"type":"object"}}}},"operationId":"listHolds","parameters":[{"name":"reserve_id","in":"query","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"},{"name":"biblionumber","in":"query","description":"Internal biblio identifier","type":"integer"},{"name":"branchcode","in":"query","description":"Branch code","type":"string"},{"description":"Notification date","type":"string","in":"query","name":"notificationdate"},{"name":"reminderdate","description":"Reminder date","type":"string","in":"query"},{"name":"cancellationdate","in":"query","description":"Cancellation date","type":"string"},{"in":"query","type":"string","description":"Reserve notes","name":"reservenotes"},{"type":"integer","description":"Priority","in":"query","name":"priority"},{"name":"found","type":"string","description":"Found status","in":"query"},{"in":"query","type":"string","description":"Time of latest update","name":"timestamp"},{"type":"integer","description":"Internal item identifier","in":"query","name":"itemnumber"},{"description":"Date the item was marked as waiting for the patron","type":"string","in":"query","name":"waitingdate"},{"in":"query","type":"string","description":"Date the hold expires","name":"expirationdate"},{"name":"lowestPriority","description":"Lowest priority","type":"integer","in":"query"},{"type":"integer","description":"Suspended","in":"query","name":"suspend"},{"name":"suspend_until","in":"query","description":"Suspended until","type":"string"}],"produces":["application\/json"],"tags":["borrowers","holds"]}},"\/accountlines":{"get":{"responses":{"200":{"description":"A list of accountlines","schema":{"items":{"type":"object","properties":{"note":{"description":"Accountline note"},"accountno":{"description":"?"},"accountlines_id":{"description":"Internal account line identifier"},"date":{"description":"Date when the account line was created"},"itemnumber":{"description":"Internal item identifier"},"accounttype":{"description":"Type of accountline"},"notify_level":{"description":"?"},"timestamp":{"description":"When the account line was last updated"},"amount":{"description":"Amount"},"borrowernumber":{"description":"Internal borrower identifier"},"time":{"description":"Time when the account line was created"},"meansofpayment":{"description":"Means of payment"},"description":{"description":"Description of account line"},"amountoutstanding":{"description":"Amount outstanding"},"notify_id":{"description":"?"},"manager_id":{"description":"Borrowernumber of user that created the account line"},"lastincrement":{"description":"?"}}},"type":"array"}},"403":{"schema":{"properties":{"error":{"type":"string","description":"Error message"}},"type":"object"},"description":"Access forbidden"}},"produces":["application\/json"],"operationId":"listAccountlines","tags":["accountlines"]}},"\/patrons":{"get":{"responses":{"200":{"schema":{"type":"array","items":{"type":"object","properties":{"B_phone":{"type":["string","null"],"description":"phone number for patron's alternate address"},"dateexpiry":{"type":["string","null"],"description":"date the patron's card is set to expire"},"categorycode":{"type":"string","description":"code of patron's category"},"B_city":{"description":"city or town of patron's alternate address","type":["string","null"]},"initials":{"type":["string","null"],"description":"initials of the patron"},"address2":{"type":["string","null"],"description":"second address line of patron's primary address"},"guarantorid":{"description":"borrowernumber used for children or professionals to link them to guarantor or organizations","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'"},"altcontactstate":{"type":["string","null"],"description":"the state for the alternate contact for the patron"},"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"contactname":{"type":["string","null"],"description":"used for children and professionals to include surname or last name of guarantor or organization name"},"sort1":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"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"},"altcontactphone":{"description":"the phone number for the alternate contact for the patron","type":["string","null"]},"altcontactaddress3":{"type":["string","null"],"description":"the city for the alternate contact for the patron"},"B_email":{"description":"email address for patron's alternate address","type":["string","null"]},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"zipcode":{"type":["string","null"],"description":"zip or postal code of patron's primary address"},"dateofbirth":{"description":"patron's date of birth","type":["string","null"]},"state":{"description":"state or province of patron's primary address","type":["string","null"]},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"fax":{"description":"fax number for patron's primary address","type":["string","null"]},"updated_on":{"description":"time of last change could be useful for synchronization with external systems (among others)","type":"string"},"contactfirstname":{"type":["string","null"],"description":"used for children to include first name of guarantor"},"contacttitle":{"description":"used for children to include title of guarantor","type":["string","null"]},"sex":{"type":["string","null"],"description":"patron's gender"},"B_streetnumber":{"description":"street number of patron's alternate address","type":["string","null"]},"contactnote":{"description":"a note related to patron's alternate address","type":["string","null"]},"mobile":{"description":"the other phone number for patron's primary address","type":["string","null"]},"othernames":{"type":["string","null"],"description":"any other names associated with the patron"},"lost":{"type":["string","null"],"description":"set to 1 if library marked this patron as having lost his card"},"B_state":{"description":"state or province of patron's alternate address","type":["string","null"]},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"borrowernotes":{"type":["string","null"],"description":"a note on the patron's account"},"phonepro":{"type":["string","null"],"description":"secondary phone number for patron's primary address"},"country":{"description":"country of patron's primary address","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"streettype":{"type":["string","null"],"description":"street type of patron's primary address"},"title":{"type":["string","null"],"description":"patron's title"},"password":{"type":["string","null"],"description":"patron's encrypted password"},"city":{"description":"city or town of patron's primary address","type":"string"},"relationship":{"type":["string","null"],"description":"used for children to include the relationship to their guarantor"},"firstname":{"description":"patron's first name","type":["string","null"]},"altcontactcountry":{"description":"the country for the alternate contact for the patron","type":["string","null"]},"email":{"description":"primary email address for patron's primary address","type":["string","null"]},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"debarred":{"description":"until this date the patron can only check-in","type":["string","null"]},"privacy":{"type":"string","description":"patron's privacy settings related to their reading history"},"altcontactsurname":{"type":["string","null"],"description":"surname or last name of the alternate contact for the patron"},"sort2":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"userid":{"type":["string","null"],"description":"patron's login"},"surname":{"type":"string","description":"patron's last name"},"B_zipcode":{"description":"zip or postal code of patron's alternate address","type":["string","null"]},"altcontactaddress1":{"description":"the first address line for the alternate contact for the patron","type":["string","null"]},"sms_provider_id":{"description":"the provider of the mobile phone number defined in smsalertnumber","type":["string","null"]},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"address":{"description":"first address line of patron's primary address","type":"string"},"altcontactfirstname":{"type":["string","null"],"description":"first name of alternate contact for the patron"},"opacnote":{"description":"a note on the patron's account visible in OPAC and staff client","type":["string","null"]},"flags":{"type":["string","null"],"description":"a number associated with the patron's permissions"},"dateenrolled":{"type":["string","null"],"description":"date the patron was added to Koha"},"B_country":{"description":"country of patron's alternate address","type":["string","null"]},"B_streettype":{"description":"street type of patron's alternate address","type":["string","null"]},"debarredcomment":{"type":["string","null"],"description":"comment on the stop of the patron"},"B_address":{"description":"first address line of patron's alternate address","type":["string","null"]},"smsalertnumber":{"type":["string","null"],"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)"}}}},"description":"A list of patrons"},"403":{"description":"Access forbidden","schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"produces":["application\/json"],"operationId":"listPatrons","tags":["patrons"]}},"\/accountlines\/{accountlines_id}":{"put":{"responses":{"404":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}},"description":"Accountline not found"},"400":{"schema":{"properties":{"error":{"type":"string","description":"Error message"}},"type":"object"},"description":"Missing or wrong parameters"},"403":{"description":"Access forbidden","schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}},"200":{"schema":{"properties":{"note":{"description":"Accountline note"},"accountno":{"description":"?"},"accountlines_id":{"description":"Internal account line identifier"},"date":{"description":"Date when the account line was created"},"itemnumber":{"description":"Internal item identifier"},"accounttype":{"description":"Type of accountline"},"notify_level":{"description":"?"},"timestamp":{"description":"When the account line was last updated"},"amount":{"description":"Amount"},"borrowernumber":{"description":"Internal borrower identifier"},"time":{"description":"Time when the account line was created"},"meansofpayment":{"description":"Means of payment"},"description":{"description":"Description of account line"},"amountoutstanding":{"description":"Amount outstanding"},"notify_id":{"description":"?"},"manager_id":{"description":"Borrowernumber of user that created the account line"},"lastincrement":{"description":"?"}},"type":"object"},"description":"Updated accountline"}},"parameters":[{"name":"accountlines_id","in":"path","required":true,"description":"Internal accountline identifier","type":"integer"},{"schema":{"type":"object","properties":{"amount":{"description":"Amount"},"amountoutstanding":{"description":"Amount outstanding"},"meansofpayment":{"description":"Means of payment"},"note":{"description":"Accountline note"}}},"name":"body","in":"body","required":true,"description":"A JSON object containing fields to modify"}],"operationId":"editAccountlines","produces":["application\/json"],"consumes":["application\/json"],"tags":["accountlines"]}},"\/holds\/{reserve_id}":{"delete":{"parameters":[{"required":true,"in":"path","type":"integer","description":"Internal hold identifier","name":"reserve_id"}],"operationId":"deleteHold","produces":["application\/json"],"responses":{"404":{"description":"Hold not found","schema":{"properties":{"error":{"type":"string","description":"Error message"}},"type":"object"}},"200":{"schema":{"type":"object"},"description":"Successful deletion"}},"tags":["holds"]},"put":{"tags":["holds"],"responses":{"400":{"schema":{"properties":{"error":{"type":"string","description":"Error message"}},"type":"object"},"description":"Missing or wrong parameters"},"200":{"description":"Updated hold","schema":{"properties":{"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"reserve_id":{"description":"Internal hold identifier"},"reservedate":{"description":"the date the hold was placed"},"suspend_until":{"description":""},"notificationdate":{"description":"currently unused"},"cancellationdate":{"description":"the date the hold was cancelled"},"itemnumber":{"description":"internally assigned item identifier","type":["string","null"]},"suspend":{"description":""},"reservenotes":{"description":"notes related to this hold"},"itemtype":{"type":["string","null"],"description":"If record level hold, the optional itemtype of the item the patron is requesting"},"timestamp":{"description":"date and time the hold was last updated"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"expirationdate":{"description":"the date the hold expires"},"priority":{"description":"where in the queue the patron sits"},"reminderdate":{"description":"currently unused"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"lowestPriority":{"description":""}},"type":"object"}},"404":{"description":"Hold not found","schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"parameters":[{"name":"reserve_id","required":true,"in":"path","type":"integer","description":"Internal hold identifier"},{"description":"A JSON object containing fields to modify","required":true,"in":"body","name":"body","schema":{"type":"object","properties":{"priority":{"description":"Position in waiting queue","type":"integer","minimum":1},"branchcode":{"description":"Pickup location","type":"string"},"suspend_until":{"format":"date","type":"string","description":"Suspend until"}}}}],"operationId":"editHold","consumes":["application\/json"],"produces":["application\/json"]}}},"basePath":"\/api\/v1","definitions":{"accountline":{"properties":{"note":{"description":"Accountline note"},"accountno":{"description":"?"},"accountlines_id":{"description":"Internal account line identifier"},"date":{"description":"Date when the account line was created"},"itemnumber":{"description":"Internal item identifier"},"accounttype":{"description":"Type of accountline"},"notify_level":{"description":"?"},"timestamp":{"description":"When the account line was last updated"},"amount":{"description":"Amount"},"borrowernumber":{"description":"Internal borrower identifier"},"time":{"description":"Time when the account line was created"},"meansofpayment":{"description":"Means of payment"},"description":{"description":"Description of account line"},"amountoutstanding":{"description":"Amount outstanding"},"notify_id":{"description":"?"},"manager_id":{"description":"Borrowernumber of user that created the account line"},"lastincrement":{"description":"?"}},"type":"object"},"patron":{"type":"object","properties":{"B_phone":{"type":["string","null"],"description":"phone number for patron's alternate address"},"dateexpiry":{"type":["string","null"],"description":"date the patron's card is set to expire"},"categorycode":{"type":"string","description":"code of patron's category"},"B_city":{"description":"city or town of patron's alternate address","type":["string","null"]},"initials":{"type":["string","null"],"description":"initials of the patron"},"address2":{"type":["string","null"],"description":"second address line of patron's primary address"},"guarantorid":{"description":"borrowernumber used for children or professionals to link them to guarantor or organizations","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'"},"altcontactstate":{"type":["string","null"],"description":"the state for the alternate contact for the patron"},"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"contactname":{"type":["string","null"],"description":"used for children and professionals to include surname or last name of guarantor or organization name"},"sort1":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"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"},"altcontactphone":{"description":"the phone number for the alternate contact for the patron","type":["string","null"]},"altcontactaddress3":{"type":["string","null"],"description":"the city for the alternate contact for the patron"},"B_email":{"description":"email address for patron's alternate address","type":["string","null"]},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"zipcode":{"type":["string","null"],"description":"zip or postal code of patron's primary address"},"dateofbirth":{"description":"patron's date of birth","type":["string","null"]},"state":{"description":"state or province of patron's primary address","type":["string","null"]},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"fax":{"description":"fax number for patron's primary address","type":["string","null"]},"updated_on":{"description":"time of last change could be useful for synchronization with external systems (among others)","type":"string"},"contactfirstname":{"type":["string","null"],"description":"used for children to include first name of guarantor"},"contacttitle":{"description":"used for children to include title of guarantor","type":["string","null"]},"sex":{"type":["string","null"],"description":"patron's gender"},"B_streetnumber":{"description":"street number of patron's alternate address","type":["string","null"]},"contactnote":{"description":"a note related to patron's alternate address","type":["string","null"]},"mobile":{"description":"the other phone number for patron's primary address","type":["string","null"]},"othernames":{"type":["string","null"],"description":"any other names associated with the patron"},"lost":{"type":["string","null"],"description":"set to 1 if library marked this patron as having lost his card"},"B_state":{"description":"state or province of patron's alternate address","type":["string","null"]},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"borrowernotes":{"type":["string","null"],"description":"a note on the patron's account"},"phonepro":{"type":["string","null"],"description":"secondary phone number for patron's primary address"},"country":{"description":"country of patron's primary address","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"streettype":{"type":["string","null"],"description":"street type of patron's primary address"},"title":{"type":["string","null"],"description":"patron's title"},"password":{"type":["string","null"],"description":"patron's encrypted password"},"city":{"description":"city or town of patron's primary address","type":"string"},"relationship":{"type":["string","null"],"description":"used for children to include the relationship to their guarantor"},"firstname":{"description":"patron's first name","type":["string","null"]},"altcontactcountry":{"description":"the country for the alternate contact for the patron","type":["string","null"]},"email":{"description":"primary email address for patron's primary address","type":["string","null"]},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"debarred":{"description":"until this date the patron can only check-in","type":["string","null"]},"privacy":{"type":"string","description":"patron's privacy settings related to their reading history"},"altcontactsurname":{"type":["string","null"],"description":"surname or last name of the alternate contact for the patron"},"sort2":{"description":"a field that can be used for any information unique to the library","type":["string","null"]},"userid":{"type":["string","null"],"description":"patron's login"},"surname":{"type":"string","description":"patron's last name"},"B_zipcode":{"description":"zip or postal code of patron's alternate address","type":["string","null"]},"altcontactaddress1":{"description":"the first address line for the alternate contact for the patron","type":["string","null"]},"sms_provider_id":{"description":"the provider of the mobile phone number defined in smsalertnumber","type":["string","null"]},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"address":{"description":"first address line of patron's primary address","type":"string"},"altcontactfirstname":{"type":["string","null"],"description":"first name of alternate contact for the patron"},"opacnote":{"description":"a note on the patron's account visible in OPAC and staff client","type":["string","null"]},"flags":{"type":["string","null"],"description":"a number associated with the patron's permissions"},"dateenrolled":{"type":["string","null"],"description":"date the patron was added to Koha"},"B_country":{"description":"country of patron's alternate address","type":["string","null"]},"B_streettype":{"description":"street type of patron's alternate address","type":["string","null"]},"debarredcomment":{"type":["string","null"],"description":"comment on the stop of the patron"},"B_address":{"description":"first address line of patron's alternate address","type":["string","null"]},"smsalertnumber":{"type":["string","null"],"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)"}}},"holds":{"items":{"properties":{"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"reserve_id":{"description":"Internal hold identifier"},"reservedate":{"description":"the date the hold was placed"},"suspend_until":{"description":""},"notificationdate":{"description":"currently unused"},"cancellationdate":{"description":"the date the hold was cancelled"},"itemnumber":{"description":"internally assigned item identifier","type":["string","null"]},"suspend":{"description":""},"reservenotes":{"description":"notes related to this hold"},"itemtype":{"type":["string","null"],"description":"If record level hold, the optional itemtype of the item the patron is requesting"},"timestamp":{"description":"date and time the hold was last updated"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"expirationdate":{"description":"the date the hold expires"},"priority":{"description":"where in the queue the patron sits"},"reminderdate":{"description":"currently unused"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"lowestPriority":{"description":""}},"type":"object"},"type":"array"},"error":{"properties":{"error":{"type":"string","description":"Error message"}},"type":"object"},"hold":{"properties":{"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"reserve_id":{"description":"Internal hold identifier"},"reservedate":{"description":"the date the hold was placed"},"suspend_until":{"description":""},"notificationdate":{"description":"currently unused"},"cancellationdate":{"description":"the date the hold was cancelled"},"itemnumber":{"description":"internally assigned item identifier","type":["string","null"]},"suspend":{"description":""},"reservenotes":{"description":"notes related to this hold"},"itemtype":{"type":["string","null"],"description":"If record level hold, the optional itemtype of the item the patron is requesting"},"timestamp":{"description":"date and time the hold was last updated"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"expirationdate":{"description":"the date the hold expires"},"priority":{"description":"where in the queue the patron sits"},"reminderdate":{"description":"currently unused"},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"lowestPriority":{"description":""}},"type":"object"}},"parameters":{"accountlinesIdPathParam":{"in":"path","required":true,"description":"Internal accountline identifier","type":"integer","name":"accountlines_id"},"borrowernumberPathParam":{"required":true,"in":"path","type":"integer","description":"Internal patron identifier","name":"borrowernumber"},"holdIdPathParam":{"in":"path","required":true,"description":"Internal hold identifier","type":"integer","name":"reserve_id"},"borrowernumberQueryParam":{"in":"query","description":"Internal borrower identifier","type":"integer","name":"borrowernumber"}}} |
1 |
{"swagger":"2.0","parameters":{"borrowernumberPathParam":{"required":true,"in":"path","description":"Internal patron identifier","type":"integer","name":"borrowernumber"},"holdIdPathParam":{"description":"Internal hold identifier","name":"reserve_id","type":"integer","in":"path","required":true},"borrowernumberQueryParam":{"in":"query","type":"integer","name":"borrowernumber","description":"Internal borrower identifier"},"accountlinesIdPathParam":{"in":"path","required":true,"description":"Internal accountline identifier","type":"integer","name":"accountlines_id"}},"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"}},"definitions":{"holds":{"items":{"properties":{"suspend_until":{"description":""},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"reservedate":{"description":"the date the hold was placed"},"reservenotes":{"description":"notes related to this hold"},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"lowestPriority":{"description":""},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"notificationdate":{"description":"currently unused"},"expirationdate":{"description":"the date the hold expires"},"reminderdate":{"description":"currently unused"},"priority":{"description":"where in the queue the patron sits"},"reserve_id":{"description":"Internal hold identifier"},"cancellationdate":{"description":"the date the hold was cancelled"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"timestamp":{"description":"date and time the hold was last updated"},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"suspend":{"description":""}},"type":"object"},"type":"array"},"accountline":{"properties":{"meansofpayment":{"description":"Means of payment"},"date":{"description":"Date when the account line was created"},"note":{"description":"Accountline note"},"amount":{"description":"Amount"},"manager_id":{"description":"Borrowernumber of user that created the account line"},"accountlines_id":{"description":"Internal account line identifier"},"time":{"description":"Time when the account line was created"},"lastincrement":{"description":"?"},"accountno":{"description":"?"},"itemnumber":{"description":"Internal item identifier"},"amountoutstanding":{"description":"Amount outstanding"},"notify_level":{"description":"?"},"notify_id":{"description":"?"},"borrowernumber":{"description":"Internal borrower identifier"},"timestamp":{"description":"When the account line was last updated"},"description":{"description":"Description of account line"},"accounttype":{"description":"Type of accountline"}},"type":"object"},"patron":{"type":"object","properties":{"altcontactaddress1":{"description":"the first address line for the alternate contact for the patron","type":["string","null"]},"B_phone":{"description":"phone number for patron's alternate address","type":["string","null"]},"altcontactfirstname":{"description":"first name of alternate contact for the patron","type":["string","null"]},"relationship":{"type":["string","null"],"description":"used for children to include the relationship to their guarantor"},"address":{"type":"string","description":"first address line of patron's primary address"},"othernames":{"type":["string","null"],"description":"any other names associated with the patron"},"smsalertnumber":{"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)","type":["string","null"]},"password":{"type":["string","null"],"description":"patron's encrypted password"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"initials":{"type":["string","null"],"description":"initials of the patron"},"borrowernotes":{"type":["string","null"],"description":"a note on the patron's account"},"B_country":{"type":["string","null"],"description":"country of patron's alternate address"},"updated_on":{"type":"string","description":"time of last change could be useful for synchronization with external systems (among others)"},"city":{"type":"string","description":"city or town of patron's primary address"},"userid":{"description":"patron's login","type":["string","null"]},"debarred":{"type":["string","null"],"description":"until this date the patron can only check-in"},"lost":{"description":"set to 1 if library marked this patron as having lost his card","type":["string","null"]},"guarantorid":{"description":"borrowernumber used for children or professionals to link them to guarantor or organizations","type":["string","null"]},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"debarredcomment":{"description":"comment on the stop of the patron","type":["string","null"]},"country":{"type":["string","null"],"description":"country of patron's primary address"},"sex":{"type":["string","null"],"description":"patron's gender"},"opacnote":{"description":"a note on the patron's account visible in OPAC and staff client","type":["string","null"]},"altcontactphone":{"description":"the phone number for the alternate contact for the patron","type":["string","null"]},"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"altcontactsurname":{"type":["string","null"],"description":"surname or last name of the alternate contact for the patron"},"B_email":{"description":"email address for patron's alternate address","type":["string","null"]},"categorycode":{"description":"code of patron's category","type":"string"},"contacttitle":{"type":["string","null"],"description":"used for children to include title of guarantor"},"surname":{"type":"string","description":"patron's last name"},"altcontactcountry":{"type":["string","null"],"description":"the country for the alternate contact for the patron"},"title":{"type":["string","null"],"description":"patron's title"},"contactnote":{"type":["string","null"],"description":"a note related to patron's alternate address"},"sms_provider_id":{"type":["string","null"],"description":"the provider of the mobile phone number defined in smsalertnumber"},"B_city":{"description":"city or town of patron's alternate address","type":["string","null"]},"fax":{"description":"fax number for patron's primary address","type":["string","null"]},"B_state":{"description":"state or province of patron's alternate address","type":["string","null"]},"altcontactaddress3":{"description":"the city for the alternate contact for the patron","type":["string","null"]},"firstname":{"description":"patron's first name","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"mobile":{"type":["string","null"],"description":"the other phone number for patron's primary address"},"B_address":{"type":["string","null"],"description":"first address line of patron's alternate address"},"email":{"type":["string","null"],"description":"primary email address for patron's primary address"},"altcontactstate":{"type":["string","null"],"description":"the state for the alternate contact for the patron"},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"dateexpiry":{"type":["string","null"],"description":"date the patron's card is set to expire"},"B_zipcode":{"type":["string","null"],"description":"zip or postal code of patron's alternate address"},"dateofbirth":{"type":["string","null"],"description":"patron's date of birth"},"gonenoaddress":{"description":"set to 1 if library marked this patron as having an unconfirmed address","type":["string","null"]},"phonepro":{"description":"secondary phone number for patron's primary address","type":["string","null"]},"dateenrolled":{"description":"date the patron was added to Koha","type":["string","null"]},"contactfirstname":{"type":["string","null"],"description":"used for children to include first name of guarantor"},"privacy":{"type":"string","description":"patron's privacy settings related to their reading history"},"address2":{"type":["string","null"],"description":"second address line of patron's primary address"},"state":{"type":["string","null"],"description":"state or province of patron's primary address"},"flags":{"type":["string","null"],"description":"a number associated with the patron's permissions"},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"zipcode":{"type":["string","null"],"description":"zip or postal code of patron's primary address"},"checkprevcheckout":{"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'","type":"string"},"sort2":{"type":["string","null"],"description":"a field that can be used for any information unique to the library"},"cardnumber":{"type":["string","null"],"description":"library assigned user identifier"},"streettype":{"type":["string","null"],"description":"street type of patron's primary address"},"B_streetnumber":{"type":["string","null"],"description":"street number of patron's alternate address"},"contactname":{"type":["string","null"],"description":"used for children and professionals to include surname or last name of guarantor or organization name"},"B_streettype":{"description":"street type of patron's alternate address","type":["string","null"]},"sort1":{"type":["string","null"],"description":"a field that can be used for any information unique to the library"}}},"error":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"hold":{"properties":{"suspend_until":{"description":""},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"reservedate":{"description":"the date the hold was placed"},"reservenotes":{"description":"notes related to this hold"},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"lowestPriority":{"description":""},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"notificationdate":{"description":"currently unused"},"expirationdate":{"description":"the date the hold expires"},"reminderdate":{"description":"currently unused"},"priority":{"description":"where in the queue the patron sits"},"reserve_id":{"description":"Internal hold identifier"},"cancellationdate":{"description":"the date the hold was cancelled"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"timestamp":{"description":"date and time the hold was last updated"},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"suspend":{"description":""}},"type":"object"}},"paths":{"\/holds":{"post":{"tags":["borrowers","holds"],"operationId":"addHold","parameters":[{"description":"A JSON object containing informations about the new hold","schema":{"properties":{"itemnumber":{"type":"integer","description":"Item internal identifier"},"expirationdate":{"format":"date","type":"string","description":"Hold end date"},"borrowernumber":{"type":"integer","description":"Borrower internal identifier"},"biblionumber":{"type":"integer","description":"Biblio internal identifier"},"branchcode":{"type":"string","description":"Pickup location"}},"type":"object"},"name":"body","required":true,"in":"body"}],"consumes":["application\/json"],"responses":{"201":{"description":"Created hold","schema":{"type":"object","properties":{"suspend_until":{"description":""},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"reservedate":{"description":"the date the hold was placed"},"reservenotes":{"description":"notes related to this hold"},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"lowestPriority":{"description":""},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"notificationdate":{"description":"currently unused"},"expirationdate":{"description":"the date the hold expires"},"reminderdate":{"description":"currently unused"},"priority":{"description":"where in the queue the patron sits"},"reserve_id":{"description":"Internal hold identifier"},"cancellationdate":{"description":"the date the hold was cancelled"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"timestamp":{"description":"date and time the hold was last updated"},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"suspend":{"description":""}}}},"403":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Hold not allowed"},"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"}}}},"404":{"schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"description":"Borrower not found"}},"produces":["application\/json"]},"get":{"responses":{"200":{"description":"A list of holds","schema":{"type":"array","items":{"properties":{"suspend_until":{"description":""},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"reservedate":{"description":"the date the hold was placed"},"reservenotes":{"description":"notes related to this hold"},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"lowestPriority":{"description":""},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"notificationdate":{"description":"currently unused"},"expirationdate":{"description":"the date the hold expires"},"reminderdate":{"description":"currently unused"},"priority":{"description":"where in the queue the patron sits"},"reserve_id":{"description":"Internal hold identifier"},"cancellationdate":{"description":"the date the hold was cancelled"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"timestamp":{"description":"date and time the hold was last updated"},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"suspend":{"description":""}},"type":"object"}}},"404":{"schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"description":"Borrower not found"}},"produces":["application\/json"],"parameters":[{"in":"query","name":"reserve_id","type":"integer","description":"Internal reserve identifier"},{"in":"query","description":"Internal borrower identifier","type":"integer","name":"borrowernumber"},{"type":"string","name":"reservedate","description":"Reserve date","in":"query"},{"in":"query","name":"biblionumber","type":"integer","description":"Internal biblio identifier"},{"description":"Branch code","name":"branchcode","type":"string","in":"query"},{"type":"string","name":"notificationdate","description":"Notification date","in":"query"},{"in":"query","name":"reminderdate","type":"string","description":"Reminder date"},{"in":"query","description":"Cancellation date","name":"cancellationdate","type":"string"},{"description":"Reserve notes","type":"string","name":"reservenotes","in":"query"},{"type":"integer","name":"priority","description":"Priority","in":"query"},{"description":"Found status","type":"string","name":"found","in":"query"},{"in":"query","description":"Time of latest update","name":"timestamp","type":"string"},{"in":"query","name":"itemnumber","type":"integer","description":"Internal item identifier"},{"in":"query","type":"string","name":"waitingdate","description":"Date the item was marked as waiting for the patron"},{"description":"Date the hold expires","name":"expirationdate","type":"string","in":"query"},{"description":"Lowest priority","name":"lowestPriority","type":"integer","in":"query"},{"in":"query","type":"integer","name":"suspend","description":"Suspended"},{"in":"query","description":"Suspended until","name":"suspend_until","type":"string"}],"operationId":"listHolds","tags":["borrowers","holds"]}},"\/patrons\/{borrowernumber}":{"get":{"parameters":[{"description":"Internal patron identifier","type":"integer","name":"borrowernumber","in":"path","required":true}],"produces":["application\/json"],"responses":{"404":{"description":"Patron not found","schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"}},"200":{"description":"A patron","schema":{"type":"object","properties":{"altcontactaddress1":{"description":"the first address line for the alternate contact for the patron","type":["string","null"]},"B_phone":{"description":"phone number for patron's alternate address","type":["string","null"]},"altcontactfirstname":{"description":"first name of alternate contact for the patron","type":["string","null"]},"relationship":{"type":["string","null"],"description":"used for children to include the relationship to their guarantor"},"address":{"type":"string","description":"first address line of patron's primary address"},"othernames":{"type":["string","null"],"description":"any other names associated with the patron"},"smsalertnumber":{"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)","type":["string","null"]},"password":{"type":["string","null"],"description":"patron's encrypted password"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"initials":{"type":["string","null"],"description":"initials of the patron"},"borrowernotes":{"type":["string","null"],"description":"a note on the patron's account"},"B_country":{"type":["string","null"],"description":"country of patron's alternate address"},"updated_on":{"type":"string","description":"time of last change could be useful for synchronization with external systems (among others)"},"city":{"type":"string","description":"city or town of patron's primary address"},"userid":{"description":"patron's login","type":["string","null"]},"debarred":{"type":["string","null"],"description":"until this date the patron can only check-in"},"lost":{"description":"set to 1 if library marked this patron as having lost his card","type":["string","null"]},"guarantorid":{"description":"borrowernumber used for children or professionals to link them to guarantor or organizations","type":["string","null"]},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"debarredcomment":{"description":"comment on the stop of the patron","type":["string","null"]},"country":{"type":["string","null"],"description":"country of patron's primary address"},"sex":{"type":["string","null"],"description":"patron's gender"},"opacnote":{"description":"a note on the patron's account visible in OPAC and staff client","type":["string","null"]},"altcontactphone":{"description":"the phone number for the alternate contact for the patron","type":["string","null"]},"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"altcontactsurname":{"type":["string","null"],"description":"surname or last name of the alternate contact for the patron"},"B_email":{"description":"email address for patron's alternate address","type":["string","null"]},"categorycode":{"description":"code of patron's category","type":"string"},"contacttitle":{"type":["string","null"],"description":"used for children to include title of guarantor"},"surname":{"type":"string","description":"patron's last name"},"altcontactcountry":{"type":["string","null"],"description":"the country for the alternate contact for the patron"},"title":{"type":["string","null"],"description":"patron's title"},"contactnote":{"type":["string","null"],"description":"a note related to patron's alternate address"},"sms_provider_id":{"type":["string","null"],"description":"the provider of the mobile phone number defined in smsalertnumber"},"B_city":{"description":"city or town of patron's alternate address","type":["string","null"]},"fax":{"description":"fax number for patron's primary address","type":["string","null"]},"B_state":{"description":"state or province of patron's alternate address","type":["string","null"]},"altcontactaddress3":{"description":"the city for the alternate contact for the patron","type":["string","null"]},"firstname":{"description":"patron's first name","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"mobile":{"type":["string","null"],"description":"the other phone number for patron's primary address"},"B_address":{"type":["string","null"],"description":"first address line of patron's alternate address"},"email":{"type":["string","null"],"description":"primary email address for patron's primary address"},"altcontactstate":{"type":["string","null"],"description":"the state for the alternate contact for the patron"},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"dateexpiry":{"type":["string","null"],"description":"date the patron's card is set to expire"},"B_zipcode":{"type":["string","null"],"description":"zip or postal code of patron's alternate address"},"dateofbirth":{"type":["string","null"],"description":"patron's date of birth"},"gonenoaddress":{"description":"set to 1 if library marked this patron as having an unconfirmed address","type":["string","null"]},"phonepro":{"description":"secondary phone number for patron's primary address","type":["string","null"]},"dateenrolled":{"description":"date the patron was added to Koha","type":["string","null"]},"contactfirstname":{"type":["string","null"],"description":"used for children to include first name of guarantor"},"privacy":{"type":"string","description":"patron's privacy settings related to their reading history"},"address2":{"type":["string","null"],"description":"second address line of patron's primary address"},"state":{"type":["string","null"],"description":"state or province of patron's primary address"},"flags":{"type":["string","null"],"description":"a number associated with the patron's permissions"},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"zipcode":{"type":["string","null"],"description":"zip or postal code of patron's primary address"},"checkprevcheckout":{"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'","type":"string"},"sort2":{"type":["string","null"],"description":"a field that can be used for any information unique to the library"},"cardnumber":{"type":["string","null"],"description":"library assigned user identifier"},"streettype":{"type":["string","null"],"description":"street type of patron's primary address"},"B_streetnumber":{"type":["string","null"],"description":"street number of patron's alternate address"},"contactname":{"type":["string","null"],"description":"used for children and professionals to include surname or last name of guarantor or organization name"},"B_streettype":{"description":"street type of patron's alternate address","type":["string","null"]},"sort1":{"type":["string","null"],"description":"a field that can be used for any information unique to the library"}}}},"403":{"description":"Access forbidden","schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}}}},"operationId":"getPatron","tags":["patrons"]}},"\/accountlines":{"get":{"tags":["accountlines"],"operationId":"listAccountlines","responses":{"403":{"schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"description":"Access forbidden"},"200":{"schema":{"items":{"type":"object","properties":{"meansofpayment":{"description":"Means of payment"},"date":{"description":"Date when the account line was created"},"note":{"description":"Accountline note"},"amount":{"description":"Amount"},"manager_id":{"description":"Borrowernumber of user that created the account line"},"accountlines_id":{"description":"Internal account line identifier"},"time":{"description":"Time when the account line was created"},"lastincrement":{"description":"?"},"accountno":{"description":"?"},"itemnumber":{"description":"Internal item identifier"},"amountoutstanding":{"description":"Amount outstanding"},"notify_level":{"description":"?"},"notify_id":{"description":"?"},"borrowernumber":{"description":"Internal borrower identifier"},"timestamp":{"description":"When the account line was last updated"},"description":{"description":"Description of account line"},"accounttype":{"description":"Type of accountline"}}},"type":"array"},"description":"A list of accountlines"}},"produces":["application\/json"]}},"\/accountlines\/{accountlines_id}\/payment":{"post":{"operationId":"payAccountlines","tags":["accountlines"],"consumes":["application\/json"],"parameters":[{"type":"integer","name":"accountlines_id","description":"Internal accountline identifier","in":"path","required":true},{"description":"A JSON object containing fields to modify","schema":{"properties":{"note":{"description":"Payment note"},"amount":{"description":"Amount to pay"}},"type":"object"},"name":"body","in":"body"}],"produces":["application\/json"],"responses":{"400":{"description":"Missing or wrong parameters","schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}}},"404":{"description":"Accountline not found","schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}}},"200":{"description":"Paid accountline","schema":{"type":"object","properties":{"meansofpayment":{"description":"Means of payment"},"date":{"description":"Date when the account line was created"},"note":{"description":"Accountline note"},"amount":{"description":"Amount"},"manager_id":{"description":"Borrowernumber of user that created the account line"},"accountlines_id":{"description":"Internal account line identifier"},"time":{"description":"Time when the account line was created"},"lastincrement":{"description":"?"},"accountno":{"description":"?"},"itemnumber":{"description":"Internal item identifier"},"amountoutstanding":{"description":"Amount outstanding"},"notify_level":{"description":"?"},"notify_id":{"description":"?"},"borrowernumber":{"description":"Internal borrower identifier"},"timestamp":{"description":"When the account line was last updated"},"description":{"description":"Description of account line"},"accounttype":{"description":"Type of accountline"}}}},"403":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Access forbidden"}}}},"\/holds\/{reserve_id}":{"put":{"operationId":"editHold","tags":["holds"],"produces":["application\/json"],"responses":{"200":{"schema":{"type":"object","properties":{"suspend_until":{"description":""},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"reservedate":{"description":"the date the hold was placed"},"reservenotes":{"description":"notes related to this hold"},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"lowestPriority":{"description":""},"waitingdate":{"description":"the date the item was marked as waiting for the patron at the library"},"found":{"description":"a one letter code defining what the status of the hold is after it has been confirmed"},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"notificationdate":{"description":"currently unused"},"expirationdate":{"description":"the date the hold expires"},"reminderdate":{"description":"currently unused"},"priority":{"description":"where in the queue the patron sits"},"reserve_id":{"description":"Internal hold identifier"},"cancellationdate":{"description":"the date the hold was cancelled"},"borrowernumber":{"type":"string","description":"internally assigned user identifier"},"timestamp":{"description":"date and time the hold was last updated"},"itemtype":{"description":"If record level hold, the optional itemtype of the item the patron is requesting","type":["string","null"]},"suspend":{"description":""}}},"description":"Updated hold"},"404":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Hold not found"},"400":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Missing or wrong parameters"}},"parameters":[{"required":true,"in":"path","description":"Internal hold identifier","type":"integer","name":"reserve_id"},{"schema":{"type":"object","properties":{"branchcode":{"type":"string","description":"Pickup location"},"priority":{"description":"Position in waiting queue","type":"integer","minimum":1},"suspend_until":{"format":"date","description":"Suspend until","type":"string"}}},"description":"A JSON object containing fields to modify","name":"body","in":"body","required":true}],"consumes":["application\/json"]},"delete":{"responses":{"200":{"description":"Successful deletion","schema":{"type":"object"}},"404":{"description":"Hold not found","schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"}}},"produces":["application\/json"],"parameters":[{"description":"Internal hold identifier","type":"integer","name":"reserve_id","required":true,"in":"path"}],"tags":["holds"],"operationId":"deleteHold"}},"\/patrons":{"get":{"operationId":"listPatrons","tags":["patrons"],"produces":["application\/json"],"responses":{"200":{"description":"A list of patrons","schema":{"type":"array","items":{"properties":{"altcontactaddress1":{"description":"the first address line for the alternate contact for the patron","type":["string","null"]},"B_phone":{"description":"phone number for patron's alternate address","type":["string","null"]},"altcontactfirstname":{"description":"first name of alternate contact for the patron","type":["string","null"]},"relationship":{"type":["string","null"],"description":"used for children to include the relationship to their guarantor"},"address":{"type":"string","description":"first address line of patron's primary address"},"othernames":{"type":["string","null"],"description":"any other names associated with the patron"},"smsalertnumber":{"description":"the mobile phone number where the patron would like to receive notices (if SMS turned on)","type":["string","null"]},"password":{"type":["string","null"],"description":"patron's encrypted password"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"altcontactzipcode":{"type":["string","null"],"description":"the zipcode for the alternate contact for the patron"},"initials":{"type":["string","null"],"description":"initials of the patron"},"borrowernotes":{"type":["string","null"],"description":"a note on the patron's account"},"B_country":{"type":["string","null"],"description":"country of patron's alternate address"},"updated_on":{"type":"string","description":"time of last change could be useful for synchronization with external systems (among others)"},"city":{"type":"string","description":"city or town of patron's primary address"},"userid":{"description":"patron's login","type":["string","null"]},"debarred":{"type":["string","null"],"description":"until this date the patron can only check-in"},"lost":{"description":"set to 1 if library marked this patron as having lost his card","type":["string","null"]},"guarantorid":{"description":"borrowernumber used for children or professionals to link them to guarantor or organizations","type":["string","null"]},"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"debarredcomment":{"description":"comment on the stop of the patron","type":["string","null"]},"country":{"type":["string","null"],"description":"country of patron's primary address"},"sex":{"type":["string","null"],"description":"patron's gender"},"opacnote":{"description":"a note on the patron's account visible in OPAC and staff client","type":["string","null"]},"altcontactphone":{"description":"the phone number for the alternate contact for the patron","type":["string","null"]},"emailpro":{"type":["string","null"],"description":"secondary email address for patron's primary address"},"B_address2":{"type":["string","null"],"description":"second address line of patron's alternate address"},"branchcode":{"type":["string","null"],"description":"code of patron's home branch"},"altcontactsurname":{"type":["string","null"],"description":"surname or last name of the alternate contact for the patron"},"B_email":{"description":"email address for patron's alternate address","type":["string","null"]},"categorycode":{"description":"code of patron's category","type":"string"},"contacttitle":{"type":["string","null"],"description":"used for children to include title of guarantor"},"surname":{"type":"string","description":"patron's last name"},"altcontactcountry":{"type":["string","null"],"description":"the country for the alternate contact for the patron"},"title":{"type":["string","null"],"description":"patron's title"},"contactnote":{"type":["string","null"],"description":"a note related to patron's alternate address"},"sms_provider_id":{"type":["string","null"],"description":"the provider of the mobile phone number defined in smsalertnumber"},"B_city":{"description":"city or town of patron's alternate address","type":["string","null"]},"fax":{"description":"fax number for patron's primary address","type":["string","null"]},"B_state":{"description":"state or province of patron's alternate address","type":["string","null"]},"altcontactaddress3":{"description":"the city for the alternate contact for the patron","type":["string","null"]},"firstname":{"description":"patron's first name","type":["string","null"]},"altcontactaddress2":{"type":["string","null"],"description":"the second address line for the alternate contact for the patron"},"mobile":{"type":["string","null"],"description":"the other phone number for patron's primary address"},"B_address":{"type":["string","null"],"description":"first address line of patron's alternate address"},"email":{"type":["string","null"],"description":"primary email address for patron's primary address"},"altcontactstate":{"type":["string","null"],"description":"the state for the alternate contact for the patron"},"privacy_guarantor_checkouts":{"description":"controls if relatives can see this patron's checkouts","type":"string"},"dateexpiry":{"type":["string","null"],"description":"date the patron's card is set to expire"},"B_zipcode":{"type":["string","null"],"description":"zip or postal code of patron's alternate address"},"dateofbirth":{"type":["string","null"],"description":"patron's date of birth"},"gonenoaddress":{"description":"set to 1 if library marked this patron as having an unconfirmed address","type":["string","null"]},"phonepro":{"description":"secondary phone number for patron's primary address","type":["string","null"]},"dateenrolled":{"description":"date the patron was added to Koha","type":["string","null"]},"contactfirstname":{"type":["string","null"],"description":"used for children to include first name of guarantor"},"privacy":{"type":"string","description":"patron's privacy settings related to their reading history"},"address2":{"type":["string","null"],"description":"second address line of patron's primary address"},"state":{"type":["string","null"],"description":"state or province of patron's primary address"},"flags":{"type":["string","null"],"description":"a number associated with the patron's permissions"},"streetnumber":{"type":["string","null"],"description":"street number of patron's primary address"},"zipcode":{"type":["string","null"],"description":"zip or postal code of patron's primary address"},"checkprevcheckout":{"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'","type":"string"},"sort2":{"type":["string","null"],"description":"a field that can be used for any information unique to the library"},"cardnumber":{"type":["string","null"],"description":"library assigned user identifier"},"streettype":{"type":["string","null"],"description":"street type of patron's primary address"},"B_streetnumber":{"type":["string","null"],"description":"street number of patron's alternate address"},"contactname":{"type":["string","null"],"description":"used for children and professionals to include surname or last name of guarantor or organization name"},"B_streettype":{"description":"street type of patron's alternate address","type":["string","null"]},"sort1":{"type":["string","null"],"description":"a field that can be used for any information unique to the library"}},"type":"object"}}},"403":{"schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"description":"Access forbidden"}}}},"\/accountlines\/{accountlines_id}":{"put":{"parameters":[{"type":"integer","name":"accountlines_id","description":"Internal accountline identifier","in":"path","required":true},{"in":"body","required":true,"name":"body","schema":{"properties":{"amountoutstanding":{"description":"Amount outstanding"},"amount":{"description":"Amount"},"meansofpayment":{"description":"Means of payment"},"note":{"description":"Accountline note"}},"type":"object"},"description":"A JSON object containing fields to modify"}],"consumes":["application\/json"],"produces":["application\/json"],"responses":{"403":{"description":"Access forbidden","schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}}},"400":{"description":"Missing or wrong parameters","schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"}},"404":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Accountline not found"},"200":{"schema":{"properties":{"meansofpayment":{"description":"Means of payment"},"date":{"description":"Date when the account line was created"},"note":{"description":"Accountline note"},"amount":{"description":"Amount"},"manager_id":{"description":"Borrowernumber of user that created the account line"},"accountlines_id":{"description":"Internal account line identifier"},"time":{"description":"Time when the account line was created"},"lastincrement":{"description":"?"},"accountno":{"description":"?"},"itemnumber":{"description":"Internal item identifier"},"amountoutstanding":{"description":"Amount outstanding"},"notify_level":{"description":"?"},"notify_id":{"description":"?"},"borrowernumber":{"description":"Internal borrower identifier"},"timestamp":{"description":"When the account line was last updated"},"description":{"description":"Description of account line"},"accounttype":{"description":"Type of accountline"}},"type":"object"},"description":"Updated accountline"}},"tags":["accountlines"],"operationId":"editAccountlines"}},"\/patrons\/{borrowernumber}\/payment":{"post":{"parameters":[{"in":"path","required":true,"description":"Internal patron identifier","type":"integer","name":"borrowernumber"},{"schema":{"properties":{"note":{"description":"Payment note"},"amount":{"description":"Amount to pay"}},"type":"object"},"description":"A JSON object containing fields to modify","name":"body","in":"body","required":true}],"consumes":["application\/json"],"responses":{"400":{"schema":{"properties":{"error":{"description":"Error message","type":"string"}},"type":"object"},"description":"Missing or wrong parameters"},"404":{"schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}},"description":"Borrower not found"},"204":{"description":"Success"},"403":{"description":"Access forbidden","schema":{"type":"object","properties":{"error":{"description":"Error message","type":"string"}}}}},"produces":["application\/json"],"operationId":"payForPatron","tags":["accountlines"]}}},"x-primitives":{"phone":{"description":"primary phone number for patron's primary address","type":["string","null"]},"itemnumber":{"type":["string","null"],"description":"internally assigned item identifier"},"email":{"type":["string","null"],"description":"primary email address for patron's primary address"},"surname":{"type":"string","description":"patron's last name"},"biblionumber":{"description":"internally assigned biblio identifier","type":"string"},"borrowernumber":{"description":"internally assigned user identifier","type":"string"},"cardnumber":{"description":"library assigned user identifier","type":["string","null"]},"firstname":{"description":"patron's first name","type":["string","null"]},"branchcode":{"description":"code of patron's home branch","type":["string","null"]},"reserve_id":{"description":"Internal hold identifier"}},"basePath":"\/api\/v1"} |