Web Service Integration 31 - UpdateWatchList

Introduction
The UpdateWatchList web service allows you to update and/or replace your entire watch list.

NOTE: This web services requires that a list of DOT and/or Docket Numbers be passed in the html message body via a POST request. As a result, this web service call will likely not work in your browser for demo.

Example UpdateWatchList Call:

https://www.saferwatch.com/webservices/CarrierService31.php
?Action=UpdateWatchList
&ServiceKey=YourServiceKey
&CustomerKey=YourCustomerKey
&delim=COMMA, TAB or PIPE
&replace=TRUE or FALSE. TRUE will replace the current watch list with your list.

Message Body contains docket or DOT Number list delimited by COMMA, TAB or PIPE:
List size per call is limited to 7500 numbers.
MC123123,FF000225,DOT234222,38392

NOTE - To Replace watchlists larger than 7500 numbers, the first call with list of first 7500 numbers should include '&replace=TRUE'. Subsequent calls required to complete the update to the entire list should include '&replace=FALSE'

NOTE - To Update watchlists with more than 7500 numbers, each call should include '&replace=FALSE'.

Docket Numbers must be prefixed by MC,FF or MX. Zero padding is not required (ie MC000123 will be the same as MC123).
DOT Numbers can optionally contain DOT prefix (Numbers with no prefix will be processed as DOT Numbers).
Zero padding is not required (ie DOT000123, DOT123 or 123 are all valid DOT Numbers).

Response fields values:

<CarrierService31.UpdateWatchList>
<ResponseDO> NOTE: See Standard Response
     <status>APPROVED</status>
     <action>OK</action>
     <code>SFW00389</code>
     <displayMsg>Added 4. Error on 2.</displayMsg>
     <techMsg></techMsg>
</ResponseDO>
<InvalidNumbers>XX123,0</InvalidNumbers>
</CarrierService31.UpdateWatchList>