Poll a bulk consistency job

GET/api/v1/consistency/bulk/{jobId}

authentication: Secret API key as a bearer token
billing: Free.

The job's current status and running counts. status moves from queued to processing and ends in completed, failed, or cancelled; processed and the three row counts advance as chunks finish. A job that belongs to another account answers 404.

flagged, unflagged and uncompared count what the comparison did, and none of them is a verdict about the person a row describes — this product publishes no score, risk level or verdict, and will not. A row is flagged when at least one flag was raised on it, unflagged when at least two of its signals answered and none of them disagreed, and uncompared when fewer than two answered, so there was nothing to compare.

Parameters

name	in	type	description
jobIdrequired	path	integer

Example request

curl https://spaw.co/api/v1/consistency/bulk/{jobId} \
  -H "Authorization: Bearer sk_live_…"

const response = await fetch('https://spaw.co/api/v1/consistency/bulk/{jobId}', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_live_…',
  },
});
const result = await response.json();

import requests

response = requests.get(
    'https://spaw.co/api/v1/consistency/bulk/{jobId}',
    headers={'Authorization': 'Bearer sk_live_…'},
)
result = response.json()

$ch = curl_init('https://spaw.co/api/v1/consistency/bulk/{jobId}');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer sk_live_…'],
]);
$result = json_decode(curl_exec($ch), true);

from spaw import Client

client = Client('sk_live_…')
result = client.get_consistency_bulk_job(job_id)

import Spaw from 'spaw';

const spaw = new Spaw({ apiKey: 'sk_live_…' });
const result = await spaw.getConsistencyBulkJob(jobId);

use Spaw\Client;

$spaw = new Client('sk_live_…');
$result = $spaw->getConsistencyBulkJob($jobId);

This endpoint has no console on its page. It answers with records from your own account, often by an id only you have, rather than about a value you can type here. The dashboard lists the same rows.

Responses

200The job.

{
    "success": true,
    "data": {
        "job": {
            "id": 41,
            "status": "completed",
            "total": 2,
            "duplicate_count": 0,
            "processed": 2,
            "flagged": 1,
            "unflagged": 1,
            "uncompared": 0,
            "credits_used": 5,
            "stopped_reason": null,
            "cancel_requested": false,
            "country": "GB",
            "webhook_status": "delivered",
            "webhook_detail": "200",
            "created_at": "2026-09-10T10:12:44+00:00",
            "finished_at": "2026-09-10T10:12:49+00:00"
        }
    }
}

401The key is missing, malformed, or revoked.

{
    "success": false,
    "error": {
        "code": "UNAUTHENTICATED",
        "message": "Provide a valid API key as a bearer token.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}

404No such record on this account.

{
    "success": false,
    "error": {
        "code": "NOT_FOUND",
        "message": "No record with that id on this account.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}

429Over 5 requests per second for the key. Retry after the limit resets.

{
    "success": false,
    "error": {
        "code": "RATE_LIMITED",
        "message": "Too many requests. Retry after the limit resets.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}

Error codes

Failures answer { success: false, error: { code, message, request_id } }. Each code has its own page.

markdown version·openapi.json