Poll a dedupe scan or merge job (groups / totals when completed)
Polls a dedupe job started by POST /business/contacts/dedupe-scan or POST /business/contacts/dedupe-merge; kind says which of the two the id names. status moves pending > processing > completed or failed; poll every few seconds until it is terminal. On a completed scan, scanResult carries one PAGE of the duplicate groups (pageNum/limit, default 50 per page, largest groups first; scanResult.pagination says how many pages there are — page through once status is completed rather than re-fetching every group on every poll). Each group carries its contactIds (every member), matchedValues (the normalized values it matched on), the lists its members live in, a preview of up to 25 member contacts, and a mergePreview of the contact the group would merge into — its surviving winnerContactId, filled fields, and the combined emails/phones unions (first 10 entries each; emailCount/phoneCount are the full totals). Each group's groupId is what POST /business/contacts/dedupe-merge selects by. totalGroups counts every group the scan FOUND and can exceed the stored 200 (truncated says so); pagination.totalRecords counts the stored, pageable groups. On a completed merge, mergeResult carries mergedGroups, archivedContacts and skippedGroups (groups that no longer had two live members when the merge ran, or whose members' identities conflict). On failed, error is DEDUPE_FAILED — start a new job. Scan results expire with the job (about 24 hours); export jobs are not served here (poll GET /business/exports/{jobId}). Serves only the token owner's own jobs. Rate limit: 120 requests per minute, 10,000 per day on the contacts bucket, which every /business/contacts endpoint shares.
Errors:
- 404 JOB_NOT_FOUND — No dedupe job with that id (it may have expired, belong to another workspace, or be an export job).
- 422 VALIDATION_FAILED — jobId is not a 24-hex id.
- 429 RATE_LIMITED — More than 120 requests per minute or 10,000 per day on the contacts bucket, which every /business/contacts endpoint shares; retry after Retry-After.
Requires one of the following token scopes: contacts.
Request
- Base URL: https://api.tryfuse.ai/api/v1
- URL: https://api.tryfuse.ai/api/v1/business/contacts/dedupe-jobs/{jobId}
- Auth: HTTP basic
Path parameters
24-character hex id of an async job, as returned with the 202 that started it (POST /business/lists/{listId}/export).
Query parameters
1-based page number over the scan's stored groups (default 1); groups are ordered largest first.
Page size: how many duplicate groups to return per page (1-200, default 50). A scan stores at most 200 groups, so limit=200 returns the whole result in one page.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.