getPackageTrackingIdsSince

This method is used to retrieve a list of package tracking ids for a specific sender for which the tracking filter has changed since the given date. For example in order to find all messages that recipients have signed since yesterday. You would set the tracking filter to SIGNED and the date to yesterdays date. It is typically used by a calling system that wants to poll the SDX and only wants changes from the last time it polled.

Request Parameters

Parameter Type Requirement Description
username xsd:string mandatory – cannot be null or empty The username of the registered user who sent the package
password xsd:string mandatory – cannot be null or empty The password of the registered user who sent the package
encodedPassword xsd:boolean optional – can be null (indicates false) Indicates whether the password parameter is MD5 encoded
trackingFilter xsd:string mandatory – cannot be null or empty The tracking filters to be applied. Please see getPackageStatusTypes for information on values that can be sent
since xsd:dateTime mandatory This is the date from which the IDs will be retrieved.

Response

Possible return values:
  • Type: xsd:string
    <trackingids>
     <packageid>
     <id></id>
     <status></status>
     <date></date>
     </packageid>
    </trackingids>
    with a <packageid> entry for each of the package that meets the filtering requirement. There are many possible contents for the <status> elements depending on the type of packages being requested. More details can be found in the section regarding getPackageStatusTypes.
  • “ERROR” - an error occurred. This will be followed by a description of the error (e.g. ERROR : Invalid Filter)