API Reference › Webhooks
Trace Job Completed
WEBHOOK Your webhook URL
When a batch skip trace queue completes, Tracerfy POSTs the result to the webhook URL configured in your account profile. This is per-user and dynamic; no registration endpoint is required.
Three payload shapes can arrive at this endpoint, depending on which trace finished:
- Normal skip trace: distinguished by trace_type: "normal" and credits_per_lead: 1.
- Advanced skip trace: distinguished by trace_type: "advanced" and credits_per_lead: 2.
- APN / parcel trace: distinguished by type: "parcel_trace" and the parcel_queue_id field. Different shape (no trace_type); uses credits_per_parcel instead.
Enhanced batch trace webhooks follow the same skip-trace queue shape; only the trace_type string and credits_per_lead value differ.
Tracerfy sends one of the JSON shapes below to your Account.webhook_url when a trace completes.