POST /patrons/{id} – REST API

Update a Patron: POST /patrons/{id}

Update specific fields for an existing patron.

Query Parameters

  • id: A unique ID for the patron – parameter accepts either the barcode or email.

URL Parameters
Values should be paramaterized such as using http_build_query() as per example below. Submitting a parameter with an empty string will remove any existing entry for that field – do not include parameters unnecessarily.

  • first_name: Patron’s first name. (If included, can not be empty)
  • last_name: Patron’s last name. (If included, can not be empty)
  • email: Patron’s email, must be unique.
  • password: Patron’s password, needed to log into the patron page and check out / hold items.
  • notification_email: An optional email which overrides the email field only for sending out notifications.
  • patron_id: Any ID that you wish to assign, does not need to be unique.
  • phone: Patron’s phone number.
  • address1: Patron’s address.
  • address2: Patron’s address.
  • city: Patron’s city.
  • state: If country is set to US, the state MUST be the two character abbreviation.
  • country: The valid 2 character abbreviation of the patron’s country. (If included, can not be empty)
  • zip: Patron’s zip code.
  • barcode: THIS SHOULD GENERALLY NOT BE USED! Libib will have automatically assigned a custom barcode for each patron (unless previously overwritten). If a barcode is included in the parameters, it will be used to update the patron’s barcode. However, the barcode you create may not work with our system and we can not provide support for it. A possible use case for this field is if you need to correct an overwritten barcode. 5-15 digits. (If included, can not be empty)
Barcodes are always auto-assigned by Libib. Overriding this behavior by assigning your own barcodes often prevents Libib from working as expected. Libib is unable to support any issues that arise from using non-supported barcodes.

JSON Result Details
Password is never returned in result set.

  • barcode: The barcode – assigned automatically by Libib unless specifically overwritten.
  • first_name: Patron’s first name.
  • last_name: Patron’s last name.
  • email: Patron’s email.
  • notification_email: An optional email which overrides the email field only for sending out notifications.
  • patron_id: Any ID that you may have assigned.
  • phone: Patron’s phone number.
  • address1: Patron’s address
  • address2: Patron’s address.
  • city: Patron’s city.
  • state: If country is set to US, the state will be a two character abbreviation.
  • country: The 2 character abbreviation of the country.
  • zip: Patron’s zip code.

Was this article helpful?

Related Articles