Back to Documentation
Jobs & Batch Processing
Asynchronous batch verification and job polling guidance.
When to use jobs
- High-throughput or batched verification where per-item latency is not critical.
- Long-running checks that may require external fetching or multi-step processing.
- Workflows that benefit from retry/backoff patterns and centralized job monitoring.
Submit a batch
POST /v1/verify-claims-batch accepts multiple claims in a single request. The endpoint typically responds with a job_id you can poll for completion.
Behavior and fields may vary by implementation; treat the job_id as an opaque identifier and persist it for later polling.
Polling jobs
Use GET /v2/jobs/{job_id} to retrieve job status and results.
Expected fields: status, progress (optional), result, and errors (optional).
Common statuses: queued, processing, completed, failed.
Example job response
{"job_id":"88ac79...","status":"queued"}Tips
- Use idempotency keys where supported to avoid duplicate processing on retries.
- Retry transient failures with exponential backoff and a capped retry count.
- Cache or persist completed job results to avoid unnecessary polling.
See also: Developer Guide · API Reference