Skip to content

Common Error Messages

Trace IDs

Every request AddressTools makes to the ProvenWorks service carries a trace ID, a 32-character code of lower-case letters and digits. When a request fails, the error reported in your org includes that ID. A single ID covers every request in the same operation: one search session, one batch run or one data installation run.

A trace ID appears wherever AddressTools reports a failed request:

  • Interactive address search: when a search or address retrieval fails in the AddressTools search box on a record, in PowerSearch or in the search modal, a Trace ID line appears beneath the error message.
  • Batch address verification: the Trace ID column of Job History on the Batch Address Verification page, and the failure email sent to the Batch Verification Alert Email Address. See Configure Batch Address Verification.
  • Automated verification via a record-triggered flow: the error message for each failed record ends with the ID, both in the alert email and in the Automated Address Verification Error platform event.
  • Reference data installation: each failed stage on the Installation tab shows its message with the ID beneath it, and the Installation Completed with Errors dialog lists them. See Install Country Data.
  • Create Token or Update Token on the Installation tab: a failed token request shows its message with the ID beneath the step.
  • Licensing & Lookups tab: if your remaining verification lookups cannot be loaded, an error notification with the ID appears in place of the lookup table. Click Refresh to retry.

If a failure persists after retrying and you contact support@provenworks.com, include the trace ID. It lets ProvenWorks go straight to the requests that failed; without it, support has to work from the time and your Org ID alone, which is slower and less certain. To copy an ID, click the copy button beside it where one is shown; otherwise, select the ID text and copy it. One ID covers a whole run or search session, so a single ID is enough even when several records failed.