Polaris API Guide Revision History

The following list shows the revision history for the Polaris API Guide starting with the most current revisions:

• Polaris 7.1 - Revised and updated the PAPI Overview section.

• Polaris 7.1 - Added a new Overview for PAPI Public Methods.

• Polaris 7.1 - Moved PAPI documentation to an online format.

• PatronBasicDataGet - Polaris 7.0. Method now does the following:
  • returns the patron's blocks in the PatronSystemBlock element. The documentation for PatronBasicDataGet now includes the XML-elements-returned, PatronSystemBlock and its description. See PatronBasicDataGet.

  • includes query string parameters for patron notes and addresses. The documentation for PatronBasicDataGet now includes the new query string parameters. See PatronBasicDataGet.

  • includes five user-defined fields (UDFs) for patrons. The documentation for PatronBasicDataGet now includes the new UDFs. See PatronRegistrationUpdate.

• ILLRequestCancel - Polaris 7.0. This endpoint allows the consumer to cancel Interlibrary Loan (ILL) requests. See ILLRequestCancelPut.

• BibGet - Polaris 7.0. Method has been updated to return the full monograph for UPC in a bibliographic record. See BibGet.

• PatronItemsOutGet - Polaris 7.0. Method has been updated to support excluding econtent records. See PatronItemsOutGet.

• Synch_ItemsByBibIDGet - Polaris 7.0. Method has been updated to support excluding econtent records. See Synch_ItemsByBibIDGet.

• UpdatePatronNotesData - Polaris 7.0. This endpoint provides the ability to prepend, append, or replace staff notes on patrons. See UpdatePatronNotesData.

• PatronNotesGet - Polaris 7.0. This endpoint provides the ability to retrieve patron notes (blocking and non-blocking), for a given patron barcode. See PatronNotesGet.

• PatronRegistrationUpdate - Polaris 7.0. Method has been updated to include five UDFs for patrons. The documentation for PatronBasicDataGet now includes the new UDFs. See PatronRegistrationUpdate.

• PatronUdfConfigsGet - Polaris 7.0. This endpoint returns the possible user-defined values, when UDFs are not configured as free-text. This endpoint also includes information about the system administration configuration of the UDFs. See PatronUdfConfigsGet.

• RecordSetRecordsPut - Polaris 7.0. Method has been updated to add or remove bibliographic, item, or patron records to or from a record set. See RecordSetContentPut.

• RecordSetContentGet - Polaris 7.0. Method has been updated to return a list of records in a bibliographic or item record set as well as a patron record set. See RecordSetRecordsGet.

• JobsPurchaseOrdersPut - Polaris 7.0. This jobs endpoint validates acquisitions line items before creating a purchase order. See JobsPurchaseOrdersPut.

• JobsPurchaseOrdersPost - Polaris 7.0. This jobs endpoint allows you to create a purchase order as a job. See JobsPurchaseOrdersPost.

• JobsPurchaseOrdersResultGet - Polaris 7.0. This jobs endpoint returns acquisitions purchase order job results. See JobsPurchaseOrdersResultGet.

• JobsPurchaseOrdersStatusGet - Polaris 7.0. This jobs endpoint allows you to query the status of your job. See JobsPurchaseOrdersStatusGet.

• PatronBasicDataGet - Polaris 6.7. Method has been updated to return the patron's preferred pickup location for holds in the RequestPickupBranchID element. The documentation for PatronBasicDataGet is now updated to include the XML-elements-returned, ExpirationDate and its description. See PatronBasicDataGet.

• PatronRegistrationCreate - Polaris 6.7. Method has been updated to accept the optional RequestPickupBranchID element. This element specifies the patron's preferred pickup location for holds. See PatronRegistrationCreate.

• PatronRegistrationUpdate - Polaris 6.7. Method has been updated to accept the optional RequestPickupBranchID element. This element specifies the patron's preferred pickup location for holds. See PatronRegistrationUpdate.

• MaterialTypesGet - Polaris 6.7. Returns a list of all material types in the system. See MaterialTypesGet.

• MARCTypeOfMaterialsGet - Polaris 6.7. Returns a list of all MARC type of materials in the system. See MARCTypeOfMaterialsGet.

• ItemStatusesGet - Polaris 6.7. Returns a list of all item statuses in the system. See ItemStatusesGet.
• SysHoldStatusesGet - Polaris 6.7. Returns a list of all system hold statuses in the system. See SysHoldStatusesGet.
• Synch_GetSerialCompressedHoldingsPaged - Polaris 6.7. Provides serial-holdings data for consumption and display in a third-party patron-facing system at the branch and system levels (specifically the compressed-holdings data, the location, and the last received issue). See Synch_GetSerialCompressedHoldingsPaged.
• Synch_GetSerialCompressedHoldingsByID - Polaris 6.7. Provides serial-holdings data for consumption and display in a third-party patron-facing system based on a list of one or more bibliographic-record and branch-ID pairs (specifically the compressed-holdings data, the location, and the last received issue). See Synch_GetSerialCompressedHoldingsByID.

