GET
Get Snapshot Status

Authentication

Requires debts:read or debts:write. Uses the read limiter: 1,000 requests/hour per company.
string
required
Your campaign reference.
string
required
The client-created snapshot reference used to submit or start this snapshot.
200

Status handling

After 202 Accepted, poll this endpoint. After a network timeout on a mutation, retry the identical request body; if status is failed, correct the source and submit a new reference; if it is processing_error, do not resubmit and contact GetBill support. counts is null before core application. counts.resolved is the number of debts treated as settled because they were absent from the snapshot. failure is null or contains only reason plus optional one-based row and field. core_applied: true means debt upsert and missing-debt reconciliation committed atomically; do not interpret processing_error as a rollback. warnings is a safe, capped list of non-blocking row outcomes available only after asynchronous processing. warning_count is its total, and warnings_omitted is the number excluded after the first 100. A costly phone destination not allowed by the GetBill campaign configuration is a warning: the row remains in the snapshot, email and postal reminders may continue, and only SMS, RCS, calls, WhatsApp, and voicemail are blocked for that phone. enrichment is null until the worker reaches the enrichment stage. It contains only aggregate counts and safe skip reasons such as feature_disabled, insufficient_credits, and provider_unavailable; it never exposes debt IDs, names, email addresses, fingerprints, or provider payloads. Campaign enrichment settings are captured when the snapshot session starts, so later dashboard edits affect only later snapshots. Manual imports keep their own explicit enrichment choices. Missing and cross-company references both return 404.