• Synch_GetBibResourceCountsByID - Polaris 6.7. This endpoint allows the consumer to retrieve the number of linked item records and local hold counts for multiple bibliographic record ids in the Polaris database. See Synch_GetBibResourceCountsByID.

• Date format updated - Polaris 6.6. The date format for the following methods is now updated to YYYY-MM-DDTHH:MM:SS to support international date and time.

  • Synch_Get UpdatedAuths

  • Synch_GetUpdatedAuthsPaged

  • Synch_GetDeletedAuths

  • Synch_GetDeletedAuthsPaged

  • Synch_GetDeletedBibs

  • Synch_GetDeletedBibsPaged

  • Synch_GetDeletedItems

  • Synch_GetDeletedItemsPaged

  • Synch_GetDeletedPatrons

  • Synch_GetDeletedPatronsPaged

  • Synch_GetUpdatedBibs

  • Synch_GetUpdatedBibsPaged

  • Synch_GetUpdatedItems

  • Synch_GetUpdatedItemsPaged

• BibKeywordSearch - Polaris 6.6. The documentation for BibKeywordSearch is now updated to include more XML-elements-returned descriptions and a more accurate Return-Success example. See BibKeywordSearch.

• PatronBasicDataGet and PatronRegistrationCreate - Polaris 6.5. The use of a patron's legal name is now supported. The legal name fields LegalNameFirst, LegalNameMiddle, LegalNameLast, and UseLegalNameOnNotices have been added to PatronBasicDataGet and PatronRegistrationCreate. PatronBasicDataGet also includes the new field LegalFullName. See PatronBasicDataGet and PatronRegistrationCreate.
• PatronBasicDataGet, PatronRegistrationCreate, and PatronRegistrationUpdate - Polaris 6.5. The state address field can now be unidentified, if a country does not require a state definition. This requires "StateRequired" to be set to no in the System Administration "Countries" table. See PatronBasicDataGet, PatronRegistrationCreate, and PatronRegistrationUpdate.
• HoldRequestCancel - Polaris 6.5. Shipped holds can now be canceled with the status of "1 inactive", "2" active", and "4 pending". If enabled by the library, hold requests with a status of "5 shipped" can also be canceled. See HoldRequestCancel.

• PatronRegistrationCreate and PatronRegistrationUpdate - Polaris 6.4. Incoming phone number formats are now validated against customer-defined rules in Polaris System Administration. The TxtPhoneNumber parameter now supports "Unspecified" for instances where no phone number is indicated. The parameter StreetThree has been added as optional. The parameters Phone1CarrierID, Phone2CarrierID, and Phone3CarrierID support a value of -2 if the patron's branch has "Notice: Export text message" enabled in System Administration. See PatronRegistrationCreate and PatronRegistrationUpdate.
• PatronBasicDataGet - Polaris 6.4. StreetThree has been added to the PatronAddresses return element. See PatronBasicDataGet.
• SynchBibsByIDGet - Polaris 6.4. Bibliographic records can now be queried using a single record ID, a comma-delimited list of IDs, or a range of IDs. A new query string parameter, includeItems, is supported when retrieving records. This parameter includes an 852 tag for each item record linked to the bibliographic record. See Synch_BibsByIDGet.

• Synch_GetBibsPaged - Polaris 6.3. New endpoint allows a paged extraction of bib record data. See Synch_BibsPagedGet.
• PickupBranchesGet - Polaris 6.3. New endpoint returns a list of valid pickup branches based on the organization ID. See PickupBranchesGet.
• ShelfLocationsGet - Polaris 6.3. New endpoint returns a list of shelf locations based on the organization ID. See ShelfLocationsGet.
• ItemUpdateBarcode - Polaris 6.3. The new parameter BarcodeOrID has been implemented that enables a barcode to be updated using either the item ID or the item barcode as an identifier. An additional new parameter, isBarcode, specifies whether the identifier used is an item record ID or a barcode. See ItemUpdateBarcode.
• PatronHoldRequestGet - Polaris 6.3. A new CanSuspend Boolean property has been added that indicates whether a patron’s hold request can be suspended. See PatronHoldRequestsGet.

• PatronReadingHistoryClear - Polaris 6.3. Removes a range of historical reading history entries by specifying their ID using the new query string parameter id. See PatronReadingHistoryClear.

• Polaris 5.6 release - Updated title page and revised descriptions for methods RecordSetContentPut and RecordSetRecordsGet. Removed references to release 5.2 from descriptions and clarified that the methods are for patron record sets only.

• Synch_GetDeletedAuthsPaged - Polaris 5.5. New "paged" method allows the caller to retrieve the ID list in smaller packets to prevent timeouts when retrieving long lists. See Synch_GetDeletedAuthsPaged.
• Synch_GetDeletedBibsPaged - Polaris 5.5. New "paged" method allows the caller to retrieve the ID list in smaller packets to prevent timeouts when retrieving long lists. See Synch_GetDeletedBibsPaged.
• Synch_GetDeletedItemsPaged - Polaris 5.5. New "paged" method allows the caller to retrieve the ID list in smaller packets to prevent timeouts when retrieving long lists. See Synch_GetDeletedItemsPaged.
• Synch_GetDeletedPatronsPaged - Polaris 5.5. New "paged" method allows the caller to retrieve the ID list in smaller packets to prevent timeouts when retrieving long lists. See Synch_GetDeletedPatronsPaged.
• Synch_GetUpdatedAuthsPaged - Polaris 5.5. New "paged" method allows the caller to retrieve the ID list in smaller packets to prevent timeouts when retrieving long lists. See Synch_GetUpdatedAuthsPaged.
• Synch_GetUpdatedBibsPaged - Polaris 5.5. New "paged" method allows the caller to retrieve the ID list in smaller packets to prevent timeouts when retrieving long lists. See Synch_GetUpdatedBibsPaged.
• Synch_GetUpdatedItemsPaged - Polaris 5.5. New "paged" method allows the caller to retrieve the ID list in smaller packets to prevent timeouts when retrieving long lists. See Synch_GetUpdatedItemsPaged.

• PatronPreferencesGet - Added note that states when a patron does not have a delivery method, PAPI returns a description of “null” rather than “none”. See PatronPreferencesGet.
• PatronRegistationCreate - Revised description for EnableSMS to Enable additional text message and values include 0/1 or False/True. See PatronRegistrationCreate.

• PAPI uses Swagger - Polaris 5.2. See PAPI and Swagger.
• AuthenticatePatron changes - Polaris 5.2. AuthenticatePatron supports either barcode or username in the XML body Barcode element. The method supports the PAC override password and Enable Patron username options, as specified in the Polaris Administration PAC profile Patron Access options - Log In. See AuthenticatePatron.
• NotificationUpdate changes - Polaris 5.2. Method now supports email and text messaging for specific types of notices. Notification types have been added: 2nd Notice (ID=18); Missing Part (ID=19); Manual Bill (ID=20). See NotificationUpdate.
• PatronHoldRequestsGet changes - Polaris 5.2. Designation and VolumeNumber are returned if present in the data. PACDisplayNotes (up to 255 characters from the PAC Display Note field) are returned. See PatronHoldRequestsGet.
• PatronitemsOutGet changes - Polaris 5.2. Designation and VolumeNumber are returned if present in the data. CanItemBeRenewed (true/false) is returned. See PatronItemsOutGet.
• PatronRegistrationCreate changes - Polaris 5.2. XML body elements now include ExpirationDate, AddrCheckDate, and PatronCode. A new error code, Invalid_Patron_Code (-3612) is added. See PatronRegistrationCreate.
• PatronUpdate changes - Polaris 5.2. Now supports patron requests to change address. The following XML body elements are added: AltEmail address; EnableSMS; PhoneVoice2; PhoneVoice3; Phone1CarrierID; Phone2CarrierID; Phone3CarriedID; TxtPhoneNumber; EReceiptOptionID (including None); ExcludeFromAlmostOverdueAutoRenew; ExcludeFromPatronRecExpiration; ExcludeFromInactivePatron; ExpirationDate; AddrCheckDate; PatronCodeID; AddressID; FreeTextLabel; StreetOne; State; County; PostalCode; Country; AddressTypeID. Null (none) is now a valid input option for DeliveryOption. You can remove an email address by sending a blank EmailAddress or Altemail address in the request body; for example: <EmailAddress><\EmailAddress> would remove whatever was in the record. See PatronBasicDataGet.
• DatesClosed - Polaris 5.2. New method returns a list of dates closed by organization. See DatesClosedGet.
• PatronCodesGetResult - Polaris 5.2. New method returns a list of valid patron codes. See PatronCodesGetResult.
• PatronILLRequestsGet - Polaris 5.2. New method returns a list of ILL requests placed by the specified patron. The list can be filtered by the status of the request. See PatronILLRequestsGet.
• RecordSetContentPut - Polaris 5.2. New method adds or removes records from a patron record set. See RecordSetContentPut.
• RecordSetRecordsGet - Polaris 5.2. New method returns a list of record IDs in a specified patron record set. See RecordSetRecordsGet.
• SAMobilePhoneCarriersGetResult - Polaris 5.2. New method returns content from the SA_MobilePhoneCarriers table for a specified organization, which specifies the mobile phone carrier selections available for patron record phone fields. See SAMobilePhoneCarriersGetResult.
• UpdatePickupBranchID - Polaris 5.2. New method updates the pickup branch for a hold request when the patron requests the change. See UpdatePickupBranchID.
• PatronUpdate - Polaris 5.2. Documentation updated: PatronCodeID element changed to PatronCode. See PatronRegistrationUpdate.

• Updated Type of Material (TOM) list - Polaris 5.1. See Material Format Types.
• Method to authenticate patron - Polaris 5.1 SP1. See AuthenticatePatron.